ZNPCs: plugin para criar NPCs no Minecraft
Dependências: Tipo de servidor: Paper ou Spigot 1.8.8–1.21.4 Versão do Minecraft: 1.8.8–1.21.4 Plugins dependentes: PlaceholderAPI…
Dependências: Tipo de servidor: Paper ou Spigot 1.8.8–1.21.4 Versão do Minecraft: 1.8.8–1.21.4 Plugins dependentes: PlaceholderAPI (opcional, para variáveis em hologramas) Baixar: SpigotMC / GitHub Se você precisa de NP
Dependências:
Tipo de servidor: Paper ou Spigot 1.8.8–1.21.4
Versão do Minecraft: 1.8.8–1.21.4
Plugins dependentes: PlaceholderAPI (opcional, para variáveis em hologramas)
Baixar: SpigotMC / GitHub
Se você precisa de NPCs simples para o lobby ou decoração, o Citizens pode acabar sendo pesado demais. O ZNPCs resolve a mesma tarefa de forma mais simples: é um único arquivo .jar sem uma pilha de dependências, que permite colocar personagens com a própria skin, texto e reação ao clique.
Principais recursos
Todos os NPCs têm um ID numérico único. É possível criar um jogador comum com a skin pelo nickname ou URL, ou colocar um mob como um ZOMBIE ou SKELETON.
Quando um jogador clica em um NPC, o plugin executa as ações definidas. Pode ser uma mensagem, um comando em nome do jogador ou do console, ou até mesmo enviar o jogador para outro servidor via BungeeCord. Se houver várias ações, elas são executadas em sequência. Você também pode configurar um cooldown (atraso) para cada ação.
Texto sobre a cabeça (Lines)
Sobre o NPC é possível adicionar texto com o comando lines. O plugin suporta códigos de cor e, se o PlaceholderAPI estiver instalado, também variáveis, como %player_name% ou %server_online%. Você também pode mudar a altura do texto com o comando height.
Rotas (Paths)
O NPC não precisa necessariamente ficar parado. Para ensiná-lo a andar, é preciso ativar o modo de gravação (/znpcs path create <nome>) e percorrer a rota desejada você mesmo. Ao terminar, é preciso digitar /znpcs path exit. Em seguida, essa rota é atribuída a um NPC específico (/znpcs path set <id> <nome>), e ele começa a percorrê-la infinitamente.
Detalhe importante: o movimento é muito simples. O ZNPCs não usa a busca de caminho vanilla (Pathfinder), por isso os personagens não desviam de obstáculos e não reagem a outros jogadores.
Equipamento e aparência
Os personagens podem ser vestidos com armaduras e receber itens nas mãos. Basta pegar o item desejado e digitar /znpcs equip <id> <slot> (slots disponíveis: HAND, OFFHAND, HELMET, CHESTPLATE, LEGGINGS, BOOTS).
Há também a possibilidade de configurar o comportamento do NPC pelo comando toggle: fazer com que ele olhe para os jogadores próximos (look), espelhe a skin do jogador que olha para ele (mirror), ou adicionar um brilho (glow) na cor escolhida.
Comandos
Esses comandos exigem permissões de administrador (znpcs.admin).
Comando | Descrição | Permissão |
| Cria um NPC nas suas coordenadas | znpcs.admin |
| Exclui um NPC | znpcs.admin |
| Exibe a lista de NPCs e seus IDs | znpcs.admin |
| Teletransporta o NPC até você | znpcs.admin |
| Teletransporta você até o NPC | znpcs.admin |
| Altera o tipo de um NPC existente | znpcs.admin |
| Altera a skin do personagem | znpcs.admin |
| Dá o item da sua mão ao NPC | znpcs.admin |
| Altera o texto sobre o NPC | znpcs.admin |
| Altera a altura do texto (padrão 1) | znpcs.admin |
| Adiciona uma ação ao clicar | znpcs.admin |
| Mostra a lista de ações do NPC (com seus IDs) | znpcs.admin |
| Remove uma ação pelo seu ID | znpcs.admin |
| Define um atraso para a execução da ação | znpcs.admin |
| Grava uma nova rota | znpcs.admin |
| Sai do modo de gravação de rota | znpcs.admin |
| Atribui uma rota ao NPC | znpcs.admin |
| Ativa/desativa opções (look, holo, mirror) | znpcs.admin |
| Adiciona um efeito de brilho na cor escolhida | znpcs.admin |
Tipos de ação para action add:
CMD (executa um comando em nome do jogador)
CONSOLE (executa um comando a partir do console)
CHAT (o jogador escreve uma mensagem no chat)
MESSAGE (envia uma mensagem ao jogador)
SERVER (transfere para outro servidor via BungeeCord)
Permissões de acesso
Aqui tudo é o mais simples possível. Para quase tudo é necessário apenas um nó:
Nó | O que concede |
znpcs.admin | Acesso total a todos os comandos |
Configuração
config.json
Parâmetro | Valor | Descrição |
| 500 | Número máximo de pontos (passos) que podem ser gravados para uma única rota de NPC. Se a rota for longa demais, a gravação para automaticamente ao atingir esse limite. |
| "DEFAULT" | Algoritmo de geração de nomes internos para os NPCs. O valor padrão garante a vinculação correta do ID. |
| TRUE | Alinha automaticamente o NPC exatamente no centro do bloco durante sua criação. Evita o deslocamento do modelo para a borda do bloco. |
| "-" | Símbolo que o plugin usa para substituir espaços no texto dos comandos ou ao gerar identificadores. |
| 600 | Intervalo de salvamento automático dos personagens criados no arquivo npcs.json (600 segundos = 10 minutos). Protege contra a perda de dados em uma queda repentina do servidor. |
| TRUE | Ativação do modo de depuração. O plugin começa a exibir informações técnicas detalhadas e logs de erro no console do servidor. Recomenda-se desativar (false) em servidores estáveis para manter o console limpo. |
| 0.3 | Distância entre as linhas do holograma (texto) sobre a cabeça do NPC. Um valor menor torna o texto mais compacto. |
| 32 | Raio (em blocos) dentro do qual o servidor começa a enviar pacotes ao jogador para renderizar o modelo do NPC. Reduzir o valor economiza recursos do servidor e do cliente. |
| FALSE | Suporte para mudança dinâmica de cores (transição RGB) para o texto dos hologramas. Ativar pode criar carga adicional no cliente. |
npcs.json
Todos os NPCs criados são gravados no arquivo npcs.json. O plugin o gera automaticamente, então é melhor não editá-lo manualmente. A única justificativa para mexer nesse arquivo é quando você precisa transferir NPCs configurados para outro servidor.
conversations.json
Todos os diálogos são armazenados aqui.
paths
A pasta na qual são armazenadas todas as rotas gravadas.
data.json
Aqui é armazenada toda a informação detalhada sobre os NPCs criados.
Integrações
Se o PlaceholderAPI estiver instalado no servidor, o ZNPCs o detecta automaticamente, sem extensões especiais. Isso é útil, por exemplo, se você quiser exibir um contador dinâmico de jogadores online sobre o NPC.
Compatibilidade
O ZNPCs original funciona normalmente apenas até a versão 1.21.1. Para servidores mais novos (1.21.1 e superiores) é preciso instalar o fork ZNPC Plus.
Além disso, o plugin não funciona no Folia devido às particularidades de como ele lida com entidades.
Quando usar o ZNPCs
Se você precisa colocar no spawn um NPC que simplesmente abre um menu, entrega um kit inicial ou transfere jogadores para outros servidores de minigames, o ZNPCs é uma excelente escolha. Ele faz exatamente o que promete e não sobrecarrega o servidor com funcionalidades desnecessárias.
Mas se você pretende criar diálogos ramificados ou missões complexas, vai precisar do ecossistema Citizens + Denizen. O ZNPCs não foi feito para isso.
Instalação
Uma instalação típica leva cerca de 5 minutos. O fluxo é o mesmo; só mudam o loader e o build correspondente.
- 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.








