AxoStudio

AxoTools

AxoTools es un plugin moderno de evolución de herramientas para servidores Paper y Folia. Permite que picos, hachas, palas, azadas y espadas suban progreso, desbloqueen hitos, reciban encantamientos por tipo de herramienta y activen habilidades especiales desde un sistema totalmente configurable.

Plataforma

Paper 1.21+ / 26.2+

Compatibilidad

Paper y Folia

Java Requerido

Java 25+

Autor

AxoStudio

Funcionamiento

Cuando un jugador rompe un bloque válido con una herramienta registrada, AxoTools aumenta su progreso, actualiza el nombre/lore del ítem, aplica hitos alcanzados y procesa habilidades desbloqueadas.

Herramientas soportadas

Picos: madera, piedra, hierro, oro, diamante y netherita.
Hachas: madera, piedra, hierro, oro, diamante y netherita.
Palas: madera, piedra, hierro, oro, diamante y netherita.
Azadas: madera, piedra, hierro, oro, diamante y netherita.
Espadas: madera, piedra, hierro, oro, diamante y netherita.

Requisitos

Servidor Paper compatible con API 1.21+.
Compatible con Folia mediante scheduler propio.
Java 25 o superior.
Jobs Reborn es opcional; AxoTools funciona sin él.

Resumen rápido

Evolución por bloques minados.
Hitos configurables con encantamientos por herramienta.
Habilidades especiales desbloqueables.
Menús GUI configurables desde menus/.
Idiomas en lang/ con detección automática del cliente.
Soporte para legacy, HEX y MiniMessage.

Evolución de herramientas

Solo cuentan materiales definidos en tracked-tools.
El conteo puede exigir herramienta preferida con counting.require-preferred-tool.
La categoría estricta valida pico, hacha, pala, azada o espada.
Los bloques colocados por jugadores se ignoran para evitar farmeo artificial.
Las herramientas viejas pueden sincronizarse con /at sync.

Hitos y recompensas

Los hitos se configuran en evolution.yml. Pueden dar encantamientos, desbloquear habilidades o ambas cosas.

blocks: progreso requerido.
enchantment y level: recompensa universal.
tool-enchantments: recompensa distinta por categoría o material.
unlock-abilities: lista de habilidades desbloqueadas.

milestone-1:
  blocks: 100
  tool-enchantments:
    default: EFFICIENCY:3
    hoe: FORTUNE:2
    sword: SHARPNESS:2

Habilidades especiales

Habilidad	Función
`self-repair`	Repara durabilidad al caminar con la herramienta.
`auto-smelt`	Funde automáticamente drops compatibles.
`telepathy`	Envía drops al inventario del jugador.
`drill`	Rompe áreas alrededor del bloque original.
`vein-miner`	Rompe bloques conectados del mismo material.
`xp-boost`	Multiplica la experiencia del bloque.
`haste`	Otorga Prisa mientras se sostiene la herramienta.
`luck-surge`	Aumenta drops compatibles durante una ventana corta.
`saturation-pulse`	Restaura hambre y puede aplicar Saturación.

Menús e idioma

Menú principal de evolución con /at.
Árbol de hitos, detalle de hito, estadísticas y panel de habilidades.
Menú de idioma con elección manual por jugador.
Archivos en inglés, español y ruso.
Los textos de menú usan claves lang:menu... desde archivos de idioma.
Los slots de menús aceptan rangos como 0-8,45-53, border, inner o all.

Color y formato

Legacy: &a, &l, &r.
HEX legacy: &#52e5ff.
MiniMessage: <green>, <#52e5ff>, <gradient:#52e5ff:#8f7cff>.
Soporta mezcla entre MiniMessage y legacy en mensajes y menús.

Almacenamiento interno

custom_tools.db registra herramientas personalizadas de AxoTools.
player-placed-blocks.yml evita progreso con bloques colocados por jugadores.
player-languages.yml guarda idioma manual por jugador.
El progreso de cada herramienta vive en el propio item.

Plugins opcionales

Plugin	Uso en AxoTools	Configuración
Jobs Reborn	Permite bloquear o multiplicar progreso según el job activo y la herramienta correcta.	`modules.jobs`
Discord Webhooks	Notifica hitos, habilidades y mensajes de prueba mediante webhook.	`discord`
bStats	Métricas opcionales del plugin.	`general.bstats`

Jobs Reborn

Cuando require-matching-tool está activo, la herramienta no gana progreso si el jugador no tiene un job compatible con la categoría usada.

modules:
  jobs:
    enabled: true
    require-plugin: true
    require-matching-tool: true
    allowed-jobs:
      - Miner
      - Woodcutter
      - Digger
    job-tools:
      Miner:
        - PICKAXE
      Woodcutter:
        - AXE
      Digger:
        - SHOVEL
      Farmer:
        - HOE
      Hunter:
        - SWORD
    progress-multiplier:
      base: 1.0
      per-level: 0.01
      max: 2.0
    rounding: chance

Usa /at jobs sosteniendo una herramienta para ver si AxoTools detecta Jobs, el job del jugador, la categoría requerida y el multiplicador real.

Discord Webhooks

Los webhooks pueden usar texto simple o embeds configurables.

discord:
  enabled: true
  webhook-url: "https://discord.com/api/webhooks/..."
  server-name: "AxoTools"
  events:
    milestone-unlocked: true
    ability-unlocked: true
  embeds:
    enabled: true

Comandos

Comando	Permiso	Descripción
`/at`	`axotools.menu`	Abre el menú principal de evolución para la herramienta en mano.
`/at menu`	`axotools.menu`	Alias de menú. También funciona `/at hub` y `/at gui`.
`/at toolinfo [gui\|text\|legacy]`	`axotools.toolinfo`	Muestra información de progreso de la herramienta.
`/at reload`	`axotools.admin.reload`	Recarga config, menús, idioma, evolución, Discord y estado runtime.
`/at preview`	`axotools.admin.preview`	Abre la vista previa administrativa de localización, barras y lore.
`/at discordtest`	`axotools.admin.discordtest`	Envía una prueba de webhook. Alias: `/at dctest`.
`/at testtool <material> [ability\|all] [level]`	`axotools.admin.testtool`	Crea una herramienta de prueba registrada.
`/at cleartesttool [id]`	`axotools.admin.cleartesttool`	Elimina el modo test de una herramienta o borra un id de test.
`/at admintoolsremove confirm`	`axotools.admin.admintoolsremove`	Elimina herramientas registradas de jugadores conectados y limpia la base de datos.
`/at lang`	`axotools.admin.lang`	Abre el selector de idioma.
`/at sync`	`axotools.admin.sync`	Sincroniza la herramienta en mano con hitos y habilidades actuales.
`/at jobs`	`axotools.admin.jobs`	Diagnostica la integración Jobs para el jugador y herramienta en mano.

Permisos

Permiso	Default	Qué hace
`axotools.admin`	OP	Acceso completo a comandos administrativos.
`axotools.menu`	Todos	Permite abrir el menú principal de evolución.
`axotools.toolinfo`	Todos	Permite revisar progreso de la herramienta.
`axotools.admin.reload`	OP	Permite recargar archivos del plugin.
`axotools.admin.preview`	OP	Permite abrir la vista previa administrativa.
`axotools.admin.discordtest`	OP	Permite probar webhooks de Discord.
`axotools.admin.testtool`	OP	Permite crear herramientas de prueba.
`axotools.admin.cleartesttool`	OP	Permite eliminar herramientas de prueba.
`axotools.admin.admintoolsremove`	OP	Permite purgar herramientas registradas.
`axotools.admin.lang`	OP	Permite abrir el selector de idioma.
`axotools.admin.sync`	OP	Permite sincronizar herramientas con la configuración actual.
`axotools.admin.jobs`	OP	Permite ver el diagnóstico de Jobs.

Archivos principales

plugins/AxoTools/
├─ config.yml
├─ evolution.yml
├─ custom_tools.db
├─ player-placed-blocks.yml
├─ player-languages.yml
├─ lang/
│  ├─ en_US.yml
│  ├─ es_ES.yml
│  └─ ru_RU.yml
└─ menus/
   ├─ main-menu.yml
   ├─ milestone-tree.yml
   ├─ milestone-detail.yml
   ├─ tool-stats.yml
   ├─ abilities.yml
   ├─ language-menu.yml
   ├─ admin-preview.yml
   └─ sounds.yml

config.yml - General

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

general:
  prefix: '<gradient:#52e5ff:#8f7cff><bold>AxoTools</bold></gradient> <dark_gray>»</dark_gray> '
  toolinfo-gui-default: false
  update-check: false
  bstats: true

evolution.yml - Herramientas

tracked-tools:
  - WOODEN_PICKAXE
  - STONE_PICKAXE
  - IRON_PICKAXE
  - GOLDEN_PICKAXE
  - DIAMOND_PICKAXE
  - NETHERITE_PICKAXE
  - WOODEN_AXE
  - DIAMOND_AXE
  - NETHERITE_AXE
  - WOODEN_SHOVEL
  - DIAMOND_SHOVEL
  - NETHERITE_SHOVEL
  - WOODEN_HOE
  - DIAMOND_HOE
  - NETHERITE_HOE
  - WOODEN_SWORD
  - DIAMOND_SWORD
  - NETHERITE_SWORD

Reglas de conteo

counting:
  require-preferred-tool: true
  strict-tool-category-match: true
  whitelist-materials: []
  blacklist-materials: []

Si blacklist-materials existe pero está vacío, AxoTools usa una lista anti-farm interna para hojas, flores, cultivos, pasto y materiales similares.

Habilidad especial

special-abilities:
  self-repair:
    type: SELF_REPAIR
    enabled: true
    trigger: WALK_DISTANCE
    chance: 1.0
    amount: 10
    distance-blocks: 10
    cooldown-seconds: 10
    require-main-hand: true
    compatible-with-mending: true

Menús configurables

Los menús viven en menus/*.yml. El texto visible debe apuntar a claves de idioma para que la traducción funcione por cliente.

title: "lang:menu.milestone-tree.title"
items:
  filler:
    material: BLACK_STAINED_GLASS_PANE
    slots: "0-8,45-53"
  abilities:
    material: BLAZE_POWDER
    slot: 48
    title: "lang:menu.milestone-tree.items.abilities.title"