AxoEssential

AxoEssential es un plugin modular estilo Essentials para Paper/Folia con homes, warps, kits, economia, menus GUI configurables, idiomas, placeholders y teleports interactivos.

Plataforma

Paper 1.21.11+ / 26.1.2+

Compatibilidad

Paper y Folia

Java Requerido

Java 25+

Autor

AxoStudio

Requisitos

Java 25.
Paper o Folia compatible 26.1.2.
Vault opcional si quieres que otros plugins usen la economia de AxoEssential.
PlaceholderAPI opcional para placeholders externos y la expansion %axoessential_*%.
LuckPerms opcional para grupos y permisos.

Instalacion

Descarga el archivo desde la pagina de releases: https://modrinth.com/plugin/axoessential/.
Instala Vault si quieres exponer la economia a otros plugins.
Reinicia el servidor.
Edita los archivos generados en plugins/AxoEssential/.

Estructura generada

plugins/AxoEssential/
  config.yml
  axoessential.db
  lang/
    en_US.yml
    es_ES.yml
  menus/
    main-menu.yml
    homes-menu.yml
    home-create-menu.yml
    home-delete-menu.yml
    warps-menu.yml
    warp-admin-menu.yml
    warp-delete-menu.yml
    kits-menu.yml
    language-menu.yml
    admin-menu.yml
    admin-homes-menu.yml
    admin-home-delete-menu.yml
    pay-confirm-menu.yml
  modules/
    gui.yml
    kit.yml

Modulos

Los modulos se recargan con /axoessential reload junto con configuracion, idiomas, menus y placeholders.

Modulo	Descripcion
`storage`	Guarda usuarios, homes, warps y economia.
`language`	Idiomas, mensajes y deteccion de idioma del cliente.
`placeholders`	Placeholders internos, cache y expansion PlaceholderAPI.
`gui`	Menus YAML configurables.
`teleport`	`/tpa`, `/tpahere`, `/tpaccept`, `/tpdeny`, `/back`.
`spawn`	`/spawn` y `/setspawn`.
`homes`	Homes de jugadores y administracion.
`warps`	Warps publicos/privados y GUI.
`economy`	Balance, pagos, `/eco` y provider Vault.
`chat`	Mensajes privados, reply, ignore y broadcast.
`moderation`	Kick, warn, mute, ban.
`kits`	Kits configurables.
`afk`	Estado AFK.
`utility`	Fly, heal, feed, gamemode y utilidades.
`server-tools`	`/axoessential`, reglas, mantenimiento, join/quit/title.

Comandos

Comando	Alias	Permiso	Uso
`/axoessential`	`/axo`, `/ae`	ninguno	`/axoessential [help\|menu\|reload\|menus\|modules\|hooks]`
`/axoessential reload`	`/axo reload`	`axoessential.reload`	Recarga configuracion, modulos, idiomas, menus y placeholders.
`/axoessential menus`	`/axo menus`	`axoessential.reload`	Recarga menus YAML.
`/axoessential menus list`	`/axo menus list`	`axoessential.reload`	Lista menus cargados.
`/axogui`	`/aemenu`	ninguno	`/axogui [menu]`
`/language`	`/lang`	ninguno	`/language [code]`
`/spawn`	ninguno	`axoessential.spawn`	`/spawn`
`/setspawn`	ninguno	`axoessential.admin`	`/setspawn`
`/sethome`	ninguno	`axoessential.sethome`	`/sethome <name>`
`/home`	ninguno	`axoessential.home`	`/home <name>`
`/home admin`	ninguno	`axoessential.home.admin`	`/home admin <player> [home]`
`/homes`	ninguno	`axoessential.home`	`/homes`
`/delhome`	`/deletehome`	`axoessential.home`	`/delhome <name>`
`/delhome admin`	`/deletehome admin`	`axoessential.home.admin`	`/delhome admin <player> <home>`
`/warp`	ninguno	`axoessential.warp`	`/warp <name>`
`/warps`	ninguno	`axoessential.warp`	`/warps`
`/setwarp`	ninguno	`axoessential.warp.admin`	`/setwarp <name>`
`/delwarp`	ninguno	`axoessential.warp.admin`	`/delwarp <name>`
`/balance`	`/bal`, `/money`	`axoessential.economy.balance`	`/balance [player]`
`/balance <player>`	`/bal <player>`	`axoessential.economy.admin`	Ver balance de otro jugador.
`/pay`	ninguno	`axoessential.economy.pay`	`/pay <player> <amount>`
`/eco`	`/economy`	`axoessential.economy.admin`	`/eco <give\|take\|set> <player> <amount>`
`/tpa`	ninguno	`axoessential.tpa`	`/tpa <player>`
`/tpahere`	ninguno	`axoessential.tpa`	`/tpahere <player>`
`/tpaccept`	`/tpyes`	`axoessential.tpa`	`/tpaccept`
`/tpdeny`	`/tpno`	`axoessential.tpa`	`/tpdeny`
`/back`	ninguno	`axoessential.back`	`/back`
`/kits`	ninguno	`axoessential.kit.*`	`/kits`
`/kit`	ninguno	`axoessential.kit.*`	`/kit <name>`
`/afk`	ninguno	`axoessential.afk`	`/afk`
`/msg`	`/tell`, `/w`	ninguno	`/msg <player> <message>`
`/reply`	`/r`	ninguno	`/reply <message>`
`/ignore`	ninguno	ninguno	`/ignore <player>`
`/broadcast`	`/bc`	`axoessential.chat.broadcast`	`/broadcast <message>`
`/kick`	ninguno	`axoessential.moderation.kick`	`/kick <player> [reason]`
`/warn`	ninguno	`axoessential.moderation.warn`	`/warn <player> [reason]`
`/mute`	`/tempmute`	`axoessential.moderation.mute`	`/mute <player>`
`/unmute`	ninguno	`axoessential.moderation.mute`	`/unmute <player>`
`/ban`	`/tempban`	`axoessential.moderation.ban`	`/ban <player> [reason]`
`/unban`	`/pardon`	`axoessential.moderation.ban`	`/unban <player>`
`/fly`	ninguno	`axoessential.fly`	`/fly`
`/heal`	ninguno	`axoessential.heal`	`/heal`
`/feed`	ninguno	`axoessential.feed`	`/feed`
`/speed`	ninguno	`axoessential.admin`	`/speed <1-10>`
`/gamemode`	`/gm`	`axoessential.admin`	`/gamemode <mode>`
`/clear`	`/ci`	`axoessential.admin`	`/clear`
`/workbench`	`/wb`, `/craft`	`axoessential.admin`	`/workbench`
`/enderchest`	`/ec`	`axoessential.admin`	`/enderchest`
`/trash`	ninguno	`axoessential.admin`	`/trash`
`/repair`	ninguno	`axoessential.admin`	`/repair`
`/hat`	ninguno	`axoessential.admin`	`/hat`
`/near`	ninguno	`axoessential.admin`	`/near`
`/ptime`	ninguno	`axoessential.admin`	`/ptime <time\|reset>`
`/pweather`	ninguno	`axoessential.admin`	`/pweather <clear\|downfall\|reset>`
`/invsee`	ninguno	`axoessential.admin`	`/invsee <player>`
`/rules`	ninguno	ninguno	`/rules`
`/maintenance`	ninguno	`axoessential.admin`	`/maintenance`

Permisos principales

Permiso	Descripcion
`axoessential.admin`	Acceso completo de administrador.
`axoessential.player`	Permisos base para jugadores.
`axoessential.reload`	Recargar plugin y menus.
`axoessential.module.*`	Ver/administrar modulos.
`axoessential.home.admin`	Administrar homes de otros jugadores.
`axoessential.warp.admin`	Crear y eliminar warps.
`axoessential.economy.admin`	Usar `/eco` y ver balances de otros.
`axoessential.economy.balance`	Usar `/balance`.
`axoessential.economy.pay`	Usar `/pay`.
`axoessential.tpa`	Usar solicitudes de teleport.
`axoessential.back`	Usar `/back`.
`axoessential.kit.*`	Usar kits.
`axoessential.chat.broadcast`	Usar `/broadcast`.
`axoessential.moderation.*`	Permisos de moderacion.
`axoessential.bypass.cooldown`	Ignorar cooldowns.
`axoessential.bypass.warmup`	Ignorar warmups.
`axoessential.bypass.cost`	Ignorar costos.
`axoessential.bypass.teleport-cancel`	Evitar cancelaciones de teleport.

Menus GUI configurables

Todos los menus se cargan dinamicamente desde plugins/AxoEssential/menus/. Puedes editar menus existentes o crear nuevos archivos .yml y recargarlos con /axoessential menus.

Soporta title, size, fillers, permisos y sonidos de apertura/cierre.
Incluye placeholders internos y externos, MiniMessage, colores legacy, HEX y gradients.
Permite intervalos de actualizacion opcionales e items normales o dinamicos.
Lista menus cargados con /axoessential menus list.

Items y acciones

Tipo	Opciones
Item	`material`, `custom-model-data`, `slot`, `amount`, `display-name`, `lore`, `glow`, skull texture/base64, player head, commands, sound, permissions, placeholders y actions.
Acciones	`[player]`, `[console]`, `[message]`, `[close]`, `[menu]`, `[sound]`, `[broadcast]`, `[connect]`, `[actionbar]`, `[title]`.

Ejemplo de menu

title: "<gradient:#00ffff:#0066ff>AxoEssential</gradient>"
size: 54

fillers:
  enabled: true
  material: BLACK_STAINED_GLASS_PANE
  slots: [0, 1, 2]

items:
  homes:
    material: RED_BED
    slot: 20
    display-name: "<green>Homes"
    lore:
      - "<gray>Manage your homes"
    commands:
      - "[player] homes"

  warps:
    material: COMPASS
    slot: 24
    display-name: "<aqua>Warps"
    lore:
      - "<gray>Open warp menu"
    commands:
      - "[menu] warps-menu"

Economia y Vault

Por defecto AxoEssential usa su economia interna y la registra como proveedor Vault.

modules:
  economy:
    enabled: true
    provider: internal
    internal:
      enabled: true
      starting-balance: 0.0
      currency-symbol: '$'
    vault:
      enabled: true
      register-provider: true
      provider-priority: High
      use-provider-format: false

AxoEssential guarda el saldo.
Vault detecta AxoEssential como proveedor de economia.
/balance muestra el mismo saldo que consulta Vault.
Los cambios persisten en storage.

Usar otro proveedor Vault

Si quieres consumir otro plugin de economia via Vault, cambia el provider:

modules:
  economy:
    provider: vault

Formato compacto

modules:
  economy:
    format:
      currency-symbol: '$'
      decimals: 2
      compact:
        enabled: true
        threshold: 1000
        decimals: 2

Ejemplos: $950, $1k, $1.5k, $2m, $1B.

Uso general

La expansion de PlaceholderAPI usa el identificador axoessential. Todos los placeholders internos se usan como %axoessential_<placeholder>%.

%axoessential_balance%
%vault_eco_balance_formatted%
%player_name%
%luckperms_prefix%

Jugador

Placeholder	Descripcion
`%axoessential_player%`	Nombre del jugador.
`%axoessential_player_uuid%`	UUID del jugador.
`%axoessential_displayname%`	Display name del jugador.
`%axoessential_world%`	Mundo actual.
`%axoessential_ping%`	Ping del jugador.
`%axoessential_afk%`	`true` o `false` si esta AFK.
`%axoessential_language%`	Idioma actual del jugador.

Economia

Placeholder	Descripcion
`%axoessential_balance%`	Balance formateado del jugador.
`%axoessential_balance_formatted%`	Balance formateado del jugador.
`%axoessential_balance_raw%`	Balance sin formato.
`%axoessential_vault_eco_balance_formatted%`	Balance formateado compatible con Vault.
`%axoessential_vault_eco_balance_fixed%`	Balance con 2 decimales.
`%axoessential_vault_eco_balance%`	Balance raw compatible con Vault.
`%vault_eco_balance_formatted%`	Placeholder externo de Vault/PlaceholderAPI; AxoEssential tambien tiene fallback interno.
`%vault_eco_balance_fixed%`	Balance Vault con 2 decimales en textos de AxoEssential.
`%vault_eco_balance%`	Balance Vault raw en textos de AxoEssential.

Baltop / top balance

Los placeholders top_balance usan posiciones desde 1. Los placeholders baltop usan posiciones desde 0, estilo Essentials.

Placeholder	Descripcion
`%axoessential_top_balance_1%`	Balance formateado del top 1.
`%axoessential_top_balance_raw_1%`	Balance raw del top 1.
`%axoessential_top_balance_player_1%`	Nombre del jugador top 1.
`%axoessential_balance_top_1%`	Alias de top balance formateado.
`%axoessential_balance_top_raw_1%`	Alias raw.
`%axoessential_balance_top_player_1%`	Alias de nombre del jugador.
`%axoessential_baltop_player_0%`	Jugador top 1 usando indice 0.
`%axoessential_baltop_balance_0%`	Balance raw del top 1 usando indice 0.
`%axoessential_baltop_balance_formatted_0%`	Balance formateado del top 1 usando indice 0.

%axoessential_baltop_player_0% &8| &#00ff00%axoessential_baltop_balance_formatted_0%

Homes, warps, kits y servidor

Placeholder	Descripcion
`%axoessential_homes_count%`	Cantidad de homes del jugador.
`%axoessential_homes_limit%`	Limite de homes del jugador.
`%axoessential_home_<name>%`	`true` si el jugador tiene ese home.
`%axoessential_warps_count%`	Cantidad de warps cargados.
`%axoessential_warp_<name>%`	`true` si existe ese warp.
`%axoessential_kit_available_<name>%`	Placeholder base de kit disponible.
`%axoessential_online%`	Jugadores online.
`%axoessential_max_players%`	Maximo de jugadores.
`%axoessential_tps%`	TPS actual.
`%axoessential_uptime%`	Tiempo activo del plugin.
`%axoessential_tpa_pending%`	`true` si el jugador tiene solicitud TPA pendiente.

Moderacion

Placeholder	Descripcion
`%axoessential_warns%`	Advertencias del jugador.
`%axoessential_mutes%`	Mutes del jugador.
`%axoessential_bans%`	Bans del jugador.

Formato de texto

Placeholders internos y PlaceholderAPI.
Colores legacy con &.
HEX #00ff00 y &#00ff00.
MiniMessage, Adventure API y gradients.

<gradient:#00ffff:#0066ff>AxoEssential</gradient> &8| &#00ff00%axoessential_balance%

Idiomas

Incluye es_ES y en_US. Si un archivo viejo no tiene una clave nueva, AxoEssential usa el idioma incluido en el jar como fallback.

language:
  default: es_ES
  auto-detect-client: true
  fallback: en_US

Los archivos estan en plugins/AxoEssential/lang/.

Storage

SQLite es el backend por defecto. Tambien existen secciones para MySQL y PostgreSQL.

storage:
  type: sqlite
  sqlite:
    file: axoessential.db

storage:
  type: mysql

storage:
  type: postgres

Archivos principales

plugins/AxoEssential/config.yml: Configuracion principal.
plugins/AxoEssential/lang/: Idiomas del plugin.
plugins/AxoEssential/menus/: Menus YAML editables.
plugins/AxoEssential/modules/: Configuracion modular.
plugins/AxoEssential/axoessential.db: Base SQLite por defecto.

Notas importantes

Los archivos existentes en plugins/AxoEssential/ no se sobrescriben.
Si actualizas el plugin y agregas claves nuevas, puedes copiarlas manualmente desde src/main/resources/.
Los menus son totalmente editables sin recompilar.
/axoessential reload recarga modulos, idiomas, menus y placeholders.
Para cambios de dependencias externas como Vault o PlaceholderAPI se recomienda reiniciar el servidor.