Pregenerador Adaptativo Paper & Folia 1.20+

AxoChunks

Pregenerador de mundo de altísimo rendimiento y respuesta adaptativa para Paper, Purpur y Folia. Genera terrenos masivos sin provocar bajones de TPS ni lag en el servidor.

Plataforma

Paper 1.21.1 / 26.X

Compatibilidad

Paper / Folia

Java Requerido

Java 25+

Autor

AxoStudio

Regulación Adaptativa de TPS

Monitorea continuamente los milisegundos por tick (MSPT). Si el servidor detecta carga, AxoChunks ralentiza la generación automáticamente para mantener 20 TPS.

Integración nativa con Folia

Aprovecha los hilos por región independientes en servidores Folia para generar mundos a velocidades hasta 5x superiores que Spigot tradicional.

Control de Guardado y Pausa

Guarda y reanuda tareas de pregeneración sin perder el progreso en caso de reinicios o tareas administrativas.

¿Por qué pregenerar tus mundos?

Cuando un jugador explora terreno no generado, la CPU de tu servidor debe crear bloques, biomas y estructuras en tiempo real. Pregenerar con AxoChunks elimina el lag por exploración completamente.

Instalación y Requisitos

1

Descarga e instala el archivo

Descarga AxoChunks.jar y colócalo en la carpeta plugins/ de tu servidor.

2

Reinicia tu servidor

AxoChunks creará la carpeta plugins/AxoChunks/ con su archivo config.yml.

3

Inicia la pregeneración de tu mundo

Ejecuta /axochunks create world 5000 square para generar un área de 5000 bloques.

Comandos

Lista completa de comandos y subcomandos disponibles con su descripción detallada.

Comando	Descripción
`/axochunks help`	Muestra la ayuda disponible y la sintaxis de comandos. Alias: `/achunks`.
`/axochunks create`	Crea desde un jugador una tarea de pregeneración cuadrada centrada en su posición actual.
`/axochunks create circle`	Crea desde un jugador una tarea de pregeneración circular centrada en su posición.
`/axochunks create`	Crea una tarea completa desde consola o juego indicando mundo, forma geométrica, radio y centro.
`/axochunks start`	Inicia el procesamiento de la tarea de pregeneración registrada.
`/axochunks pause`	Pausa temporalmente una tarea activa en su posición actual sin perder progreso.
`/axochunks stop`	Detiene una tarea o todas las tareas de pregeneración activas.
`/axochunks resume`	Reanuda una tarea pausada exactamente desde su progreso guardado.
`/axochunks cancel`	Cancela definitivamente la tarea indicada y libera sus recursos.
`/axochunks status [tarea]`	Muestra estado, porcentaje, velocidad de chunks/seg, ETA estimado, TPS, MSPT y memoria.
`/axochunks list`	Lista todas las tareas registradas con su mundo, forma, estado y porcentaje completado.
`/axochunks delete`	Elimina una tarea registrada de la base de datos del pregenerador.
`/axochunks reload`	Recarga la configuración del regulador adaptativo y límites de rendimiento.

Permisos

Gestión de Permisos

Configura estos nodos en tu plugin de permisos (como LuckPerms) para otorgar acceso a jugadores o miembros del staff.

Permiso	Descripción
`axochunks.admin`	Acceso completo a todos los comandos y funcionalidades de AxoChunks (por defecto OP).
`axochunks.command.help`	Permite ver la ayuda de comandos.
`axochunks.command.create`	Permite crear nuevas tareas de pregeneración.
`axochunks.command.start`	Permite iniciar tareas registradas.
`axochunks.command.pause`	Permite pausar tareas activas.
`axochunks.command.stop`	Permite detener tareas en ejecución.
`axochunks.command.resume`	Permite reanudar tareas guardadas.
`axochunks.command.cancel`	Permite cancelar tareas de pregeneración.
`axochunks.command.status`	Permite consultar el estado, velocidad y métricas de rendimiento en tiempo real.
`axochunks.command.list`	Permite listar todas las tareas registradas.
`axochunks.command.delete`	Permite eliminar tareas existentes.
`axochunks.command.reload`	Permite recargar la configuración del plugin.

Placeholders (PlaceholderAPI)

Variables integradas para usar en scoreboards, menús GUI, chat, tablist y hologramas mediante PlaceholderAPI.

Placeholder	Descripción
`%axochunks_task_status_%`	Estado actual de la tarea indicada (Generando, Pausada, Completada).
`%axochunks_task_progress_%`	Porcentaje completado de la tarea indicada (ej. `45.8%`).
`%axochunks_task_generated_%`	Cantidad total de chunks generados hasta el momento por la tarea.
`%axochunks_task_total_%`	Cantidad total de chunks que comprende el área de la tarea.
`%axochunks_task_speed_%`	Velocidad actual de procesamiento en chunks por segundo.
`%axochunks_task_eta_%`	Tiempo estimado restante para finalizar la tarea formateado en HH:MM:SS.
`%axochunks_active_tasks%`	Número total de tareas de pregeneración en ejecución simultánea en el servidor.
`%axochunks_current_mspt%`	Milisegundos por tick (MSPT) en tiempo real monitoreados por el pregenerador adaptativo.

Configuración (config.yml)

Ejemplo de archivo config.yml con explicaciones de cada parámetro:

config.yml

# AxoChunks - Configuración Principal
settings:
  # Milisegundos máximos por tick antes de pausar temporalmente (20 TPS = 50ms)
  max-tps-cutoff-mspt: 45.0

  # Cantidad de chunks cargados en memoria por ciclo de procesamiento
  chunks-per-batch: 32

  # Intervalo de autoguardado en segundos para evitar pérdida de progreso
  auto-save-interval-seconds: 15

  # Notificaciones en consola y acción administrativa
  notifications:
    broadcast-to-ops: true
    interval-seconds: 10

b:T85de,

AxoDisplay

Sistema avanzado de displays multilínea y nametags flotantes para Minecraft basado en Text Displays virtuales por paquetes, soporte para MiniMessage, PlaceholderAPI, MiniPlaceholders, etiquetas desbloqueables y compatibilidad total con Bedrock.

Plataforma

Paper / Purpur 1.21+ / 26.X

Compatibilidad

Java & Bedrock (Geyser)

Java Requerido

Java 25+

Autor

AxoStudio

Qué hace

Reemplaza el nametag predeterminado de Minecraft por un TextDisplay multilínea flotante.
Montaje virtual en cliente: el display se mueve a la tasa de refresco del cliente (144Hz/240Hz) sin delay visual.
100% virtual por paquetes: no crea entidades físicas en los mundos ni interfiere con teletransportaciones (/tp, RTP, portales).
Soporte nativo para MiniMessage (gradientes, arcoíris, HEX) y códigos clásicos (&).
Integración dual con PlaceholderAPI (%...%) y MiniPlaceholders (<...>).
Sistema de tags/etiquetas cosméticas desbloqueables por permiso o seleccionables por comando.
Ocultamiento automático inteligente con Vanish (Essentials, SuperVanish, PremiumVanish, CMI), al agacharse o en espectador.

Integraciones

PlaceholderAPIPlaceholders %...%

MiniPlaceholdersTags <...> (v3.2.0 API)

Geyser & FloodgateLíneas y escala para Bedrock

TAB PluginSupresión de nametag nativa

EssentialsX / CMIDetección de vanish y staff

SuperVanish / PremiumVanishOcultamiento de administradores

LuckPerms / VaultGrupos por permisos y dinero

Archivos clave

config.yml grupos.yml tags.yml lang/es_ES.yml lang/en_US.yml

Toda la configuración se recarga en caliente con /axodisplay reload sin necesidad de reiniciar el servidor.

Rendimiento de Ultra Baja Latencia (< 0.5% CPU)

AxoDisplay implementa caché de texto en cadena plana, lazy-parsing de componentes MiniMessage y detección estática de plugins de Vanish con TTL. Solo genera y envía paquetes de red a los clientes cuando los datos del jugador (vida, ping, rango) realmente han cambiado.

Guía de Instalación

1

Descarga el JAR

Descarga la última versión de AxoDisplay.jar y colócalo dentro de la carpeta plugins/ de tu servidor.

2

Verifica la versión de Java

Asegúrate de ejecutar tu servidor con Java 25+ y Paper o Purpur 1.21+ (API 26.1+).

3

Inicia el servidor

Al arrancar el servidor se generarán automáticamente las plantillas iniciales: config.yml, grupos.yml y tags.yml.

4

Personaliza grupos y rangos

Edita grupos.yml para definir el formato de tus rangos (Staff, VIP, Usuario) y asignarles permisos o colores.

Aplica cambios en caliente

Ejecuta /axodisplay reload para recargar al instante sin desconectar a ningún jugador.

Comandos

Todos los comandos del plugin pueden ejecutarse con /axodisplay o sus alias cortos /ad y /axod.

Comando	Descripción	Permiso
`/axodisplay help`	Muestra la lista interactiva de comandos de AxoDisplay.	`axodisplay.player`
`/axodisplay reload`	Recarga toda la configuración, grupos, tags, idiomas y actualiza los displays en línea.	`axodisplay.admin.reload`
`/axodisplay toggle [jugador]`	Activa o desactiva la visibilidad del display (propio o de otro jugador).	`axodisplay.player.toggle`
`/axodisplay hide [jugador]`	Oculta el display permanentemente para todos los jugadores.	`axodisplay.player.hide`
`/axodisplay show [jugador]`	Vuelve a hacer visible un display oculto previamente.	`axodisplay.player.show`
`/axodisplay tag list`	Muestra en el chat la lista de etiquetas que el jugador tiene desbloqueadas.	`axodisplay.player.tag`
`/axodisplay tag select <nombre>`	Equipa una etiqueta cosmética desbloqueada sobre el display.	`axodisplay.player.tag`
`/axodisplay tag clear`	Desequipa la etiqueta actualmente activa del jugador.	`axodisplay.player.tag`
`/axodisplay background <grupo> <color\|transparent>`	Cambia dinámicamente el color de fondo del cuadro de texto para un grupo.	`axodisplay.admin.background`
`/axodisplay debug [jugador]`	Muestra información técnica en tiempo real (ID de entidad, viewers, vanish, tracking).	`axodisplay.admin.debug`

Ejemplos prácticos

# Recargar todas las configuraciones tras editar grupos.yml:

/ad reload

# Equipar una etiqueta cosmética de Asesino:

/ad tag select asesino

# Ocultar el display de un jugador problemático:

/ad hide Steve

Permisos

Configuración con LuckPerms

Los permisos marcados con true están concedidos a todos los jugadores por defecto. Los permisos op deben asignarse a los grupos de staff en tu gestor de permisos.

Permiso	Descripción	Por Defecto
`axodisplay.admin`	Permiso maestro de administración. Otorga acceso a todos los comandos y funciones.	`op`
`axodisplay.admin.reload`	Permite recargar la configuración del plugin con `/ad reload`.	`op`
`axodisplay.admin.debug`	Permite ver el panel de diagnóstico técnico con `/ad debug`.	`op`
`axodisplay.admin.toggle.others`	Permite alternar la visibilidad del display de otros jugadores.	`op`
`axodisplay.admin.hide`	Permite ocultar el display de cualquier jugador.	`op`
`axodisplay.admin.show`	Permite volver a mostrar el display de cualquier jugador.	`op`
`axodisplay.admin.background`	Permite modificar el color de fondo de un grupo con comandos.	`op`
`axodisplay.player`	Permiso general que agrupa todas las funciones normales de jugador.	`true`
`axodisplay.player.use`	Permite al jugador tener su propio display visible sobre la cabeza.	`true`
`axodisplay.player.toggle`	Permite al jugador activar/desactivar su propio display.	`true`
`axodisplay.player.hide`	Permite al jugador ocultar su display personal.	`true`
`axodisplay.player.show`	Permite al jugador mostrar su display personal si estaba oculto.	`true`
`axodisplay.player.tag`	Permite abrir el menú de etiquetas y equipar tags cosméticas.	`true`
`axodisplay.group.<nombre>`	Permiso para recibir un grupo o rango específico definido en `grupos.yml`.	`-`
`axodisplay.tag.<nombre>`	Permiso para desbloquear una etiqueta cosmética definida en `tags.yml`.	`-`

Sistema de Tags y Etiquetas

AxoDisplay incluye un sistema nativo de etiquetas y títulos cosméticos que los jugadores pueden desbloquear y lucir sobre su cabeza.

Desbloqueo por Permisos

Cada tag en tags.yml cuenta con un nodo de permiso único (por ejemplo: axodisplay.tag.leyenda). Puedes otorgarlos como recompensas de misiones, rangos de donador o logros.

lp user Steve permission set axodisplay.tag.leyenda

Selección de Etiquetas

Los jugadores pueden listar y seleccionar sus etiquetas mediante comandos:

/ad tag list — Ver todas las etiquetas que el jugador tiene desbloqueadas.
/ad tag select <nombre> — Equipar una etiqueta específica.
/ad tag clear — Quitar la etiqueta activa.

Estructura de tags.yml

tags:
  leyenda:
    priority: 1
    permission: "axodisplay.tag.leyenda"
    java: "<gradient:#FFD700:#FFA500><bold>[★ LEYENDA ★]</bold></gradient>"
    bedrock: "[★ LEYENDA ★]"

  asesino:
    priority: 2
    permission: "axodisplay.tag.asesino"
    java: "<gradient:#FF0000:#FF5555><bold>[🗡 ASESINO 🗡]</bold></gradient>"
    bedrock: "[ASESINO]"

  constructor:
    priority: 3
    permission: "axodisplay.tag.constructor"
    java: "<gradient:#C864FE:#00D2FF><bold>[🔨 CONSTRUCTOR 🔨]</bold></gradient>"
    bedrock: "[CONSTRUCTOR]"

Placeholders y Formato

AxoDisplay ofrece compatibilidad total con tres motores de texto y variables simultáneamente.

Nativos de AxoDisplay

Variables internas integradas para etiquetas y datos básicos:

%axodisplay_tag% — Etiqueta equipada o de mayor prioridad.

%axodisplay_tags% — Concatena todas las etiquetas desbloqueadas.

%axodisplay_tag_nombre% — Muestra una etiqueta específica si la posee.

%player_name% — Nombre del jugador.

%player_health% — Vida actual redondeada.

%player_ping% — Ping del jugador en ms.

PlaceholderAPI (%...%)

Compatible con miles de expansiones de PAPI:

%vault_eco_balance% — Dinero de Vault.

%luckperms_prefix% — Prefijo de LuckPerms.

%statistic_player_kills% — Asesinatos.

%statistic_deaths% — Muertes del jugador.

MiniPlaceholders (<...>)

Soporte nativo con la API moderna de MiniPlaceholders (v3.2.0):

<player_name> — Nombre del jugador.

<player_ping> — Latencia del jugador.

<server_tps> — TPS en tiempo real.

<luckperms_prefix> — Prefijo de rango.

Etiquetas Condicionales Dinámicas

Puedes mostrar u ocultar fragmentos de texto en base a valores matemáticos o booleanos usando la etiqueta <cond:...>...</cond>:

# Mostrar alerta solo cuando la vida sea menor o igual a 5:
- "<cond:%player_health% <= 5><red><bold>⚠ VIDA CRÍTICA ⚠</bold></red></cond>"

# Mostrar estado de combate solo si el placeholder devuelve true:
- "<cond:%combatlogx_in_combat% == true><dark_red>[EN COMBATE]</dark_red></cond>"

Archivos de Configuración

Guía completa de cada opción dentro de los archivos del plugin.

config.yml

# Prefijo global de los mensajes de AxoDisplay
prefix: "<shadow:#000000:1><gradient:#C864FE:#00D2FF><bold>AxoDisplay</bold> »</gradient></shadow> "

# Archivo de idioma (lang/es_ES.yml, lang/en_US.yml)
lang: "es_ES"

# Frecuencia de actualización de texto en ticks (10 ticks = 0.5 segundos)
update-interval-ticks: 10

# Ocultar el display cuando el jugador se agacha (shift)
hide-when-sneaking: true

# Ocultar el display cuando el jugador entra en Vanish (Essentials, SuperVanish, etc.)
hide-in-vanish: true

# Ocultar en modo espectador
hide-in-spectator: true

# Ocultar en modo creativo
hide-in-creative: false

# Ocultar el nametag vanilla estándar para que solo se vea AxoDisplay
hide-vanilla-nametag: true

# Montaje virtual nativo (240 FPS, sin lag visual ni movimiento por tick)
native-passenger-mount: true

# Mostrar el propio display al jugador en tercera persona (F5)
show-self: true

# Distancia máxima de tracking en bloques para enviar paquetes
tracking-distance: 64

# Optimizaciones de alto rendimiento
optimizations:
  cache-unchanged-text: true
  culling-distance-blocks: 48

# Ajustes visuales para Java Edition
java-settings:
  y-offset: 0.20
  scale: 1.0
  view-range: 0.5
  billboard: "CENTER"
  text-shadow: true
  line-width: 1000
  background-color: "transparent"
  see-through: false

# Ajustes visuales adaptados para Bedrock Edition (Geyser / Floodgate)
bedrock-settings:
  y-offset: 0.25
  scale: 1.0
  view-range: 0.5
  billboard: "CENTER"
  text-shadow: true
  line-width: 1000
  background-color: "transparent"
  see-through: false

grupos.yml

Define los rangos visuales de mayor a menor prioridad. Permite configurar líneas separadas para jugadores de Java y de Bedrock:

groups:
  staff:
    priority: 100
    permission: "axodisplay.group.staff"
    background-color: "transparent"
    lines:
      java:
        - "<gradient:#FF0000:#FF5555><bold>🛡 STAFF 🛡</bold></gradient> %player_name%"
        - "&f%player_health% &a❤ &7/ &f%player_ping% &e⚡"
        - "<gray>En Servicio</gray>"
      bedrock:
        - "<gradient:#FF0000:#FF5555><bold>[STAFF]</bold></gradient> %player_name%"
        - "&f%player_health% &aHP &7/ &f%player_ping% &ems"

  vip:
    priority: 50
    permission: "axodisplay.group.vip"
    background-color: "transparent"
    lines:
      java:
        - "<gradient:#FFD700:#FFA500><bold>★ VIP ★ %player_name%</bold></gradient>"
        - "&f%player_health% &a❤"
        - "%axodisplay_tag%"
      bedrock:
        - "<gradient:#FFD700:#FFA500><bold>[VIP] %player_name%</bold></gradient>"
        - "&f%player_health% &aHP"

  default:
    priority: 0
    permission: ""
    background-color: "transparent"
    lines:
      java:
        - "<gradient:#00D2FF:#3A7BD5><bold>%player_name%</bold></gradient>"
        - "&f%player_health% &a❤ &7| &f%player_ping% &7ms"
        - "%axodisplay_tag%"
      bedrock:
        - "<gradient:#00D2FF:#3A7BD5><bold>%player_name%</bold></gradient>"
        - "&f%player_health% &aHP"

25:I[97367,["/_next/static/chunks/16s2tuze-vcfi.js"],"OutletBoundary"] 26:"$Sreact.suspense" 28:I[97367,["/_next/static/chunks/16s2tuze-vcfi.js"],"ViewportBoundary"] 2a:I[97367,["/_next/static/chunks/16s2tuze-vcfi.js"],"MetadataBoundary"] c:T2f5e,

Eventos PvP Paper & Folia

AxoDTC

Plugin dinámico de eventos "Destroy The Core" (Destruye el Núcleo) para servidores PvP, Factions, HCF y Survival en Paper, Purpur y Folia.

Plataforma

Paper 1.21.1 / 26.X

Compatibilidad

Paper / Folia

Java Requerido

Java 25+

Autor

AxoStudio

Núcleos Configurables

Define bloques especiales (Obsidiana, Netherite, Cristal) como núcleos del evento con recuento de golpes personalizable.

Recompensas Automáticas

Otorga recompensas por consola, objetos y comandos al jugador o clan que destruya el núcleo final.

Estadísticas & Hologramas

Muestra el progreso de durabilidad restante sobre el núcleo en tiempo real utilizando hologramas integrados.

Instalación y Requisitos

1. Coloca AxoDTC.jar en tu carpeta plugins/.

2. (Opcional) Instala PlaceholderAPI y AxoHologram para los indicadores sobre el núcleo.

3. Reinicia tu servidor para generar la configuración.

Eventos y Funcionamiento

¿Cómo se gana un evento DTC?

Los jugadores deben picar o romper el bloque del núcleo determinado número de veces (por ejemplo, 100 golpes). Cada golpe reduce la durabilidad del núcleo y el jugador o facción que dé el golpe final se lleva la victoria y los premios.

Comandos

Lista completa de comandos y subcomandos disponibles con su descripción detallada.

Comando	Descripción
`/axodtc help`	Muestra la lista de comandos y opciones del evento DTC. Alias: `/dtc`.
`/axodtc create`	Crea un nuevo evento DTC asociando un bloque de núcleo (Core) configurado.
`/axodtc start`	Inicia inmediatamente el evento DTC especificado.
`/axodtc stop [evento]`	Detiene el evento DTC activo de forma manual.
`/axodtc delete`	Elimina un evento DTC registrado de la configuración.
`/axodtc setcore`	Establece la ubicación del núcleo (Core) mirando el bloque objetivo.
`/axodtc sethits`	Define el número máximo de golpes requeridos para destruir el núcleo.
`/axodtc list`	Muestra la lista de todos los eventos DTC creados y su estado.
`/axodtc top`	Abre el ranking de los mejores destructores de núcleos en el servidor.
`/axodtc reload`	Recarga la configuración, recompensas y mensajes de AxoDTC.

Permisos

Gestión de Permisos

Configura estos nodos en tu plugin de permisos (como LuckPerms) para otorgar acceso a jugadores o miembros del staff.

Permiso	Descripción
`axodtc.admin`	Acceso completo a todos los comandos de administración de eventos DTC.
`axodtc.command.help`	Permiso para consultar la ayuda de comandos.
`axodtc.command.create`	Permiso para crear nuevos eventos DTC.
`axodtc.command.start`	Permiso para iniciar eventos DTC manualmente.
`axodtc.command.stop`	Permiso para detener eventos DTC.
`axodtc.command.delete`	Permiso para eliminar eventos DTC.
`axodtc.command.setcore`	Permiso para definir la ubicación del bloque núcleo.
`axodtc.command.list`	Permiso para ver la lista de eventos DTC configurados.
`axodtc.player.top`	Permiso para consultar el ranking de ganadores de eventos DTC.
`axodtc.command.reload`	Permiso para recargar la configuración del plugin.

Placeholders (PlaceholderAPI)

Variables integradas para usar en scoreboards, menús GUI, chat, tablist y hologramas mediante PlaceholderAPI.

Placeholder	Descripción
`%axodtc_current_core%`	Nombre del evento DTC o núcleo activo actualmente en el servidor.
`%axodtc_status%`	Estado actual del evento (`Activo` / `Esperando` / `Finalizado`).
`%axodtc_hits%`	Cantidad de golpes que ha recibido el núcleo actual.
`%axodtc_max_hits%`	Cantidad máxima de golpes requeridos para destruir el núcleo.
`%axodtc_hits_left%`	Golpes restantes necesarios para romper el núcleo.
`%axodtc_time%`	Tiempo transcurrido desde el inicio del evento DTC activo.
`%axodtc_countdown%`	Tiempo restante para el próximo evento DTC programado.
`%axodtc_top_1_player%`	Nombre del jugador con más victorias en eventos DTC.
`%axodtc_top_1_hits%`	Número de núcleos destruidos por el jugador número 1 del ranking.

Configuración (config.yml)

config.yml

events:
  core_principal:
    world: "world"
    x: 100
    y: 64
    z: -250
    hits-required: 150
    block-type: "OBSIDIAN"
    rewards:
      - "give %player% diamond 32"
      - "eco give %player% 5000"

d:T55a0,

AxoGens

AxoGens es la solución All-In-One definitiva para servidores Gens Tycoon en Paper. Basado en el concepto de generadores por tiers con alta optimización, incluye tiendas GUI, varitas de venta (sell wands), eventos globales de servidor, sistema de niveles de jugador, hologramas flotantes y almacenamiento SQLite asíncrono sin lag.

Plataforma

Paper 1.21.1 / 26.X

Compatibilidad

Paper / Folia

Java Requerido

Java 25+

Autor

AxoStudio

Requisitos

Java 25 o superior.
Servidor Paper (o derivado compatible) versión 26.2 / 26.X.
PlaceholderAPI opcional para parsear estadísticas en menús, hologramas y lores.
Vault opcional para la integración económica de compras, mejoras y ventas.

Características Principales

Generación por Tiers & Sin Límites: Añade todos los niveles de generadores que desees (carbón, hierro, oro, diamante, etc.) con frecuencias de producción independientes.
Rendimiento Zero-Lag: Generación asíncrona basada en marcas de tiempo acumuladas sin ejecutar tareas individuales por generador.
Producción Fuera de Línea (Offline Generation): Los generadores acumulan producción automáticamente mientras los jugadores están desconectados o en chunks no cargados.
Menús GUI Configurables: Interfaces de usuario interactivas para tiendas de generadores (/gens shop), lista de generadores colocados (/gens mine) y menús de mejora.
Varitas de Venta (Sell Wands): Vende instantáneamente el contenido de cofres con multiplicadores de dinero personalizables y usos finitos/infinitos.
4 Eventos Globales Desactivables: Eventos de servidor para precio de venta (Sell Multiplier), cantidad de gotas (Drop Amount), mejora de tier y aceleración de velocidad.
Límites Dinámicos por Permisos: Controla el número máximo de generadores colocables con nodos como axogens.limit.<cantidad> y bypass automático para administradores.
Soporte para Hologramas: Visualiza información en tiempo real sobre los generadores activos utilizando Display Entities o AxoHologram.

Integraciones Opcionales

Plugin	Función	Modo de Integración
PlaceholderAPI	Expone placeholders globales de estadísticas, límites y generadores del jugador.	Auto-detectado al arrancar el servidor.
Vault	Gestión de economía para compra de generadores, precios de mejora y venta de drops.	Auto-detectado en la inicialización de módulos económicos.
AxoHologram	Creación de hologramas flotantes sobre generadores activos.	Configurable en `generators.yml`.
DecentHolograms	Proveedor alternativo de hologramas flotantes.	Soporte mediante API externa.

Guía de Instalación

Descarga la última versión de AxoGens-1.0.0.jar.
Mueve el archivo .jar a la carpeta plugins/ de tu servidor Paper.
Inicia o reinicia el servidor para generar los archivos de configuración iniciales.
Personaliza los tipos de generador en generators.yml, las varitas en wands.yml y las reglas globales en config.yml.
Ejecuta /gens reload para aplicar los cambios en caliente.

Estructura de Archivos Generados

plugins/AxoGens/
├── config.yml              # Ajustes generales (idioma, intervalos de producción, límites)
├── generators.yml          # Definición de tipos de generador, tiers, materiales y drops
├── wands.yml               # Configuración de varitas de venta (sell wands)
├── events.yml              # Configuración de eventos de producción y multiplicadores
├── menus.yml               # Ajustes de interfaz GUI (tienda y lista de generadores)
├── messages.yml            # Mensajes del plugin en español e inglés (MiniMessage)
├── storage.yml             # Configuración de base de datos SQLite y parámetros de conexión
├── levels.yml              # Configuración del sistema de progresión y niveles
└── axogens.db              # Base de datos SQLite donde se persisten los generadores

Comandos Base y Alias

Comando Base	Alias	Descripción
`/gens`	`/axogens`, `/gen`	Comando principal para jugadores y administradores.

Varitas de Venta (Sell Wands - wands.yml)

Varitas personalizables para vender el contenido de cofres de generadores al hacer clic derecho:

Multiplicadores de Dinero: Configura multiplicadores globales por varita (ej. 1.0x, 1.25x, 1.5x).
Usos Limitados o Infinitos: Define la cantidad de usos antes de romperse o asigna uses: -1 para usos infinitos.
Cooldowns de Seguridad: Evita el spam de ventas agregando tiempos de espera entre usos (ej: 1s, 3s).

Eventos de Servidor (events.yml)

4 Eventos automáticos o manuales para potenciar la economía del servidor:

Sell Price Multiplier: Aumenta temporalmente el valor de venta de los drops generados.
Drop Amount Multiplier: Multiplica la cantidad de ítems producidos en cada ciclo.
Generator Speed Boost: Acelera la velocidad de ciclo de todos los generadores activos.
Drop Tier Upgrade Event: Oportunidad de obtener drops de tiers superiores durante el evento.

Sistema de Niveles & Progresión (levels.yml)

El sistema de niveles permite condicionar la compra o mejora de generadores al nivel actual del jugador.
Los jugadores ganan experiencia progresando en el servidor: dinero gastado, generadores comprados, generadores mejorados y producción acumulada.
Totalmente desactivable desde levels.yml configurando enabled: false.

Lista de Comandos

Comando	Descripción	Descripción
`/gens`	`axogens.use` / `axogens.player`	Muestra la pantalla de ayuda interactiva del plugin.
`/gens shop`	`axogens.shop` / `axogens.player`	Abre la tienda GUI de generadores disponibles.
`/gens mine`	`axogens.mine` / `axogens.player`	Muestra la lista de generadores pertenecientes al jugador y su límite actual.
`/gens give <player> <generator> [amount]`	`axogens.admin.give` / `axogens.admin`	Entrega ítems de generador específicos a un jugador objetivo.
`/gens reload`	`axogens.admin.reload` / `axogens.admin`	Recarga los archivos de configuración, mensajes y registros de generadores.
`/gens info`	`axogens.use` / `axogens.player`	Muestra la información de versión del plugin y el estado de almacenamiento.
`/axogens stats`	`axogens.admin.debug` / `axogens.admin`	Muestra estadísticas globales en consola o chat (instancias activas, producción).
`/axogens debug`	`axogens.admin.debug` / `axogens.admin`	Imprime información detallada de diagnóstico en consola.

Permisos del Sistema

Permiso	Descripción	Descripción
`axogens.player`	`true` (Todos)	Permiso global de jugador: Agrupa todos los permisos básicos (`use`, `shop`, `mine`, `sell`, `upgrade`).
`axogens.use`	`true`	Permite el uso básico de ayuda e información del plugin.
`axogens.shop`	`true`	Permite acceder a la tienda de generadores.
`axogens.mine`	`true`	Permite ver los generadores propios colocados y límites actuales.
`axogens.sell`	`true`	Permite vender los drops acumulados de los generadores.
`axogens.upgrade`	`true`	Permite mejorar generadores al siguiente nivel.
`axogens.bypass`	`OP`	Permite romper o interactuar con generadores pertenecientes a otros jugadores y asigna el límite `hard-cap`.
`axogens.admin`	`OP`	Permiso global de administración: Otorga acceso total a comandos administrativos y bypass.
`axogens.admin.give`	`OP`	Permite usar el comando `/gens give`.
`axogens.admin.reload`	`OP`	Permite ejecutar `/gens reload`.
`axogens.admin.debug`	`OP`	Permite consultar estadísticas de depuración con `/axogens debug`.
`axogens.limit.<cantidad>`	`false`	Define un límite personalizado de generadores (ejemplo: `axogens.limit.50` permite colocar hasta 50 generadores).

Placeholders de PlaceholderAPI (PAPI)

Placeholder	Descripción
`%axogens_limit%`	Retorna el límite máximo de generadores permitido para el jugador.
`%axogens_placed%`	Retorna el total de generadores colocados actualmente por el jugador.
`%axogens_placed_<type_id>%`	Retorna la cantidad de generadores colocados de un tipo específico (ej: `%axogens_placed_coal%`).
`%axogens_production_total%`	Muestra la producción total acumulada en todos los generadores del jugador.
`%axogens_storage_ready%`	Retorna `true` o `false` indicando si el almacenamiento de la base de datos está listo.

Placeholders en Lores y Títulos de Ítems (generators.yml)

Placeholder	Descripción
`<id>`	Identificador único del generador (ej: `coal`, `iron`).
`<tier>`	Nivel o tier numérico del generador.
`<name>`	Nombre visual o display name configurado.
`<drop>`	Material del ítem que produce el generador.
`<amount>`	Cantidad base producida en cada ciclo.
`<buy_price>`	Precio de compra en la tienda.
`<upgrade_price>`	Precio de mejora al siguiente nivel.
`<production_time>`	Intervalo de producción formateado (ej: `5s`, `1m`).

Configuración Principal (config.yml)

language: es
debug: false

placement:
  prevent-replace-existing-generator: true
  require-supported-block: false

production:
  tick-interval: 20            # Frecuencia de comprobación en ticks (20 ticks = 1 segundo)
  persist-interval: 30s        # Frecuencia con la que se persisten los generadores modificados
  output-mode: ACCUMULATE      # Acumula la producción internamente
  max-cycles-per-tick: 512

offline-generation:
  enabled: true                # Habilita la generación en chunks descargados/fuera de línea
  max-time: 12h                # Tiempo máximo acumulable fuera de línea
  max-cycles-per-generator: 100000

limits:
  default: 10                  # Límite de generadores por defecto si el jugador no tiene permisos
  hard-cap: 500                # Límite absoluto máximo asignable
  permission-prefix: axogens.limit.

Ejemplo de Tipo de Generador (generators.yml)

generators:
  coal:
    name: "<gray>Coal Generator"
    tier: 1
    material: COAL_BLOCK
    item:
      material: COAL_BLOCK
      name: "<gray>Coal Generator"
      lore:
        - "<dark_gray>Tier <tier>"
        - "<gray>Produces <white><amount>x <drop></white> every <production_time>."
        - "<yellow>Place it to start producing."
    drop:
      material: COAL
      amount: 1
      chance: 100.0
    production-time: 5s
    buy-price: 1000
    sell-price: 1.0
    upgrade-price: 2500
    next: iron
    previous: null
    max-owned: -1
    offline-generation: true
    hologram:
      enabled: true