ZNPCs: plugin para crear NPC en Minecraft
Dependencias: Tipo de servidor: Paper o Spigot 1.8.8–1.21.4 Versión de Minecraft: 1.8.8–1.21.4 Plugins dependientes: PlaceholderAPI…
Dependencias: Tipo de servidor: Paper o Spigot 1.8.8–1.21.4 Versión de Minecraft: 1.8.8–1.21.4 Plugins dependientes: PlaceholderAPI (opcional, para variables en hologramas) Descargar: SpigotMC / GitHub Si necesitas NPC
Dependencias:
Tipo de servidor: Paper o Spigot 1.8.8–1.21.4
Versión de Minecraft: 1.8.8–1.21.4
Plugins dependientes: PlaceholderAPI (opcional, para variables en hologramas)
Descargar: SpigotMC / GitHub
Si necesitas NPC sencillos para el lobby o de decoración, Citizens puede resultar demasiado pesado. ZNPCs resuelve la misma tarea de forma más simple: es un único archivo .jar sin un montón de dependencias que permite colocar personajes con su propia skin, texto y reacción al clic.
Funciones principales
Todos los NPC tienen un ID numérico único. Puedes crear un jugador normal con una skin por nombre de usuario o URL, o colocar un mob como un ZOMBI o un ESQUELETO.
Cuando un jugador hace clic en un NPC, el plugin ejecuta las acciones definidas. Puede ser un mensaje, un comando en nombre del jugador o de la consola, o incluso enviar al jugador a otro servidor mediante BungeeCord. Si hay varias acciones, se ejecutan por turnos. También puedes configurar un cooldown (retardo) para cada acción.
Texto sobre la cabeza (Lines)
Sobre un NPC puedes añadir texto con el comando lines. El plugin admite códigos de color y, si tienes PlaceholderAPI, también variables como %player_name% o %server_online%. También puedes cambiar la altura del texto con el comando height.
Rutas (Paths)
Un NPC no tiene por qué quedarse quieto en un sitio. Para enseñarle a caminar, debes activar el modo de grabación (/znpcs path create <nombre>) y recorrer tú mismo la ruta deseada. Al terminar, debes escribir /znpcs path exit. Después, esa ruta se asigna a un NPC concreto (/znpcs path set <id> <nombre>), y este empieza a recorrerla indefinidamente.
Un matiz importante: el movimiento es muy simple. ZNPCs no utiliza la búsqueda de caminos vanilla (Pathfinder), por lo que los personajes no esquivarán obstáculos ni reaccionarán a otros jugadores.
Equipamiento y apariencia
A los personajes se les puede poner armadura y darles objetos en las manos. Basta con tomar el objeto deseado y escribir /znpcs equip <id> <ranura> (ranuras disponibles: HAND, OFFHAND, HELMET, CHESTPLATE, LEGGINGS, BOOTS).
También es posible configurar el comportamiento del NPC mediante el comando toggle: hacer que mire a los jugadores más cercanos (look), reflejar la skin del jugador que lo mira (mirror) o añadir un resplandor (glow) del color elegido.
Comandos
Estos comandos requieren permisos de administrador (znpcs.admin).
Comando | Descripción | Permiso |
| Crea un NPC en tus coordenadas | znpcs.admin |
| Elimina un NPC | znpcs.admin |
| Muestra la lista de NPC y sus ID | znpcs.admin |
| Teletransporta el NPC hacia ti | znpcs.admin |
| Te teletransporta hacia el NPC | znpcs.admin |
| Cambia el tipo de un NPC existente | znpcs.admin |
| Cambia la skin del personaje | znpcs.admin |
| Da al NPC el objeto que tienes en la mano | znpcs.admin |
| Cambia el texto sobre el NPC | znpcs.admin |
| Cambia la altura del texto (por defecto 1) | znpcs.admin |
| Añade una acción al hacer clic | znpcs.admin |
| Muestra la lista de acciones del NPC (con sus ID) | znpcs.admin |
| Elimina una acción por su ID | znpcs.admin |
| Establece un retardo para la ejecución de la acción | znpcs.admin |
| Graba una nueva ruta | znpcs.admin |
| Sale del modo de grabación de la ruta | znpcs.admin |
| Asigna una ruta al NPC | znpcs.admin |
| Activa/desactiva opciones (look, holo, mirror) | znpcs.admin |
| Añade un efecto de resplandor del color elegido | znpcs.admin |
Tipos de acción para action add:
CMD (ejecuta un comando en nombre del jugador)
CONSOLE (ejecuta un comando desde la consola)
CHAT (el jugador escribe un mensaje en el chat)
MESSAGE (envía un mensaje al jugador)
SERVER (lo envía a otro servidor mediante BungeeCord)
Permisos de acceso
Aquí todo es de lo más sencillo. Para casi todo solo hace falta un único nodo:
Nodo | Qué otorga |
znpcs.admin | Acceso completo a todos los comandos |
Configuración
config.json
Parámetro | Valor | Descripción |
| 500 | Número máximo de puntos (pasos) que se pueden grabar para una sola ruta de NPC. Si la ruta es demasiado larga, la grabación se detendrá automáticamente al alcanzar este límite. |
| "DEFAULT" | Algoritmo de generación de nombres internos para los NPC. El valor estándar garantiza una vinculación correcta del ID. |
| TRUE | Alinea automáticamente al NPC exactamente en el centro del bloque al crearlo. Evita que el modelo se desplace hacia el borde del bloque. |
| "-" | Carácter que el plugin utiliza para reemplazar los espacios en el texto de los comandos o al generar identificadores. |
| 600 | Intervalo de guardado automático de los personajes creados en el archivo npcs.json (600 segundos = 10 minutos). Protege contra la pérdida de datos en caso de una caída repentina del servidor. |
| TRUE | Activación del modo de depuración. El plugin empezará a mostrar información técnica detallada y registros de errores en la consola del servidor. Se recomienda desactivarlo (false) en servidores estables para mantener limpia la consola. |
| 0.3 | Distancia entre las líneas del holograma (texto) sobre la cabeza del NPC. Un valor menor hace que el texto quede más compacto. |
| 32 | Radio (en bloques) dentro del cual el servidor empieza a enviar paquetes al jugador para renderizar el modelo del NPC. Reducir el valor ahorra recursos del servidor y del cliente. |
| FALSE | Compatibilidad con el cambio dinámico de colores (degradado RGB) del texto de los hologramas. Activarlo puede generar carga adicional en el cliente. |
npcs.json
Todos los NPC creados se registran en el archivo npcs.json. El plugin lo genera automáticamente, por lo que es mejor no editarlo a mano. La única justificación para meterse en este archivo es cuando necesitas transferir NPC ya configurados a otro servidor.
conversations.json
Todos los diálogos se guardan aquí.
paths
Carpeta en la que se guardan todas las rutas grabadas.
data.json
Aquí se guarda toda la información detallada sobre los NPC creados.
Integraciones
Si en el servidor está instalado PlaceholderAPI, ZNPCs lo detectará automáticamente sin necesidad de extensiones especiales. Esto resulta útil, por ejemplo, si quieres mostrar sobre un NPC un contador dinámico de jugadores en línea.
Compatibilidad
El ZNPCs original funciona correctamente solo hasta la versión 1.21.1. Para servidores más nuevos (1.21.1 y superiores) hay que instalar el fork ZNPC Plus.
Además, el plugin no arrancará en Folia debido a sus particularidades en el manejo de entidades.
Cuándo conviene usar ZNPCs
Si necesitas colocar un NPC en el spawn que simplemente abra un menú, entregue un kit inicial o redirija a los jugadores a otros servidores de minijuegos, ZNPCs es una opción excelente. Hace exactamente lo que promete y no sobrecarga el servidor con funcionalidades innecesarias.
Pero si planeas crear diálogos ramificados o misiones complejas, necesitas el ecosistema de Citizens + Denizen. ZNPCs no está pensado para eso.
Instalación
Una instalación típica lleva unos 5 minutos. El proceso es el mismo; solo cambian el loader y el build correspondiente.
- 1Stop your Minecraft server.
- 2Drop the plugin .jar into the server /plugins folder.
- 3Start the server once so the plugin generates its config files.
- 4Edit /plugins/<name>/config.yml as needed, then run /reload confirm or restart.








