Plugin de Minecraft Citizens

🔌 Acerca de Citizens

Citizens es un plugin de Minecraft que proporciona un sistema completo para crear y administrar NPCs del lado del servidor. Admite muchos tipos de NPCs (similares a jugadores, mobs, comerciantes, guardias, estatuas) y expone una API para que otros plugins y código personalizado puedan añadir comportamientos, traits e integraciones.

🎯 Propósito

Citizens resuelve la necesidad de personajes no jugables persistentes y configurables en un servidor: los NPCs pueden actuar como comerciantes interactivos, actores con guion, guardias que siguen waypoints, quioscos de información o estatuas decorativas. El plugin lo usan tanto los propietarios de servidores para crear funciones de juego como los desarrolladores para ampliar la funcionalidad mediante la API de Citizens.

⚙️ Características

• Crear y eliminar NPCs con comandos dentro del juego.
• Varios tipos de NPCs (jugador, basados en mobs, aldeanos, etc.).
• Asignar comandos o acciones guionizadas a los NPCs (disparadores de clic/ejecución, adjuntos de comando).
• Waypoints y comportamiento de patrulla para NPCs en movimiento.
• Traits y editores para personalizar el comportamiento y la apariencia de los NPCs.
• Plantillas y persistencia para que los NPCs sobrevivan a los reinicios.
• API para desarrolladores para addons, traits e integraciones.

🧩 Para quién es

• Propietarios de servidores que quieren NPCs interactivos para tiendas, guías o decoración.
• Desarrolladores de plugins que necesitan una API de NPCs para crear integraciones o minijuegos.
• Servidores de comunidad que requieren personajes no jugables decorativos o funcionales.

🏗️ Casos de uso de ejemplo

• Un servidor Survival usa comerciantes NPC para intercambiar objetos sin plugins de economía.
• Un servidor RPG programa NPCs para ofrecer misiones y diálogos.
• Un administrador coloca NPCs de guardia en patrulla que siguen waypoints por un pueblo.
• Los desarrolladores adjuntan traits personalizados a los NPCs para interacciones de minijuegos.

⌨️ Comandos

(Nota: /npc expone muchos subcomandos y nodos de permiso más específicos para funciones concretas; consulta la documentación del plugin para ver el conjunto completo de comandos.)

🔐 Permisos

(Hay muchos nodos de permiso adicionales para comandos y traits específicos; la referencia de permisos del plugin los enumera en detalle.)

⚙️ Instalación

📥 Configuración

• Descarga el JAR oficial del plugin Citizens desde la distribución oficial del proyecto (catálogo de plugins o descargas del proyecto).
• Coloca el JAR en el directorio plugins/ de tu servidor en un servidor compatible con Spigot o Paper.
• Reinicia el servidor y revisa la consola para confirmar que Citizens se cargó y creó sus directorios de datos.

📦 Dependencias

• Por defecto no se listan dependencias externas obligatorias. Citizens suele ampliarse con addons opcionales (addons de terceros u otros plugins), pero ninguno es necesario para el funcionamiento básico.

🧠 Notas técnicas

• Citizens proporciona una API orientada a desarrolladores para que otros plugins puedan crear traits, interactuar con NPCs y enganchar eventos de NPC.
• El plugin almacena los datos de los NPCs de forma persistente para que sigan existiendo tras los reinicios y admite traits/editores para la personalización en tiempo de ejecución.
• La documentación oficial y una wiki de la comunidad cubren comandos, permisos, traits, editores y puntos de integración.

🤝 Cuándo es útil este plugin

Si necesitas NPCs duraderos y programables, y una API para integrar personajes no jugables en la jugabilidad o en los sistemas del servidor, Citizens ofrece la gestión central de NPCs, la persistencia y los puntos de extensión que necesitan tanto los administradores de servidores como los desarrolladores de plugins.