AxoNPCs

AxoNPCs crea NPCs del lado del cliente. Los NPCs no se generan como entidades reales del servidor: cada jugador los ve, oculta e interactúa con ellos desde su propio cliente.

Plataforma

Paper 1.21.11+ / 26.1.2+

Compatibilidad

Paper y Folia

Java Requerido

Java 25+

Autor

AxoStudio

Usos recomendados

Guias de spawn, tutoriales o rutas de servidor.
Accesos rapidos a comandos, menus o zonas importantes.
Decoracion interactiva sin cargar el mundo con entidades persistentes.
Puntos de informacion con mensajes o comandos por click.

Caracteristicas principales

Nombres con MiniMessage y colores legacy.
Skins de jugadores, skin espejada del viewer o sin skin personalizada.
Brillo con color, escala visual, colisiones y cooldowns de interaccion.
Acciones por click derecho, click izquierdo o cualquier click.
Cada NPC se guarda en su propio archivo YAML.

Estructura del plugin

AxoNPCs/
|-- config.yml
|-- version.yml
|-- languages/
|   |-- en.yml
|   |-- es.yml
|   `-- ru.yml
|-- logs/
|-- skins/
`-- npcs/
    |-- npc_1.yml
    |-- npc_2.yml
    `-- ejemplo.yml

NPCs individuales

Cada NPC se guarda en su propio archivo YAML dentro de npcs/. El nombre del archivo se basa en el ID del NPC y solo permite letras, numeros, _ y -.

npcs/npc_1.yml: NPC guardado con ID npc_1.
npcs/ejemplo.yml: NPC guardado con ID ejemplo.
Usa IDs claros para que los comandos y archivos sean faciles de ubicar.

Carpetas principales

Ruta	Uso
`config.yml`	Configuracion principal y feature flags.
`version.yml`	Informacion de version del plugin.
`languages/`	Mensajes por idioma: `en.yml`, `es.yml` y `ru.yml`.
`logs/`	Registros generados por el plugin.
`skins/`	Datos de skins almacenados por AxoNPCs.
`npcs/`	Archivos YAML individuales de cada NPC.

Comandos principales

Comando	Descripcion
`/axonpcs version`	Muestra la version del plugin y del servidor.
`/axonpcs reload`	Recarga configuracion, mensajes y NPCs guardados. Tambien refresca los NPCs visibles.
`/axonpcs featureflags`	Muestra los feature flags activos desde `config.yml`.
`/axonpc ...`	Alias de `/axonpcs`.

Comandos de NPC

Comando	Descripcion
`/npc` o `/npc help`	Muestra la ayuda del comando.
`/npc create <id> [--position <x y z>] [--world <world>] [--type <type>]`	Crea un NPC. Si lo ejecuta un jugador sin opciones, usa su posicion actual.
`/npc remove <id>`	Elimina el NPC y su archivo.
`/npc list [--type <type>] [--sort id\|type\|world]`	Lista los NPCs guardados, con filtro y orden opcional.
`/npc nearby [radius]`	Lista NPCs cercanos al jugador. Solo jugadores. Por defecto usa radio `16`.
`/npc info <id>`	Muestra datos basicos del NPC: tipo, mundo, posicion y viewers.
`/npc type <id> <type>`	Cambia el tipo guardado del NPC. Actualmente el backend nativo implementa `PLAYER`.
`/npc displayname <id> [name\|@none]`	Consulta o cambia el nombre visible. Usa `@none` para quitarlo.
`/npc skin <id> <skin\|@none\|@mirror>`	Cambia la skin. Puede usar un nombre de jugador, quitarla o espejar la del viewer.
`/npc glowing <id> <color\|off>`	Activa o desactiva el brillo del NPC con color.
`/npc collidable <id> <true\|false>`	Define si el NPC debe ser colisionable desde el cliente.
`/npc scale <id> <factor>`	Cambia la escala visual del NPC.
`/npc movehere <id>`	Mueve el NPC a la posicion del jugador. Solo jugadores.
`/npc moveto <id> <x> <y> <z> [world]`	Mueve el NPC a coordenadas concretas.
`/npc rotate <id> <yaw> <pitch>`	Cambia la rotacion del NPC.
`/npc teleport <id>`	Teletransporta al jugador al NPC. Solo jugadores.
`/npc action <id> <trigger> add <type> <value>`	Agrega una accion al NPC.
`/npc action <id> <trigger> list`	Lista las acciones de un trigger.
`/npc action <id> <trigger> remove <index>`	Elimina una accion por indice.
`/npc interactioncooldown <id> <disabled\|seconds>`	Cambia el cooldown de interaccion del NPC.

Triggers

Trigger	Cuando se ejecuta
`RIGHT_CLICK`	Cuando el jugador hace click derecho sobre el NPC.
`LEFT_CLICK`	Cuando el jugador hace click izquierdo sobre el NPC.
`ANY`	Cuando el jugador usa cualquier click soportado.

Tipos de accion

Tipo	Resultado
`MESSAGE`	Envia un mensaje al jugador.
`PLAYER_COMMAND` o `COMMAND`	Ejecuta un comando como el jugador.
`CONSOLE_COMMAND` o `SERVER`	Ejecuta un comando desde consola.

Variables en acciones

En los valores de acciones se pueden usar {player}, {npc} y {world}. PlaceholderAPI tambien se aplica si esta activo en config.yml.

/npc action guia RIGHT_CLICK add MESSAGE Hola {player}, estas hablando con {npc}.
/npc action tienda RIGHT_CLICK add PLAYER_COMMAND shop
/npc action lobby ANY add CONSOLE_COMMAND warp {player} lobby

Glowing y apariencia

Colores sugeridos para /npc glowing:

white, green, aqua, red, yellow, blue, gold, gray, dark_gray,
black, dark_blue, dark_green, dark_aqua, dark_red, dark_purple,
light_purple, pink, off

/npc skin <id> @mirror espeja la skin del viewer.
/npc skin <id> @none quita la skin personalizada.
/npc displayname <id> @none oculta el nombre visible.
/npc interactioncooldown <id> disabled desactiva el cooldown.

/npc help y /npc sin argumentos muestran ayuda sin permiso especial. El resto de comandos valida permisos.

Permiso	Default	Permite
`axonpcs.admin`	`op`	Acceso completo a AxoNPCs.
`axonpcs.command.*`	`op`	Acceso a todos los comandos del plugin.
`axonpcs.command.version`	`op`	Usar `/axonpcs version`.
`axonpcs.command.reload`	`op`	Usar `/axonpcs reload`.
`axonpcs.command.featureflags`	`op`	Usar `/axonpcs featureflags`.
`axonpcs.command.npc.*`	`op`	Acceso a todos los subcomandos de `/npc`.
`axonpcs.command.npc.create`	`op`	Crear NPCs con `/npc create`.
`axonpcs.command.npc.remove`	`op`	Eliminar NPCs con `/npc remove`.
`axonpcs.command.npc.list`	`op`	Listar NPCs con `/npc list` y `/npc nearby`.
`axonpcs.command.npc.info`	`op`	Ver informacion con `/npc info`.
`axonpcs.command.npc.type`	`op`	Cambiar tipo con `/npc type`.
`axonpcs.command.npc.displayname`	`op`	Cambiar nombre visible con `/npc displayname`.
`axonpcs.command.npc.skin`	`op`	Cambiar skin con `/npc skin`.
`axonpcs.command.npc.glowing`	`op`	Cambiar `glowing`, `collidable`, `scale` e `interactioncooldown`.
`axonpcs.command.npc.move`	`op`	Usar `/npc movehere`, `/npc moveto` y `/npc rotate`.
`axonpcs.command.npc.teleport`	`op`	Usar `/npc teleport`.
`axonpcs.command.npc.action`	`op`	Crear, listar y eliminar acciones de NPCs.