AxoStudio

AxoMines

AxoMines es un plugin para crear y administrar minas automáticas desde menús simples. Permite configurar regiones, bloques, porcentajes, recompensas, tiempos de reinicio y spawns seguros sin depender de comandos complejos.

Plataforma

Paper 1.21.11+ / 26.1.2+

Compatibilidad

Paper y Folia

Java Requerido

Java 25+

Autor

AxoStudio

Requisitos

Java 25 o superior.
Paper compatible con API 26.1.2 y Minecraft 1.21.11+.
Compatible con Paper y Folia mediante scheduler propio.
PlaceholderAPI, Vault y LuckPerms son opcionales; AxoMines arranca sin ellos.

Características

Creación y edición de minas desde menús GUI.
Selección de regiones con herramientas y dos puntos de esquina.
Reinicio automático por tiempo o porcentaje minado.
Configuración de bloques con porcentajes y recompensas por bloque.
Spawn seguro para evacuar jugadores durante el reinicio.
Soporte de idiomas con archivos en lang/.
Almacenamiento en YAML para configuración y minas.

Flujo básico

Usa /axomines create <nombre> para iniciar la selección.
Marca las dos esquinas con el hacha de selección.
Configura bloques, tiempos, recompensas y spawn desde el editor.
Guarda y activa la mina para que los reinicios automáticos empiecen a correr.

Plugins opcionales

Plugin	Uso en AxoMines	Configuración
PlaceholderAPI	Registra la expansión `axomines` y permite usar placeholders externos dentro de textos.	`placeholders.placeholderapi-enabled`
Vault	Entrega recompensas de dinero con rewards de tipo `MONEY`.	`hooks.vault-enabled`
LuckPerms	Se detecta para contextos y permisos futuros; los permisos funcionan normalmente con Bukkit/Paper.	`hooks.luckperms-enabled`

Placeholders internos

Si PlaceholderAPI está instalado, también funcionan como expansión externa con prefijo axomines.

%axomines_mine_name%
%axomines_mine_world%
%axomines_mine_reset_time%
%axomines_mine_blocks_left%
%axomines_mine_blocks_mined%
%axomines_mine_percent_mined%
%axomines_mine_owner%
%axomines_player_current_mine%
%axomines_player_blocks_mined%
%axomines_time_mina_a%

Rewards con integraciones

Los comandos aceptan prefijos [player], player:, [console] o console:. Los textos pasan por placeholders internos y PlaceholderAPI si está activo.

rewards:
  0:
    id: dinero-carbon
    type: MONEY
    chance: 15.0
    block-filter: COAL_ORE
    amount: 25.0
  1:
    id: comando-global
    type: COMMAND
    chance: 5.0
    commands:
      - "[console] give %player_name% diamond 1"
      - "[player] spawn"

Comandos

Comando	Permiso	Descripción
`/axomines`	`axomines.user`	Abre el menú principal si lo ejecuta un jugador.
`/axomines help`	`axomines.user`	Muestra la ayuda de comandos.
`/axomines create <nombre>`	`axomines.create`	Inicia la creación de una mina con selección de región.
`/axomines delete <nombre>`	`axomines.delete`	Elimina una mina existente.
`/axomines edit <nombre>`	`axomines.edit`	Abre el editor de una mina.
`/axomines reset <nombre>`	`axomines.reset`	Fuerza el reinicio manual de una mina.
`/axomines tp <nombre>`	`axomines.tp`	Teletransporta al jugador a la mina o a su spawn seguro.
`/axomines spawn <nombre>`	`axomines.spawn`	Teletransporta al jugador al spawn seguro de la mina.
`/axomines setspawn <nombre>`	`axomines.setspawn`	Guarda el spawn seguro de una mina.
`/axomines wand`	`axomines.wand`	Entrega la herramienta de selección.
`/axomines list`	`axomines.user`	Abre la lista de minas o la muestra en consola.
`/axomines reload`	`axomines.reload`	Recarga configuración, idiomas, menús y minas.
`/axomines language <codigo>`	`axomines.language`	Cambia el idioma global o activa detección automática.
`/axomines lang <codigo>`	`axomines.language`	Alias de `/axomines language`.
`/axomines cancel`	`axomines.user`	Cancela la selección activa del jugador.

Permisos

Permiso	Default	Qué hace
`axomines.admin`	OP	Da acceso a todas las funciones administrativas del plugin.
`axomines.user`	Todos	Permite usar funciones básicas como menú, ayuda, lista y cancelar selección.
`axomines.create`	OP	Permite crear minas nuevas.
`axomines.delete`	OP	Permite eliminar minas.
`axomines.edit`	OP	Permite abrir y modificar minas desde la GUI.
`axomines.reset`	OP	Permite reiniciar minas manualmente.
`axomines.tp`	OP	Permite teletransportarse a una mina.
`axomines.spawn`	Todos	Permite ir al spawn seguro de una mina.
`axomines.setspawn`	OP	Permite establecer el spawn seguro de una mina.
`axomines.wand`	OP	Permite recibir la herramienta de selección.
`axomines.reload`	OP	Permite recargar archivos del plugin sin reiniciar el servidor.
`axomines.language`	OP	Permite cambiar el idioma global del plugin.
`axomines.bypass`	OP	Permite saltar restricciones internas configuradas para minas.

Archivos y carpetas

Estructura generada desde los recursos de build/resources/main.

plugins/AxoMines/
├─ config.yml
├─ data/
│  └─ axomines.db
├─ mines/
│  └─ mina_a.yml
├─ rewards/
├─ lang/
│  ├─ es_ES.yml
│  ├─ en_US.yml
│  └─ ru_RU.yml
└─ menus/
   ├─ main.yml
   ├─ mines.yml
   ├─ editor.yml
   ├─ block-editor.yml
   ├─ rewards.yml
   ├─ confirmations.yml
   └─ settings.yml

config.yml - Ejemplo principal

storage:
  type: YAML
  auto-save-seconds: 120
  sqlite:
    file: data/axomines.db
  mysql:
    host: localhost
    port: 3306
    database: axomines
    username: root
    password: ""
    pool-size: 8

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

selection:
  wand:
    material: NETHERITE_AXE
    custom-model-data: 10001
    glow: true
    hide-attributes: true
    name: "<#00ffaa><bold>AxoMines Selection Tool</bold>"
  naming:
    min-length: 3
    max-length: 32
    regex: "^[a-zA-Z0-9_-]+$"
  actionbar-enabled: true
  border-visualization-enabled: true
  expire-minutes: 15

Reinicio, recompensas y hooks

reset:
  tick-interval-seconds: 1
  batch-size: 4096
  skip-unloaded-chunks: true
  countdown-seconds: [60, 30, 10, 5, 4, 3, 2, 1]
  percentage-trigger-enabled: true
  default-percentage-trigger: 85.0
  broadcast-enabled: true
  bossbar-enabled: false
  actionbar-enabled: true
  sound-enabled: true
  particles-enabled: false

placeholders:
  placeholderapi-enabled: true
  external-cache-millis: 1000
  heavy-cache-millis: 5000

rewards:
  enabled: true
  command-dispatcher: PLAYER
  message-enabled: false
  actionbar-enabled: false
  title-enabled: false
  sound-enabled: true
  particles-enabled: true

hooks:
  vault-enabled: true
  luckperms-enabled: true

Mina YAML - Ejemplo básico

Las minas se guardan en plugins/AxoMines/mines/<nombre>.yml. También puedes crearlas desde la GUI para evitar errores de coordenadas.

name: mina_a
owner: 00000000-0000-0000-0000-000000000000
world: world
priority: 0
type: CUBOID
active: true

reset:
  interval-seconds: 600
  next-epoch-millis: 1778348437989
  percentage-threshold: 85.0

region:
  type: CUBOID
  world: world
  min:
    x: 100
    y: 20
    z: 100
  max:
    x: 130
    y: 60
    z: 130

spawn:
  world: world
  x: 115.5
  y: 64.0
  z: 115.5
  yaw: 0.0
  pitch: 0.0

blocks:
  - STONE:55.0
  - COAL_ORE:25.0
  - IRON_ORE:15.0
  - DIAMOND_ORE:5.0

Mina YAML - Visuales, permisos y rewards

visuals:
  sounds-enabled: true
  particles-enabled: true
  bossbar-enabled: false
  actionbar-enabled: true
  reset-sound: ENTITY_PLAYER_LEVELUP
  particle: END_ROD

permissions:
  mine: axomines.mine.mina_a
  bypass: axomines.bypass

messages:
  reset-start: "<aqua>La mina <white>%axomines_mine_name%</white> se esta reiniciando."

rewards:
  0:
    id: dinero-carbon
    type: MONEY
    chance: 15.0
    block-filter: COAL_ORE
    amount: 25.0
  1:
    id: experiencia-hierro
    type: EXPERIENCE
    chance: 20.0
    block-filter: IRON_ORE
    experience: 8
  2:
    id: comando-diamante
    type: COMMAND
    chance: 3.0
    block-filter: DIAMOND_ORE
    commands:
      - "[console] give %player_name% emerald 1"

Los rewards de tipo ITEM guardan el item como item-base64 cuando se crean desde el editor.

Menú principal - Ejemplo

title: "<gradient:#00d4ff:#7c4dff>AxoMines</gradient>"
size: 54
fill:
  material: BLACK_STAINED_GLASS_PANE
  name: " "
buttons:
  mines:
    slot: 20
    material: DIAMOND_PICKAXE
    name: "<aqua><bold>Minas</bold>"
    lore:
      - "<gray>Ver, editar y resetear minas."
    action: OPEN_MINES
  stats:
    slot: 22
    material: BOOK
    name: "<yellow><bold>Estadisticas</bold>"
    action: OPEN_STATS
  reload:
    slot: 24
    material: LIME_DYE
    name: "<green><bold>Recargar</bold>"
    permission: axomines.reload
    action: RELOAD

Notas importantes

El plugin crea automáticamente lang/, menus/, mines/, rewards/ y data/.
Los nombres de minas aceptan por defecto letras, números, guiones y guiones bajos.
reset.batch-size controla cuántos bloques procesa cada lote durante un reinicio.
limits.max-region-volume limita el volumen máximo de una mina para evitar regiones demasiado pesadas.
Ejecuta /axomines reload para recargar configuración, idiomas, menús y minas.

Uso rápido

Ejecuta /axomines create <nombre> y selecciona dos esquinas con la herramienta.
Abre el editor con /axomines edit <nombre>.
Configura bloques, porcentaje de reinicio, tiempo y recompensas.
Guarda la mina desde el menú.