Citizens
Crie NPCs (personagens não jogáveis) com aparência de jogador, com diálogos, rotas de movimento e integração com missões. A base dos servidores de RPG.
Sobre o Citizens
O Citizens é um plugin para criar e gerenciar NPCs (personagens não jogáveis) em um servidor de Minecraft. Os NPCs parecem jogadores de verdade (com a skin que você quiser), mas é o servidor que os controla. Eles podem ficar parados, andar por trajetos definidos, conversar, negociar com jogadores e participar de missões. O Citizens é a base de servidores de RPG e MMO. Os NPCs podem ter papéis diferentes: vendedor (vende e compra itens), guarda (ataca mobs hostis), guia (leva os jogadores por uma rota) ou entregador de missões (distribui missões).
O plugin é modular. O Citizens sozinho oferece a criação de NPCs e os trajetos de movimento. O Denizen (um plugin separado) adiciona scripts avançados, diálogos e mecânicas de missões. O Citizens também se integra ao Sentinel (NPCs como guardas ou lutadores) e ao BetonQuest (um sistema de missões).
O Citizens é um dos principais plugins de RPG que vale considerar para o seu servidor de Minecraft. Ele suporta o Minecraft 1.8.8 - 1.21.x e roda em Spigot, Paper e Purpur.
Recursos do Citizens
Estes são os principais recursos que o Citizens adiciona ao seu servidor. Você pode configurar cada um deles no arquivo de configuração do plugin.
- NPCs com qualquer skin
- Rotas de movimento (waypoints)
- Integração com o Denizen (diálogos)
- Diferentes tipos de NPC (comerciante, guarda)
- Sentinel (NPCs de combate)
- Compatível com mais de 20 tipos de entidades
Comandos do Citizens
Estes são os 6 comandos mais importantes do Citizens. Você encontra a lista completa na documentação oficial. Lembre-se de que dá para bloquear ou liberar qualquer comando por meio de um sistema de permissões (por exemplo o LuckPerms).
| Comando | Descrição | Permissão |
|---|---|---|
/npc create [name] | Cria um novo NPC | citizens.npc.create |
/npc skin [player] | Dá ao NPC a skin da conta de um jogador | citizens.npc.skin |
/npc select | Seleciona um NPC (clique nele com o botão direito) | citizens.npc.select |
/npc remove | Remove o NPC selecionado | citizens.npc.remove |
/npc tphere | Teletransporta o NPC até você | citizens.npc.tphere |
/npc lookclose | Faz o NPC olhar para o jogador mais próximo | citizens.npc.lookclose |
Permissões
O sistema de permissões permite controlar quem pode usar cada recurso do Citizens. Você concede as permissões por meio de um plugin de ranks como o LuckPerms (/lp group [group] permission set [node] true). A coluna "OP por padrão" mostra se os operadores do servidor têm a permissão sem nenhuma configuração.
Configuração do Citizens
Na primeira inicialização, o Citizens gera um arquivo de configuração na pasta plugins/Citizens/. Abaixo estão as opções mais importantes, com comentários. A lista completa de configurações está na documentação oficial.
# config.yml do Citizens
npc:
default:
look-close:
enabled: false # Por padrão, os NPCs não olham para os jogadores
range: 5 # Alcance do olhar
pathfinding:
enabled: true
attack-range: 1.75 # Alcance de ataque dos guardas
max-npcs-per-player: 10 # Limite de NPCs por jogador
Depois de alterar a configuração, salve o arquivo e use um comando de reload (por exemplo /reload ou o comando de reload do próprio plugin). Se o plugin não aplicar as mudanças depois do reload, reinicie o servidor: pare-o com /stop e inicie de novo.
Como instalar o Citizens
Baixe o Citizens no servidor de CI oficial. Coloque o .jar em plugins/ e reinicie o servidor. Crie NPCs com o comando /npc create [name]. Para diálogos e missões, instale o Denizen ou o BetonQuest.
- Baixe o Citizens no site oficial. Confira se você pegou uma versão compatível com a sua versão do Minecraft (1.8.8 - 1.21.x).
-
Copie o arquivo
.jarbaixado para a pastaplugins/do diretório do seu servidor. -
Pare o servidor com
/stope inicie de novo. Não use o/reloadna primeira instalação. - Confira o console do servidor. Se o Citizens carregou corretamente, você verá uma mensagem com a versão do plugin. Se houver um erro, confira se todas as dependências estão instaladas.
-
Configure o plugin editando
plugins/Citizens/config.yml(ou o equivalente). Depois de fazer alterações, use o comando de reload.
Alternativas ao Citizens
O Citizens não é o único plugin da sua categoria. Abaixo estão alternativas que vale considerar se você procura algo diferente ou se o Citizens não atende às suas necessidades.
FancyNPCs
Uma alternativa mais leve, com uma abordagem minimalista para criar NPCs.
ZNPCsPlus
Um plugin de NPCs moderno, baseado em pacotes, que funciona sem o ProtocolLib.
Perguntas frequentes sobre o Citizens
Como instalar o Citizens?
Baixe o Citizens no servidor de CI oficial. Coloque o .jar em plugins/ e reinicie o servidor. Crie NPCs com o comando /npc create [name]. Para diálogos e missões, instale o Denizen ou o BetonQuest. Você encontra instruções detalhadas, com dependências e configuração, na seção de instalação acima.
Em quais engines de servidor o Citizens roda?
O Citizens roda em: Spigot, Paper, Purpur. Recomendamos o Paper como engine: para a maioria dos servidores, ele oferece o melhor equilíbrio entre desempenho e compatibilidade com plugins. Você pode ler mais sobre engines de servidor na nossa comparação.
O Citizens é grátis?
O Citizens está disponível no site oficial. Confira os detalhes da licença na página de download.
O Citizens não está funcionando. O que fazer?
Confira o arquivo logs/latest.log na pasta do seu servidor. As causas mais comuns de erro são: (1) uma dependência ausente, (2) uma versão incompatível do Minecraft (confira se a versão do seu servidor está dentro de 1.8.8 - 1.21.x), (3) um erro no config.yml (confira a formatação do YAML), (4) um conflito com outro plugin que faz a mesma coisa.
Posso usar o Citizens em um servidor Bedrock?
Não. O Citizens é um plugin da Java Edition e roda em servidores Spigot/Paper/Purpur. A Bedrock Edition usa outro sistema (behavior packs). Se você quer jogadores de Java e Bedrock no mesmo servidor, conheça o Geyser.
