Guida

Come creare un plugin scoreboard per Minecraft

Aggiornato il 18 ottobre 2026

La sidebar sulla destra dello schermo è la parte più visibile di molti server: nome del server, grado del giocatore, soldi, uccisioni, giocatori online. Un plugin la disegna tramite la Scoreboard API di Bukkit. Le parti difficili sono dare a ogni giocatore le sue righe e aggiornarle in modo fluido.

Adatta le righe al tuo server.

Generalo con Codexe

Passo per passo

  1. 1.Scrivi le righe

    Il titolo e ogni riga dall'alto in basso, con i valori che mostrano: "Grado: Admin", "Monete: 1.250", "Online: 34". La sidebar mostra al massimo 15 righe.

  2. 2.Dai una scoreboard a ogni giocatore

    Le righe diverse per ogni giocatore richiedono una scoreboard per giocatore, creata con Bukkit.getScoreboardManager().getNewScoreboard() e assegnata con player.setScoreboard(...) all'ingresso.

  3. 3.Crea l'obiettivo della sidebar

    Registra un obiettivo dummy e imposta il suo slot di visualizzazione su DisplaySlot.SIDEBAR. Ogni riga è una voce con un punteggio che ne decide la posizione.

  4. 4.Aggiorna i valori

    Un task ripetuto, per esempio ogni secondo, aggiorna solo le righe cambiate. Usa prefissi e suffissi dei team per il testo, così le righe non sfarfallano.

  5. 5.Aggiungi i placeholder

    Con PlaceholderAPI, righe come %vault_eco_balance% mostrano valori di altri plugin senza codice in più.

  6. 6.Compila e guardala in gioco

    Lascia che Codexe la compili, entra nel server di prova e controlla ogni riga, poi cambia un valore e guardalo aggiornarsi.

Come funziona la sidebar

  • In ogni scoreboard la sidebar mostra un solo obiettivo alla volta. Il suo nome visualizzato è il titolo.
  • Le righe sono ordinate per punteggio, dal più alto, quindi il punteggio è solo il numero di riga al contrario.
  • Ogni riga deve essere una voce diversa: due righe identiche hanno bisogno di una differenza invisibile, come codici colore diversi.
  • I numeri rossi a destra si possono nascondere da Minecraft 1.20.3, che ha aggiunto i formati numerici per i punteggi. Le versioni più vecchie li mostrano sempre.
  • Un giocatore vede una sola scoreboard: se un altro plugin imposta la sua, vince l'ultima. Usa un solo plugin per la sidebar, oppure scrivi quali altri plugin condividono la scoreboard.

Aggiornare senza sfarfallio

Togliere una riga e aggiungerne una nuova la fa lampeggiare. La soluzione classica è dare a ogni riga una voce fissa e invisibile e mettere il testo visibile nel prefisso e nel suffisso di un team che contiene quella voce; aggiornando il team il testo cambia sul posto. Chiedi "senza sfarfallio" nella richiesta e il plugin viene scritto così.

Plugin, Skript o datapack?

OpzioneCosa può fareLimite
PluginRighe per giocatore, qualsiasi valore, animazioni, placeholderServe Spigot, Paper o un fork
Skript con SkBeeSidebar per giocatore da uno scriptServono Skript e l'addon
DatapackMostrare nella sidebar un obiettivo, come morti o uccisioniStessi numeri per tutti, niente testo libero per giocatore

Esempio di descrizione

"Un plugin per Paper 1.21.4 chiamato Board. Una sidebar per ogni giocatore con il titolo in oro, poi grado (da LuckPerms), monete (da Vault), uccisioni, morti, giocatori online e indirizzo del server. Aggiornata ogni secondo senza sfarfallio, numeri rossi nascosti. Righe, titolo e intervallo di aggiornamento in config.yml, con i placeholder di PlaceholderAPI permessi in qualsiasi riga. /board toggle la nasconde per il singolo giocatore e la scelta viene salvata."

Domande

Quante righe può avere una sidebar?

Se ne vedono 15. Per contenuti più lunghi serve un altro posto, come la tab list, la action bar o una boss bar.

Funziona sulla 1.8?

Sì, la Scoreboard API esiste sulla 1.8, ma lì la lunghezza del testo per riga è più limitata. Scrivi la versione così il plugin viene scritto per quella.

Perché la mia scoreboard sparisce?

Di solito un altro plugin imposta la sua scoreboard sul giocatore dopo la tua. Togli l'altra sidebar, oppure fai mostrare tutto a un solo plugin.

Crea la tua sidebar

Questo prompt si apre pronto da inviare:

“Un plugin scoreboard laterale per Paper 1.21.4 chiamato Board: sidebar per giocatore con titolo in oro, grado da LuckPerms, monete da Vault, uccisioni, morti, giocatori online e indirizzo del server, aggiornata ogni secondo senza sfarfallio, numeri rossi nascosti, righe e intervallo in config.yml con supporto a PlaceholderAPI, /board toggle salvato per giocatore.”

Generalo con Codexe
Come creare un plugin scoreboard per Minecraft (sidebar) | Codexe