Comment créer un plugin de scoreboard Minecraft

Étape par étape

1. 1.Écrivez les lignes

   Le titre et chaque ligne de haut en bas, avec les valeurs qu'elles affichent : « Grade : Admin », « Pièces : 1 250 », « En ligne : 34 ». La sidebar affiche 15 lignes au maximum.

2. 2.Donnez un scoreboard à chaque joueur

   Des lignes qui diffèrent selon le joueur nécessitent un scoreboard par joueur, obtenu avec Bukkit.getScoreboardManager().getNewScoreboard() et appliqué avec player.setScoreboard(...) à la connexion.

3. 3.Créez l'objectif de la sidebar

   Enregistrez un objectif dummy et réglez son emplacement d'affichage sur DisplaySlot.SIDEBAR. Chaque ligne est une entrée avec un score qui fixe sa position.

4. 4.Mettez à jour les valeurs

   Une tâche répétée, par exemple chaque seconde, ne met à jour que les lignes qui ont changé. Utilisez les préfixes et suffixes d'équipe pour le texte afin que les lignes ne scintillent pas.

5. 5.Ajoutez des placeholders

   Avec PlaceholderAPI, des lignes comme %vault_eco_balance% affichent des valeurs d'autres plugins sans code supplémentaire.

6. 6.Compilez et regardez-le en jeu

   Laissez Codexe le compiler, rejoignez le serveur de test et vérifiez chaque ligne, puis modifiez une valeur et regardez-la se mettre à jour.

Comment fonctionne la sidebar

• Un seul objectif est affiché à la fois dans la sidebar pour chaque scoreboard. Son nom d'affichage sert de titre.
• Les lignes sont triées par score, du plus élevé au plus bas, le score n'est donc que le numéro de ligne à l'envers.
• Chaque ligne doit être une entrée différente : deux lignes identiques ont besoin d'une différence invisible, comme des codes couleur différents.
• Les chiffres rouges à droite peuvent être masqués depuis Minecraft 1.20.3, qui a ajouté des formats de nombre pour les scores. Les versions plus anciennes les affichent toujours.
• Un joueur ne voit qu'un seul scoreboard : si un autre plugin définit le sien, c'est le dernier qui l'emporte. Utilisez un seul plugin pour la sidebar, ou indiquez quels autres plugins partagent le scoreboard.

Mettre à jour sans scintillement

Retirer une ligne pour en ajouter une nouvelle la fait clignoter. La solution habituelle consiste à donner à chaque ligne une entrée fixe et invisible, et à placer le texte visible dans le préfixe et le suffixe d'une équipe qui contient cette entrée ; mettre à jour l'équipe change le texte sur place. Demandez « sans scintillement » dans la demande et le plugin est écrit de cette façon.

Plugin, Skript ou datapack ?

Exemple de description

« Un plugin Paper 1.21.4 appelé Board. Une sidebar pour chaque joueur avec le titre en doré, puis le grade (depuis LuckPerms), les pièces (depuis Vault), les éliminations, les morts, les joueurs en ligne et l'adresse du serveur. Mise à jour chaque seconde sans scintillement, chiffres rouges masqués. Lignes, titre et intervalle de mise à jour dans config.yml, avec les placeholders de PlaceholderAPI autorisés dans n'importe quelle ligne. /board toggle la masque pour chaque joueur et le choix est sauvegardé. »

Questions