Οδηγός

Πώς να φτιάξεις ένα plugin scoreboard για Minecraft

Ενημερώθηκε 18 Οκτωβρίου 2026

Το sidebar στα δεξιά της οθόνης είναι το πιο ορατό κομμάτι πολλών servers: το όνομα του server, το rank του παίκτη, χρήματα, kills, παίκτες online. Ένα plugin το σχεδιάζει μέσω του Scoreboard API του Bukkit. Τα δύσκολα κομμάτια είναι να έχει κάθε παίκτης τις δικές του γραμμές και να ενημερώνονται ομαλά.

Άλλαξε τις γραμμές για τον server σου.

Φτιάξ' το με το Codexe

Βήμα βήμα

  1. 1.Γράψε τις γραμμές

    Τον τίτλο και κάθε γραμμή από πάνω προς τα κάτω, με τις τιμές που δείχνουν: «Rank: Admin», «Coins: 1,250», «Online: 34». Το sidebar δείχνει έως 15 γραμμές.

  2. 2.Δώσε σε κάθε παίκτη ένα scoreboard

    Οι γραμμές που διαφέρουν ανά παίκτη χρειάζονται ένα scoreboard ανά παίκτη, από το Bukkit.getScoreboardManager().getNewScoreboard(), που ορίζεται με player.setScoreboard(...) κατά την είσοδο.

  3. 3.Δημιούργησε το objective του sidebar

    Κατάχωρισε ένα dummy objective και όρισε το display slot του σε DisplaySlot.SIDEBAR. Κάθε γραμμή είναι ένα entry με ένα score που ορίζει τη θέση της.

  4. 4.Ενημέρωσε τις τιμές

    Ένα επαναλαμβανόμενο task, για παράδειγμα κάθε δευτερόλεπτο, ενημερώνει μόνο τις γραμμές που άλλαξαν. Χρησιμοποίησε prefixes και suffixes ομάδων για το κείμενο ώστε οι γραμμές να μην τρεμοπαίζουν.

  5. 5.Πρόσθεσε placeholders

    Με το PlaceholderAPI, γραμμές όπως %vault_eco_balance% δείχνουν τιμές από άλλα plugins χωρίς επιπλέον κώδικα.

  6. 6.Κάνε build και δες το στο παιχνίδι

    Άφησε το Codexe να το κάνει compile, μπες στον δοκιμαστικό server και έλεγξε κάθε γραμμή, μετά άλλαξε μια τιμή και δες την να ενημερώνεται.

Πώς λειτουργεί το sidebar

  • Σε κάθε scoreboard εμφανίζεται ένα objective τη φορά στο sidebar. Το εμφανιζόμενο όνομά του είναι ο τίτλος.
  • Οι γραμμές ταξινομούνται κατά score, το μεγαλύτερο πρώτο, οπότε το score είναι απλώς ο αριθμός της γραμμής ανάποδα.
  • Κάθε γραμμή πρέπει να είναι διαφορετικό entry: δύο ίδιες γραμμές χρειάζονται μια αόρατη διαφορά, όπως διαφορετικούς κωδικούς χρώματος.
  • Οι κόκκινοι αριθμοί στα δεξιά μπορούν να κρυφτούν από το Minecraft 1.20.3, που πρόσθεσε μορφές αριθμών για τα scores. Οι παλιότερες εκδόσεις τους δείχνουν πάντα.
  • Ένας παίκτης βλέπει ένα scoreboard: αν ένα άλλο plugin ορίσει το δικό του, κερδίζει το τελευταίο. Χρησιμοποίησε ένα plugin για το sidebar ή γράψε ποια άλλα plugins μοιράζονται το scoreboard.

Ενημέρωση χωρίς τρεμόπαιγμα

Αν αφαιρείς μια γραμμή και προσθέτεις μια νέα, αναβοσβήνει. Η συνηθισμένη λύση είναι να δώσεις σε κάθε γραμμή ένα σταθερό, αόρατο entry και να βάλεις το ορατό κείμενο στο prefix και στο suffix μιας ομάδας που περιέχει αυτό το entry· η ενημέρωση της ομάδας αλλάζει το κείμενο επί τόπου. Ζήτα «χωρίς τρεμόπαιγμα» στο αίτημα και το plugin γράφεται με αυτόν τον τρόπο.

Plugin, Skript ή datapack;

ΕπιλογήΤι μπορεί να κάνειΌριο
PluginΓραμμές ανά παίκτη, οποιαδήποτε τιμή, animations, placeholdersΧρειάζεται Spigot, Paper ή κάποιο fork
Skript με SkBeeSidebars ανά παίκτη από ένα scriptΧρειάζεται το Skript και το add-on
DatapackΔείχνει ένα objective, όπως θανάτους ή kills, στο sidebarΊδιοι αριθμοί για όλους, χωρίς ελεύθερο κείμενο ανά παίκτη

Παράδειγμα περιγραφής

«Ένα plugin για Paper 1.21.4 με το όνομα Board. Ένα sidebar για κάθε παίκτη με τον τίτλο σε χρυσό, και μετά rank (από το LuckPerms), coins (από το Vault), kills, θανάτους, παίκτες online και τη διεύθυνση του server. Ενημερώνεται κάθε δευτερόλεπτο χωρίς τρεμόπαιγμα, με κρυμμένους τους κόκκινους αριθμούς. Γραμμές, τίτλος και διάστημα ενημέρωσης στο config.yml, με placeholders του PlaceholderAPI σε οποιαδήποτε γραμμή. Το /board toggle το κρύβει για κάθε παίκτη και η επιλογή αποθηκεύεται.»

Ερωτήσεις

Πόσες γραμμές μπορεί να έχει ένα sidebar;

Εμφανίζονται 15 γραμμές. Για περισσότερο περιεχόμενο χρειάζεται άλλο σημείο, όπως η tab list, το action bar ή ένα boss bar.

Λειτουργεί στην 1.8;

Ναι, το Scoreboard API υπάρχει στην 1.8, αλλά εκεί το μήκος κειμένου ανά γραμμή είναι πιο περιορισμένο. Γράψε την έκδοση ώστε το plugin να γραφτεί γι' αυτήν.

Γιατί εξαφανίζεται το scoreboard μου;

Συνήθως ένα άλλο plugin ορίζει το δικό του scoreboard στον παίκτη μετά από το δικό σου. Αφαίρεσε το άλλο sidebar ή βάλε ένα plugin να δείχνει τα πάντα.

Φτιάξε το sidebar σου

Αυτό το prompt ανοίγει έτοιμο για αποστολή:

“Ένα plugin sidebar scoreboard για Paper 1.21.4 με το όνομα Board: sidebar ανά παίκτη με χρυσό τίτλο, rank από το LuckPerms, coins από το Vault, kills, θάνατοι, παίκτες online και η διεύθυνση του server, ενημέρωση κάθε δευτερόλεπτο χωρίς τρεμόπαιγμα, κρυμμένοι κόκκινοι αριθμοί, γραμμές και διάστημα στο config.yml με υποστήριξη PlaceholderAPI, /board toggle αποθηκευμένο ανά παίκτη.”

Φτιάξ' το με το Codexe
Πώς να φτιάξεις ένα plugin scoreboard για Minecraft (sidebar) | Codexe