Citizens

Crea NPC (personajes no jugadores) con aspecto de jugador, con diálogos, rutas de movimiento e integración con misiones. La base de los servidores RPG.

RPG y NPC SpigotPaperPurpur

Sobre Citizens

Citizens es un plugin para crear y gestionar NPC (personajes no jugadores) en un servidor de Minecraft. Los NPC parecen jugadores de verdad (con la skin que quieras), pero los controla el servidor. Pueden quedarse quietos, recorrer rutas fijas, mantener conversaciones, comerciar con los jugadores y participar en misiones. Citizens es la base de los servidores RPG y MMO. Los NPC pueden tener distintos papeles: comerciante (vende y compra objetos), guardia (ataca mobs hostiles), guía (lleva a los jugadores por una ruta) o dador de misiones (reparte misiones).

El plugin es modular. Citizens por sí solo te da la creación de NPC y rutas de movimiento. Denizen (un plugin aparte) añade scripts avanzados, diálogos y mecánicas de misiones. Citizens también se integra con Sentinel (NPC como guardias o luchadores) y BetonQuest (un sistema de misiones).

Citizens es uno de los plugins de RPG clave que valen la pena para tu servidor de Minecraft. Es compatible con Minecraft 1.8.8 - 1.21.x y funciona en Spigot, Paper y Purpur.

Características de Citizens

Estas son las características principales que Citizens añade a tu servidor. Puedes configurar cada una en el archivo de configuración del plugin.

NPC con cualquier skin
Rutas de movimiento (waypoints)
Integración con Denizen (diálogos)
Distintos tipos de NPC (comerciante, guardia)
Sentinel (NPC de combate)
Compatible con más de 20 tipos de entidades

Comandos de Citizens

Estos son los 6 comandos más importantes de Citizens. La lista completa está en la documentación oficial. Ten en cuenta que puedes bloquear o permitir cualquier comando mediante un sistema de permisos (por ejemplo LuckPerms).

Comando	Descripción	Permiso
`/npc create [nombre]`	Crea un NPC nuevo	`citizens.npc.create`
`/npc skin [jugador]`	Le pone al NPC la skin de la cuenta de un jugador	`citizens.npc.skin`
`/npc select`	Selecciona un NPC (haz clic derecho sobre él)	`citizens.npc.select`
`/npc remove`	Elimina el NPC seleccionado	`citizens.npc.remove`
`/npc tphere`	Teletransporta el NPC hasta ti	`citizens.npc.tphere`
`/npc lookclose`	Hace que el NPC mire al jugador más cercano	`citizens.npc.lookclose`

Consejo: Usa el autocompletado con Tab en la consola del servidor para ver los argumentos que acepta un comando. En un servidor con LuckPerms, da los permisos a grupos, no a jugadores individuales.

Permisos

El sistema de permisos te permite controlar quién puede usar cada función de Citizens. Los permisos se asignan con un plugin de rangos como LuckPerms (/lp group [grupo] permission set [nodo] true). La columna "OP por defecto" indica si los operadores del servidor tienen el permiso sin ninguna configuración.

Nodo de permiso	Descripción	OP por defecto
`citizens.npc.create`	Crear NPC	Sí
`citizens.npc.edit`	Editar NPC	Sí
`citizens.npc.remove`	Eliminar NPC	Sí

Configuración de Citizens

En el primer arranque, Citizens genera un archivo de configuración en la carpeta plugins/Citizens/. Abajo están las opciones más importantes, con comentarios. La lista completa de ajustes está en la documentación oficial.

# config.yml de Citizens
npc:
  default:
    look-close:
      enabled: false       # Por defecto, los NPC no miran a los jugadores
      range: 5             # Alcance de la mirada
    pathfinding:
      enabled: true
      attack-range: 1.75   # Alcance de ataque de los guardias
  max-npcs-per-player: 10  # Límite de NPC por jugador

Después de cambiar la configuración, guarda el archivo y usa un comando de recarga (por ejemplo /reload o el comando de recarga del propio plugin). Si el plugin no aplica los cambios tras recargar, reinicia el servidor: deténlo con /stop y vuelve a iniciarlo.

YAML no perdona. Un solo espacio o tabulación mal puesto puede romper todo el archivo. Usa un editor con resaltado de sintaxis (VS Code, Notepad++) y revisa el archivo en yamllint.com antes de subirlo al servidor.

Cómo instalar Citizens

Descarga Citizens desde el sitio oficial. Asegúrate de obtener una versión compatible con tu versión de Minecraft (1.8.8 - 1.21.x).
Copia el archivo .jar descargado en la carpeta plugins/ del directorio de tu servidor.
Detén el servidor con /stop y vuelve a iniciarlo. No uses /reload en la primera instalación.
Revisa la consola del servidor. Si Citizens se cargó bien, verás un mensaje con la versión del plugin. Si hay un error, comprueba que tengas instaladas todas las dependencias.
Configura el plugin editando plugins/Citizens/config.yml (o su equivalente). Después de hacer cambios, usa el comando de recarga.

Compatibilidad de servidor: Citizens funciona en Spigot, Paper y Purpur. Te recomendamos Paper como motor de servidor: tiene mejor rendimiento y más APIs que Spigot.

Alternativas a Citizens

Citizens no es el único plugin de su categoría. Abajo tienes alternativas que vale la pena considerar si buscas algo distinto o si Citizens no cubre tus necesidades.

FancyNPCs

Una alternativa más ligera con un enfoque minimalista para crear NPC.

ZNPCsPlus

Un plugin moderno de NPC basado en paquetes que funciona sin ProtocolLib.

Preguntas frecuentes sobre Citizens

¿Cómo instalo Citizens?

Descarga Citizens desde el servidor de CI oficial. Pon el .jar en plugins/ y reinicia el servidor. Crea NPC con el comando /npc create [nombre]. Para diálogos y misiones, instala Denizen o BetonQuest. Encontrarás instrucciones detalladas, con dependencias y configuración, en la sección de instalación de arriba.

¿En qué motores de servidor funciona Citizens?

Citizens funciona en: Spigot, Paper, Purpur. Te recomendamos Paper como motor: para la mayoría de los servidores ofrece el mejor equilibrio entre rendimiento y compatibilidad con plugins. Puedes leer más sobre los motores de servidor en nuestra comparativa.

¿Citizens es gratis?

Citizens está disponible en su sitio oficial. Revisa los detalles de la licencia en la página de descarga.

Citizens no funciona. ¿Qué hago?

Revisa el archivo logs/latest.log en el directorio de tu servidor. Las causas más comunes de errores son: (1) una dependencia que falta, (2) una versión de Minecraft incompatible (comprueba que la versión de tu servidor esté dentro de 1.8.8 - 1.21.x), (3) un error en config.yml (revisa el formato YAML), (4) un conflicto con otro plugin que hace lo mismo.

¿Puedo usar Citizens en un servidor de Bedrock?

No. Citizens es un plugin de Java Edition y funciona en servidores Spigot/Paper/Purpur. Bedrock Edition usa un sistema distinto (behavior packs). Si quieres jugadores de Java y de Bedrock en un mismo servidor, échale un vistazo a Geyser.