Ghid

Cum faci un plugin de scoreboard pentru Minecraft

Actualizat 18 octombrie 2026

Bara laterală din dreapta ecranului este partea cea mai vizibilă a multor servere: numele serverului, rangul jucătorului, banii, kill-urile, jucătorii online. Un plugin o desenează prin Scoreboard API din Bukkit. Părțile grele sunt să îi dai fiecărui jucător propriile linii și să le actualizezi fără sacadări.

Schimbă liniile după serverul tău.

Generează asta cu Codexe

Pas cu pas

  1. 1.Scrie liniile

    Titlul și fiecare linie de sus în jos, cu valorile pe care le arată: „Rang: Admin”, „Monede: 1.250”, „Online: 34”. Bara laterală arată cel mult 15 linii.

  2. 2.Dă-i fiecărui jucător un scoreboard

    Liniile care diferă de la un jucător la altul au nevoie de un scoreboard pentru fiecare jucător, din Bukkit.getScoreboardManager().getNewScoreboard(), setat cu player.setScoreboard(...) la intrare.

  3. 3.Creează obiectivul pentru bara laterală

    Înregistrează un obiectiv dummy și setează-i slotul de afișare la DisplaySlot.SIDEBAR. Fiecare linie este o intrare cu un scor care îi stabilește poziția.

  4. 4.Actualizează valorile

    Un task repetat, de exemplu în fiecare secundă, actualizează doar liniile care s-au schimbat. Folosește prefixe și sufixe de echipă pentru text, ca liniile să nu pâlpâie.

  5. 5.Adaugă placeholder-e

    Cu PlaceholderAPI, linii precum %vault_eco_balance% arată valori din alte plugin-uri fără cod în plus.

  6. 6.Construiește-l și privește-l în joc

    Lasă Codexe să îl compileze, intră pe serverul de testare și verifică fiecare linie, apoi schimbă o valoare și vezi cum se actualizează.

Cum funcționează bara laterală

  • Pentru fiecare scoreboard se afișează în bara laterală un singur obiectiv odată. Numele lui afișat este titlul.
  • Liniile sunt ordonate după scor, cel mai mare primul, așa că scorul este doar numărul liniei, invers.
  • Fiecare linie trebuie să fie o intrare diferită: două linii identice au nevoie de o diferență invizibilă, de exemplu coduri de culoare diferite.
  • Numerele roșii din dreapta pot fi ascunse începând cu Minecraft 1.20.3, care a adăugat formate de numere pentru scoruri. Versiunile mai vechi le arată mereu.
  • Un jucător vede un singur scoreboard: dacă alt plugin îl setează pe al lui, câștigă ultimul. Folosește un singur plugin pentru bara laterală sau spune ce alte plugin-uri împart scoreboard-ul.

Actualizare fără pâlpâire

Dacă ștergi o linie și adaugi una nouă, ea clipește. Soluția obișnuită este să îi dai fiecărei linii o intrare fixă, invizibilă, și să pui textul vizibil în prefixul și sufixul unei echipe care conține acea intrare; actualizarea echipei schimbă textul pe loc. Cere „fără pâlpâire” în cerere, iar pluginul este scris așa.

Plugin, Skript sau datapack?

OpțiunePoate faceLimită
PluginLinii per jucător, orice valoare, animații, placeholder-eAre nevoie de Spigot, Paper sau un fork
Skript cu SkBeeBare laterale per jucător dintr-un scriptAre nevoie de Skript și de add-on
DatapackArată în bara laterală un singur obiectiv, de exemplu morți sau kill-uriAceleași numere pentru toată lumea, fără text liber per jucător

Exemplu de descriere

„Un plugin Paper 1.21.4 numit Board. O bară laterală pentru fiecare jucător, cu titlul auriu, apoi rangul (din LuckPerms), monedele (din Vault), kill-urile, morțile, jucătorii online și adresa serverului. Actualizată în fiecare secundă fără pâlpâire, numerele roșii ascunse. Liniile, titlul și intervalul de actualizare în config.yml, cu placeholder-e PlaceholderAPI permise în orice linie. /board toggle o ascunde pentru fiecare jucător, iar alegerea este salvată.”

Întrebări

Câte linii poate avea o bară laterală?

Se afișează 15 linii. Conținutul mai lung are nevoie de alt loc, de exemplu lista tab, bara de acțiune sau o bară de boss.

Funcționează pe 1.8?

Da, Scoreboard API există pe 1.8, dar lungimea textului pe linie este mai limitată acolo. Spune versiunea, ca pluginul să fie scris pentru ea.

De ce dispare scoreboard-ul meu?

De obicei alt plugin setează pe jucător propriul scoreboard după al tău. Elimină cealaltă bară laterală sau fă ca un singur plugin să arate totul.

Fă-ți bara laterală

Acest prompt se deschide gata de trimis:

“Un plugin de scoreboard în bara laterală pentru Paper 1.21.4, numit Board: bară laterală per jucător cu titlu auriu, rangul din LuckPerms, monedele din Vault, kill-urile, morțile, jucătorii online și adresa serverului, actualizată în fiecare secundă fără pâlpâire, numerele roșii ascunse, liniile și intervalul în config.yml cu suport PlaceholderAPI, /board toggle salvat per jucător.”

Generează asta cu Codexe
Cum faci un plugin de scoreboard pentru Minecraft (sidebar) | Codexe