Como criar um plugin de scoreboard para Minecraft

Passo a passo

1. 1.Escreva as linhas

   O título e cada linha de cima para baixo, com os valores que elas mostram: "Rank: Admin", "Coins: 1,250", "Online: 34". A barra lateral mostra no máximo 15 linhas.

2. 2.Dê uma scoreboard a cada jogador

   Linhas que mudam por jogador precisam de uma scoreboard por jogador, criada com Bukkit.getScoreboardManager().getNewScoreboard() e aplicada com player.setScoreboard(...) ao entrar.

3. 3.Crie o objetivo da barra lateral

   Registre um objetivo dummy e defina o slot de exibição como DisplaySlot.SIDEBAR. Cada linha é uma entrada com uma pontuação que define a posição dela.

4. 4.Atualize os valores

   Uma tarefa repetida, por exemplo a cada segundo, atualiza só as linhas que mudaram. Use prefixos e sufixos de time para o texto, assim as linhas não piscam.

5. 5.Adicione placeholders

   Com o PlaceholderAPI, linhas como %vault_eco_balance% mostram valores de outros plugins sem código extra.

6. 6.Compile e veja no jogo

   Deixe o Codexe compilar, entre no servidor de teste e confira cada linha, depois mude um valor e veja ele atualizar.

Como a barra lateral funciona

• Só um objetivo aparece na barra lateral por vez em cada scoreboard. O nome de exibição dele é o título.
• As linhas são ordenadas pela pontuação, da maior para a menor, então a pontuação é só o número da linha ao contrário.
• Cada linha precisa ser uma entrada diferente: duas linhas idênticas precisam de uma diferença invisível, como códigos de cor diferentes.
• Os números vermelhos à direita podem ser escondidos a partir do Minecraft 1.20.3, que adicionou formatos de número para as pontuações. As versões mais antigas sempre os mostram.
• Um jogador vê uma scoreboard só: se outro plugin define a dele, vale a última. Use um único plugin para a barra lateral ou diga quais outros plugins compartilham a scoreboard.

Atualizando sem piscar

Remover uma linha e adicionar uma nova faz ela piscar. A solução comum é dar a cada linha uma entrada fixa e invisível e colocar o texto visível no prefixo e no sufixo de um time que contém essa entrada; atualizar o time muda o texto no lugar. Peça "sem piscar" no pedido e o plugin é escrito assim.

Plugin, Skript ou datapack?

Exemplo de descrição

"Um plugin para Paper 1.21.4 chamado Board. Uma barra lateral para cada jogador com o título em dourado e depois o rank (do LuckPerms), as coins (do Vault), abates, mortes, jogadores online e o endereço do servidor. Atualizada a cada segundo sem piscar, números vermelhos escondidos. Linhas, título e intervalo de atualização no config.yml, com placeholders do PlaceholderAPI permitidos em qualquer linha. /board toggle esconde a barra por jogador e a escolha fica salva."

Perguntas