Plugin Minecraft skript-placeholders

🔌 Sobre o skript-placeholders

skript-placeholders é um addon para o plugin Skript que oferece integração com placeholders: ele permite registrar placeholders do Skript e expô-los ao PlaceholderAPI e ao MVdWPlaceholderAPI, para que outros plugins possam consultar variáveis do Skript.

🎯 Objetivo

O plugin resolve o problema de compartilhar valores dinâmicos gerenciados pelo Skript (variáveis, dados calculados) com outros plugins que suportam placeholders. Isso é útil quando você quer que o estado controlado pelo Skript ou valores personalizados apareçam em scoreboards, formatos de chat, boss bars, tab lists ou em qualquer plugin que leia placeholders do PlaceholderAPI / MVdWPlaceholderAPI.

⚙️ Recursos

• Registre e exponha placeholders do Skript para o PlaceholderAPI.
• Suporte opcional ao MVdWPlaceholderAPI (requer um plugin compatível com MVdW para o MVdWPlaceholderAPI funcionar).
• Obtenha valores de placeholders do Skript dentro dos scripts (veja a wiki do projeto para exemplos).
• Fork/continuação do projeto Ersatz, atualizado para funcionar com o sistema PlaceholderExpansion do PlaceholderAPI.

🧩 Para quem é

• Donos e administradores de servidores que usam Skript para implementar lógica personalizada e precisam desses valores disponíveis para outros plugins.
• Servidores que usam PlaceholderAPI ou MVdWPlaceholderAPI e personalizações baseadas em Skript.

🏗️ Exemplos de uso

• Expor uma variável do Skript que contenha a estatística de um jogador para que um plugin de scoreboard possa exibi-la por meio de um placeholder.
• Criar placeholders personalizados no Skript que sejam usados por plugins de chat/tab/bossbar que suportam PlaceholderAPI.

⚙️ Instalação

📥 Configuração

• Baixe o arquivo JAR do plugin e coloque-o no diretório plugins/ do seu servidor.
• Certifique-se de que o Skript (versão 2.7.3 ou mais recente) esteja instalado.
• Instale o PlaceholderAPI ou o MVdWPlaceholderAPI, dependendo do sistema de placeholders que você pretende usar.
• Inicie ou reinicie o servidor e verifique o console para confirmar que o addon foi carregado corretamente.

📦 Dependências

• Skript (requer a versão 2.7.3 ou mais recente)
• PlaceholderAPI ou MVdWPlaceholderAPI (um deles deve estar instalado para a exposição de placeholders)

🧠 Observações técnicas

• O addon é um fork do projeto Ersatz e foi atualizado para usar o sistema PlaceholderExpansion do PlaceholderAPI.
• O autor do plugin lista uma faixa de versões do Minecraft testadas na página do projeto.

🤝 Quando este plugin é útil

Se você administra um servidor que depende do Skript para mecânicas personalizadas e precisa que esses valores gerenciados pelos scripts fiquem acessíveis a outros plugins por meio de um sistema unificado de placeholders, o skript-placeholders oferece uma ponte simples para o PlaceholderAPI e o MVdWPlaceholderAPI.