Plugin Minecraft PlaceholderAPI

🔌 Sobre o PlaceholderAPI

O PlaceholderAPI é um plugin de Minecraft que oferece um sistema centralizado de placeholders e um ecossistema de expansões (a eCloud). Ele permite que outros plugins leiam e substituam milhares de placeholders dinâmicos (dados do jogador, valores de economia, valores específicos de plugins, etc.) sem exigir integração direta ou dependências rígidas.

🎯 Objetivo

O plugin resolve a dificuldade de integração entre plugins ao fornecer uma única API de placeholders, extensível. Os autores dos plugins publicam expansões que fornecem placeholders nomeados; os administradores do servidor instalam essas expansões para que plugins voltados ao servidor (scoreboards, chat, hologramas, GUIs) possam exibir dados ao vivo usando uma sintaxe consistente.

⚙️ Recursos

• API principal de parsing de placeholders para outros plugins integrarem.
• Sistema de expansões: expansões empacotadas separadamente ou incluídas dentro de plugins.
• eCloud (nuvem de expansões) para encontrar e baixar expansões verificadas dentro do jogo.
• Comandos de gerenciamento em tempo de execução para listar, registrar, desregistrar e recarregar expansões.
• Comandos de debug/parsing para avaliar placeholders para um jogador ou transmitir o resultado para todos, útil para resolver problemas.
• Utilitários como o comando dump para compartilhar expansões instaladas e o estado do plugin ao pedir suporte.

🧩 Para quem é

• Administradores de servidor que precisam de texto dinâmico unificado entre vários plugins (scoreboards, tablists, hologramas, GUIs).
• Desenvolvedores de plugins que querem expor ou consumir placeholders sem forçar dependências rígidas.
• Servidores de Survival, minigame e rede que combinam muitos plugins e precisam de uma sintaxe consistente de placeholders.

🏗️ Exemplos de uso

• Um servidor instala uma expansão Vault para que placeholders de economia, como saldo do jogador, possam ser usados em plugins de scoreboard e chat.
• Um administrador baixa uma expansão específica de plugin pela eCloud para que um plugin de holograma possa mostrar dados de objetivos em tempo real.
• Um desenvolvedor expõe dados do plugin via uma PlaceholderExpansion para que outros servidores possam exibir esses dados sem depender diretamente do plugin.

⌨️ Comandos

(Observação: os comandos acima estão documentados na referência oficial de comandos do PlaceholderAPI. Os nós de permissão para comandos individuais não estão listados na documentação de comandos referenciada.)

⚙️ Instalação

📥 Configuração

• Baixe o jar oficial do PlaceholderAPI e coloque-o no diretório plugins/ do seu servidor.
• Inicie ou reinicie o servidor e confirme no console que o PlaceholderAPI foi carregado.
• Instale expansões colocando os jars de expansão em plugins/PlaceholderAPI/expansions/ ou usando os comandos da eCloud no jogo (para expansões verificadas).

📦 Dependências

• O próprio PlaceholderAPI não precisa de uma dependência geral de plugin para funcionar. Alguns placeholders fornecidos por expansões dependem de outros plugins (por exemplo, uma expansão que mostra valores de economia vai precisar do plugin de economia correspondente). Esses requisitos dependem da expansão específica.

🧠 Notas técnicas

• O PlaceholderAPI é fornecido para servidores baseados em Spigot e também é muito usado no Paper. Ele expõe uma API para desenvolvedores registrarem PlaceholderExpansions.
• As expansões podem ser distribuídas como arquivos jar independentes ou incluídas dentro de outros plugins; expansões independentes normalmente são instaladas em plugins/PlaceholderAPI/expansions/.
• O recurso eCloud permite descobrir e baixar expansões verificadas no jogo; os servidores precisam permitir HTTPS de saída para que os downloads da eCloud funcionem.
• O plugin inclui comandos de debug e parsing para ajudar administradores a verificar se os placeholders são resolvidos corretamente.

🤝 Quando este plugin é útil

Se o seu servidor usa vários plugins que precisam exibir dados dinâmicos entre plugins (chat, tab, hologramas, scoreboards ou GUIs), o PlaceholderAPI é útil porque centraliza a resolução de placeholders e permite adicionar suporte a outros plugins por meio de expansões modulares, sem modificar cada plugin consumidor.