Plugin Minecraft SmartSpawner

🔌 Sobre o SmartSpawner

SmartSpawner é um plugin de Minecraft que substitui os spawners tradicionais baseados em mobs por um sistema de spawner virtual orientado por GUI. Em vez de gerar entidades fisicamente, o SmartSpawner calcula os drops e a experiência de forma virtual e os atribui aos jogadores ou ao armazenamento, evitando a IA dos mobs, o pathfinding e os custos de tick das entidades.

🎯 Objetivo

O objetivo principal do SmartSpawner é oferecer aos proprietários e administradores de servidores uma forma de executar economias, farms e funcionalidades de gameplay baseadas em spawners sem os problemas de desempenho e comportamento causados por grandes quantidades de entidades vivas. Ele foi pensado para servidores que querem geração controlada de itens/XP a partir de spawners, minimizando a carga do servidor relacionada a entidades.

⚙️ Funcionalidades

• Gestão de spawners baseada em GUI para administradores e jogadores (menus visuais para configurar e interagir com spawners).
• Cálculo virtual de drops e XP: itens e experiência são gerados sem spawnar mobs reais.
• Dados persistentes de spawners armazenados na pasta do plugin.
• Arquivos de configuração criados automaticamente (os exemplos incluem config.yml, spawners_settings.yml, item_spawners_settings.yml, item_prices.yml, spawners_data.yml e uma pasta language).
• API para desenvolvedores e eventos para integrações e addons.
• Ganchos de integração opcionais (a configuração menciona ficheiros de suporte para integrações como AuraSkills quando presentes).

🧩 Para Quem É

• Servidores de Survival e economia que oferecem geração automatizada de recursos via spawners.
• Servidores que precisam de mecânicas baseadas em spawners, mas querem evitar a sobrecarga de desempenho de entidades/IA.
• Servidores que querem dados de spawners configuráveis e persistentes, além de pontos de integração externos para addons.

🏗️ Casos de Uso Exemplo

• Um servidor opera uma loja de spawners onde os jogadores compram e colocam spawners virtuais que produzem itens e XP periodicamente sem aumentar a contagem de entidades.
• Um mapa de aventura usa spawners para recompensar os jogadores com loot na interação, sem ondas físicas de mobs.
• Uma rede integra o SmartSpawner com plugins de economia e proteção de terrenos para vender e proteger spawners.

⚙️ Instalação

📥 Configuração

• Descarregue o JAR do plugin a partir de uma release oficial (página de download do projeto).
• Coloque o JAR no diretório plugins/ do servidor.
• Inicie o servidor (não dependa de /reload em tempo de execução).
• Na primeira execução, o plugin cria ficheiros de configuração em plugins/SmartSpawner/.

📦 Dependências

• Opcional: AuraSkills (a configuração referencia auraskills.yml se o AuraSkills estiver instalado).

🧠 Notas Técnicas

• Software de servidor confirmado: Paper, Folia, Purpur (e forks compatíveis).
• Versões confirmadas do Minecraft: 1.21 - 1.21.10 (consulte a documentação oficial para os builds suportados exatos).
• Requisito de Java confirmado: Java 21+ conforme listado nos requisitos oficiais de instalação.
• Licença: GPL-3.0-only.
• O plugin fornece uma API para desenvolvedores para addons e integrações; a documentação oficial contém páginas da API e guias de integração.

🤝 Quando Este Plugin É Útil

Se precisa de geração de itens ou XP baseada em spawners sem o custo de desempenho e a variabilidade de comportamento dos mobs vivos, o SmartSpawner oferece uma alternativa configurável, orientada por GUI, com armazenamento persistente de dados e ganchos de integração para addons e sistemas de economia/proteção.