Plugin Minecraft PlayerPoints

🔌 Sobre o PlayerPoints

O PlayerPoints é um plugin de Minecraft que fornece um sistema de moeda baseado em pontos para servidores. Expõe uma API para que outros plugins se integrem diretamente, oferece hooks opcionais para plugins populares e inclui suporte de armazenamento baseado em SQL.

🎯 Objetivo

O PlayerPoints foi criado para oferecer aos servidores uma economia secundária leve (pontos) que pode ser atribuída, gasta ou consultada por outros plugins. Resolve a necessidade de um sistema simples e programável de pontos/moeda, sem exigir um plugin completo de economia monetária.

⚙️ Funcionalidades

• Sistema de moeda baseado em pontos para contas de jogadores.
• API pública para outros plugins lerem e alterarem pontos.
• Suporte a SQL para armazenamento persistente (o repositório descreve suporte a SQL).
• Hooks de integração opcionais para Vault e PlaceholderAPI.
• Cria a sua própria pasta de dados do plugin na primeira execução e guarda lá a configuração/dados.

🧩 Para Quem É

• Servidores Survival e SMP que querem uma moeda secundária em pontos.
• Servidores que precisam de uma API simples para autores de plugins atribuírem ou verificarem pontos de jogadores.
• Servidores que preferem integração opcional com Vault/PlaceholderAPI.

🏗️ Casos de Uso de Exemplo

• Atribuir pontos como recompensa por minijogos ou quests.
• Usar pontos como moeda para comprar itens cosméticos ou permissões do servidor através de outro plugin.
• Plugins a lerem pontos para criar sistemas de ranks, tabelas de classificação ou acompanhamento de progresso.

⚙️ Instalação

📥 Configuração

• Transfere o jar do plugin a partir do recurso oficial e coloca o jar no diretório plugins/ do teu servidor.
• Inicia o servidor. Na primeira inicialização, o PlayerPoints criará uma pasta plugins/PlayerPoints com os ficheiros de configuração e dados.
• Confirma que o plugin foi carregado verificando a consola do servidor em busca de mensagens do PlayerPoints.

📦 Dependências

• Não há dependências obrigatórias.
• Opcional: Vault (hook opcional) e PlaceholderAPI (hook opcional).

🧠 Notas Técnicas

• As fontes oficiais indicam compatibilidade com Spigot e os seus forks; Paper é recomendado. CraftBukkit não é suportado.
• O projeto indica suporte para as versões de Minecraft 1.8.8 e mais recentes.
• O plugin é open-source sob a licença GPL-3.0 e expõe uma API para integração por outros plugins.

🤝 Quando Este Plugin É Útil

Quando precisas de um sistema de pontos simples e programável, com API e integração opcional com plugins comuns do ecossistema, o PlayerPoints oferece uma solução focada que outros plugins podem ligar de forma fiável.