Plugin Minecraft Citizens

🔌 Sobre o Citizens

Citizens é um plugin de Minecraft que oferece um sistema completo para criar e gerenciar NPCs no servidor. Ele suporta vários tipos de NPCs (semelhantes a jogadores, mobs, lojistas, guardas, estátuas) e expõe uma API para que outros plugins e código personalizado adicionem comportamentos, traits e integrações.

🎯 Objetivo

O Citizens resolve a necessidade de personagens não jogáveis persistentes e configuráveis em um servidor: os NPCs podem atuar como lojistas interativos, atores com script, guardas que seguem waypoints, totens informativos ou estátuas decorativas. O plugin é usado tanto por donos de servidores para criar recursos de gameplay quanto por desenvolvedores para expandir funcionalidades via a API do Citizens.

⚙️ Recursos

• Criar e remover NPCs com comandos no jogo.
• Vários tipos de NPCs (jogador, baseados em mob, aldeões etc.).
• Atribuir comandos ou ações em script aos NPCs (gatilhos de clique/execução, anexos de comando).
• Waypoints e comportamento de patrulha para NPCs em movimento.
• Traits e editores para personalizar o comportamento e a aparência dos NPCs.
• Modelos e persistência para que os NPCs sobrevivam a reinícios.
• API para desenvolvedores com addons, traits e integrações.

🧩 Para quem é

• Donos de servidores que querem NPCs interativos para lojas, guias ou cenário.
• Desenvolvedores de plugins que precisam de uma API de NPC para criar integrações ou minijogos.
• Servidores de comunidade que precisam de personagens não jogáveis decorativos ou funcionais.

🏗️ Casos de uso de exemplo

• Um servidor Survival usa lojistas NPC para trocar itens sem plugins de economia.
• Um servidor RPG cria NPCs com script para oferecer missões e diálogos.
• Um admin coloca NPCs de guarda em patrulha seguindo waypoints pela cidade.
• Desenvolvedores adicionam traits personalizados aos NPCs para interações em minijogos.

⌨️ Comandos

(Observação: /npc expõe muitos subcomandos e nós de permissão mais específicos para recursos particulares; consulte a documentação do plugin para ver o conjunto completo de comandos.)

🔐 Permissões

(Existem muitos nós de permissão adicionais para comandos e traits específicos; a referência de permissões do plugin os lista em detalhes.)

⚙️ Instalação

📥 Configuração

• Baixe o JAR oficial do plugin Citizens a partir da distribuição oficial do projeto (catálogo de plugins ou downloads do projeto).
• Coloque o JAR no diretório plugins/ do seu servidor em um servidor compatível com Spigot ou Paper.
• Reinicie o servidor e verifique o console para confirmar que o Citizens carregou e criou seus diretórios de dados.

📦 Dependências

• Nenhuma dependência externa obrigatória é listada por padrão. O Citizens costuma ser expandido por addons opcionais (addons de terceiros ou outros plugins), mas nenhum é obrigatório para o funcionamento básico.

🧠 Notas técnicas

• O Citizens oferece uma API voltada para desenvolvedores, para que outros plugins possam criar traits, interagir com NPCs e se conectar a eventos de NPC.
• O plugin armazena os dados dos NPCs de forma persistente, para que eles continuem após reinícios, e oferece suporte a traits/editores para personalização em tempo de execução.
• A documentação oficial e uma wiki da comunidade cobrem comandos, permissões, traits, editores e pontos de integração.

🤝 Quando este plugin é útil

Se você precisa de NPCs duráveis e programáveis, além de uma API para integrar personagens não jogáveis à jogabilidade ou aos sistemas do servidor, o Citizens fornece o gerenciamento central de NPCs, a persistência e os pontos de extensão necessários tanto para administradores quanto para desenvolvedores de plugins.