Plugin Minecraft FancyNpcs

🔌 Sobre o FancyNpcs

FancyNpcs é um plugin de Minecraft para criar e gerenciar personagens não jogáveis (NPCs) usando packets. Ele é voltado para servidores Paper e Folia e oferece uma alternativa baseada em packets aos plugins de NPCs sustentados por entidades. O plugin foca em aparência e interações configuráveis, minimizando o uso de entidades do lado do servidor.

🎯 Propósito

O FancyNpcs foi pensado para administradores de servidor que precisam de NPCs leves e personalizáveis para exibições cosméticas, quiosques interativos ou interações com script, sem gerar entidades completas no servidor. Ele resolve o problema de implementações pesadas de NPCs usando renderização por packets no cliente e um sistema de ações documentado.

⚙️ Recursos

• Crie, copie, remova e liste NPCs no jogo com um único comando /npc.
• NPCs do tipo jogador e do tipo mob com skins personalizáveis (nome de usuário, UUID, URL ou arquivo local) e suporte ao modelo slim.
• Slots de equipamento: capacete, peitoral, calças, botas, configuração da mão principal e da mão secundária.
• Brilho com cores configuráveis e visibilidade opcional na lista de jogadores para NPCs do tipo jogador.
• Nomes de exibição com suporte a MiniMessage, PlaceholderAPI e MiniPlaceholders.
• Sistema de ações com gatilhos e vários tipos de ação (adicionar, remover, listar, reordenar, limpar) para comportamentos interativos.
• Controles de localização e rotação, comandos de movimento/teleporte e comportamento de "virar para o jogador" com base na distância.
• Suporte a tamanho/escala nas versões mais novas do Minecraft, quando disponível.
• O plugin expõe uma API para criação e gerenciamento programáticos de NPCs.

🧩 Para quem é

• Servidores Survival e SMP que querem NPCs cosméticos ou interativos sem adicionar carga de entidades.
• Networks ou lobbies que precisam de NPCs leves para menus, lojas ou pontos de informação.
• Desenvolvedores que querem integrar a criação de NPCs por meio de uma API fornecida.

🏗️ Casos de uso de exemplo

• Um servidor hub cria NPCs estacionários com skins personalizadas que mostram informações ao clicar.
• Um servidor RPG usa NPCs com ações scriptadas para guiar jogadores ou disparar comandos e mensagens.
• Um plugin de desenvolvedor registra NPCs em tempo de execução usando a API do FancyNpcs.

⌨️ Comandos

🔐 Permissões

⚙️ Instalação

📥 Configuração

• Baixe o arquivo JAR do plugin FancyNpcs em uma página de distribuição compatível.
• Coloque o JAR no diretório plugins/ do seu servidor.
• Reinicie o servidor e verifique o console para confirmar que o plugin foi carregado.

📦 Dependências

• O FancyNpcs foi criado para o software de servidor Paper e Folia e requer Paper para funcionar. O autor documenta o plugin como não exigindo dependências externas adicionais de outros plugins.

🧾 Configuração

• O plugin fornece comandos no jogo para a maioria das tarefas; os arquivos de configuração e o comportamento do plugin estão documentados na documentação oficial.

🧠 Notas técnicas

• Software de servidor compatível confirmado: Paper e Folia.
• O FancyNpcs usa renderização baseada em packets para apresentar NPCs aos clientes, em vez de gerar entidades persistentes no lado do servidor.
• O projeto expõe uma API Java para integração e criação/registro programático de NPCs.
• O autor coleta métricas anônimas de uso com opção de opt-out; os detalhes da coleta de dados estão documentados pelo projeto.

🤝 Quando este plugin é útil

Se você precisa de NPCs renderizados no cliente com aparência flexível e interações scriptadas, mantendo baixa a carga de entidades no servidor, o FancyNpcs oferece uma solução baseada em packets com gerenciamento no jogo e uma API para integrações.