P E R F E C T SCOREBOARD
Customizable HUD scoreboard with profiles, placeholders & admin UI
// WHY PERFECTSCOREBOARD?
Display a beautiful HUD scoreboard on every player's screen. Fully configurable title, lines, footer with color codes and dynamic placeholders. Multiple profiles for different worlds, animations (rainbow, scroll, flash), custom logo, and 5 screen positions. Everything managed through a clean flat admin UI — no file editing needed.
// FEATURES
- HUD Scoreboard
Displays automatically when players join. Up to 15 configurable lines with color codes (&a, &b, &c...) and dynamic placeholders. Semi-transparent background, clean design. - Dynamic Placeholders
Built-in placeholders updated every second:
— {player} — Player name
— {online} — Online player count
— {world} — Current world name
— {time} — Server time (HH:mm)
— {date} — Server date
— {ping} — Player ping
— Plus unlimited custom placeholders via command - Multiple Profiles
Create different scoreboard layouts for different contexts:
— Assign profiles per world (lobby, SMP, PvP each get their own scoreboard)
— Switch profiles on the fly via command or admin UI
— Each profile has its own title, lines, footer, animation, position, and logo setting - Animations
4 animation modes per profile:
— None — Static text
— Rainbow — Color wave cycling through lines
— Scroll — Scrolling text for long lines
— Flash — Pulsing color effect - 5 Screen Positions
Choose where the scoreboard appears:
— Top-Right (default)
— Top-Left
— Bottom-Right
— Bottom-Left
— Center-Right
Configurable per profile via the admin UI. - Custom Logo
Display your server logo at the top of the scoreboard. Just place a PNG image in the plugin's texture folder. Toggle on/off per profile. - Full Admin UI
Open /sb admin:
— Profile list with create/select
— Title & footer text fields
— Line editor — click any line to edit, add or remove lines
— Animation selector — cycle through modes
— Logo toggle — ON/OFF
— Position selector — cycle through 5 positions
— Logo file path displayed for easy setup - Player Toggle
Players can show/hide the scoreboard with /sb. Preference persists across sessions. - Custom Placeholders
Set custom global placeholders via /sb setplaceholder kills 42. Use {kills} in any line. Perfect for integrating with other plugins. - Per-World Profiles
Assign different scoreboards to different worlds with /sb setworld. Players see the right scoreboard automatically when they change worlds.
// COMMANDS
| /sb | Toggle scoreboard visibility |
| /sb show | Show scoreboard |
| /sb hide | Hide scoreboard |
| /sb admin | Open admin panel |
| /sb list | List all profiles |
| /sb create <name> | Create new profile |
| /sb delete <name> | Delete profile |
| /sb settitle <profile> <text> | Set profile title |
| /sb setline <profile> <#> <text> | Edit a line |
| /sb addline <profile> <text> | Add a line |
| /sb removeline <profile> <#> | Remove a line |
| /sb setworld <world> <profile> | Assign profile to world |
| /sb profile <name> | Switch active profile |
| /sb setplaceholder <key> <value> | Set custom placeholder |
| /sb help | Show all commands |
// PLACEHOLDERS
| {player} | Player username |
| {online} | Online player count |
| {world} | Current world name |
| {time} | Server time (HH:mm) |
| {date} | Server date (yyyy-MM-dd) |
| {ping} | Player ping (ms) |
| {custom} | Any custom placeholder set via command |
// HOW TO ADD YOUR LOGO
1. Create a PNG image (recommended: 240x60 pixels)
2. Open the PerfectScoreboard JAR with any zip tool
3. Replace Common/UI/Custom/Textures/PerfectScoreboard/logo.png
4. Save and restart the server
5. Toggle the logo ON in /sb admin
// TECHNICAL DETAILS
- Platform: Hytale Server Plugin
- Java Version: 21
- Dependencies: None
- Data Storage: JSON (profiles, config)
- Performance: 1 update per second, lightweight scheduler
- HUD System: CustomUIHud with dynamic line rendering
// DOCUMENTATION
Full documentation and FAQ:
perfectplugins.github.io/wiki/perfectscoreboard
Developed by KatsuyaTV
Issues or feature requests? DM or discussion tab.
// LINKS
