Plugin Minecraft SCore

🔌 Sobre o SCore

O SCore é o plugin núcleo/biblioteca criado pela Ssomar para centralizar a funcionalidade compartilhada usada em toda a sua suíte de plugins. Ele oferece editores dentro do jogo e recursos em tempo de execução dos quais outros plugins da Ssomar dependem, e também pode ser usado de forma independente para criar e executar projéteis personalizados, gerenciar variáveis e executar comandos personalizados empacotados.

🎯 Objetivo

O SCore existe para fornecer uma base reutilizável para autores de plugins (especificamente a família de plugins Ssomar) para que os recursos sejam implementados uma vez e consumidos por vários plugins. Ele é voltado para desenvolvedores e administradores de servidores que executam um ou mais plugins da Ssomar ou que querem ter esses mecanismos reutilizáveis disponíveis no servidor.

⚙️ Recursos

• Editor dentro do jogo para criar e editar projéteis personalizados.
• Projéteis personalizados em tempo de execução que podem ser lançados ou acionados.
• Variáveis globais e por jogador com tipos (NUMBER, STRING, LIST).
• Suporte a placeholders para variáveis (tokens de placeholder para uso em outros plugins/configurações).
• Estrutura para execução de comandos empacotados/personalizados acessível pelo console do servidor ou por outros plugins.
• Projetado para ser usado como dependência por outros plugins da Ssomar.

🧩 Para quem é

• Donos de servidores que usam plugins da Ssomar (ExecutableItems, ExecutableBlocks etc.).
• Desenvolvedores que precisam de uma biblioteca reutilizável para projéteis, variáveis e execução de comandos personalizados.
• Administradores que querem editores leves dentro do servidor para esses recursos.

🏗️ Casos de uso de exemplo

• Um servidor usa o SCore junto com o ExecutableItems para definir e disparar comportamentos de projéteis personalizados.
• Um admin cria variáveis globais ou por jogador e as expõe como placeholders para menus ou outros plugins.
• Um desenvolvedor de plugin depende do SCore para reutilizar o armazenamento de variáveis e o empacotamento de comandos em vários plugins.

⌨️ Comandos

Observações: a documentação oficial também documenta tokens de placeholder para variáveis (por exemplo, %score_variables_<var_name>% e %score_variables_<var_name>_int%). Os nós de permissão não estão listados nos metadados do plugin referenciado.

⚙️ Instalação

📥 Configuração

• Baixe o SCore oficial .jar para a versão correspondente do plugin.
• Coloque o arquivo .jar no diretório plugins/ do servidor.
• Reinicie o servidor e verifique o console para confirmar que o SCore foi carregado.
• Se você usar outros plugins da Ssomar, instale a build do SCore que corresponda ao sufixo de versão deles, conforme recomendado pelo projeto (compatibilizando a build do SCore com a build do plugin dependente).

🧠 Notas técnicas

• Plataformas com suporte confirmado: Bukkit, Spigot, Paper, Purpur, Folia.
• As versões do Minecraft com suporte confirmado incluem: 1.21.x até 1.8.x (listadas pelo projeto).
• Os metadados do projeto listam um rótulo de licença restritiva (ARR / All Rights Reserved), enquanto a distribuição do projeto também faz referência a um repositório Git para contribuições; esses itens aparecem juntos nos metadados oficiais.
• O SCore foi criado para ser instalado como biblioteca/dependência de outros plugins da Ssomar; ele expõe recursos que outros plugins chamam em tempo de execução.

🤝 Quando este plugin é útil

Se você usa plugins da Ssomar ou precisa de um sistema pronto no servidor para projéteis personalizados e placeholders de variáveis, o SCore fornece o runtime compartilhado e os editores dos quais esses plugins dependem, sem exigir que você reimplemente os mesmos mecanismos.