PlaceholderAPI — o plugin de substituição de dados dinâmicos no Minecraft

PlaceholderAPI — o plugin de substituição de dados dinâmicos no Minecraft

• Versão do Minecraft em que o artigo foi testado e escrito: 26.1.2

• Intervalo de versões suportadas: 1.8.x – 26.1.x

O PlaceholderAPI (abreviado PAPI) é um plugin de servidor para Minecraft que insere no texto valores dinâmicos em vez de marcadores especiais. Por si só, não apresenta nada: é um motor que procura numa cadeia de texto um marcador do tipo %player_name% e substitui-o pelo valor atual — o nome do jogador, o saldo, a patente, o número de jogadores online. Os próprios dados são fornecidos por módulos separados — as expansões —, enquanto o PAPI apenas executa a substituição. Graças a isto, os plugins de chat, scoreboard, tab-list e menus leem os valores num único formato, sem sintaxe própria.

Formato dos placeholders

Um placeholder escreve-se entre dois sinais de percentagem: %<розширення>_<параметр>%. A primeira parte, antes do underscore, é o nome da expansão; a seguir vem o parâmetro concreto. Por exemplo, %player_name% devolve o nome do jogador, e %server_online% o número de jogadores online.

A substituição só ocorre onde o próprio plugin destinatário a invoca. Se um plugin não suportar o PAPI, os marcadores nas suas mensagens permanecerão como texto simples. É possível verificar um placeholder específico com o comando de análise:

/papi parse me %player_name%

Se a resposta devolver o próprio texto do marcador em vez de um valor, é porque a expansão necessária não existe ou o plugin de origem está desativado.

Expansões e eCloud

O PlaceholderAPI não traz, por padrão, nenhum placeholder — todos vêm de expansões. Algumas estão incorporadas no plugin de origem e registam-se automaticamente ao arrancar o servidor; outras existem como ficheiros jar separados na nuvem de expansões (eCloud) e instalam-se na pasta /plugins/PlaceholderAPI/expansions/.

A expansão pretendida pode ser descarregada diretamente a partir do jogo:

/papi ecloud download <розширення>

/papi reload

Através do comando só se descarregam expansões verificadas — uma proteção contra código malicioso. As não verificadas instalam-se manualmente: descarrega-se o jar a partir do site e coloca-se na pasta das expansões.

Comandos

Todos os comandos começam por /papi. Por padrão só estão disponíveis para operadores; permissões específicas são atribuídas através dos nós placeholderapi.*.

Configuração

Em config.yml apenas alguns parâmetros são úteis para editar:

Os restantes valores do ficheiro são de serviço (proteção das expansões, modo de substituição nos componentes Adventure, depuração) e, por padrão, não são alterados.

Conclusão

O PlaceholderAPI oferece um formato único de substituição de dados que centenas de plugins compreendem: em vez de uma integração separada para cada plugin, basta uma única linha com um placeholder. É útil para administradores de servidores Minecraft com chat, tab-list, scoreboard ou menus baseados em dados dinâmicos; para o jogo a solo não tem aplicação.