PerfectScoreboard
Customizable HUD scoreboard with profiles, dynamic placeholders, animations, custom logo, 5 screen positions, per-world configs, and a full admin UI.
| Version | 1.0 |
|---|---|
| Platform | Hytale Server Plugin |
| Java | 21+ |
| Dependencies | None |
| Price | Free |
Installation
- Drop
PerfectScoreboard-1.0.jarinmods/ - Start the server -- scoreboard appears automatically on join
- Use
/sb adminto customize
HUD Display
The scoreboard displays on every player's screen with:
- Custom logo at the top (optional, 240x60 PNG)
- Title with color codes
- Up to 15 lines with color codes and dynamic placeholders
- Footer text
- Semi-transparent background
Players can toggle visibility with /sb.
Dynamic Placeholders
Updated every second:
| Placeholder | Value |
|---|---|
{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 placeholders: /sb setplaceholder kills 42 then use {kills} in any line.
Profiles
Create different scoreboard layouts for different contexts. Each profile has its own title, lines, footer, animation, position, and logo setting.
- Per-world: assign a profile to a world with
/sb setworld <world> <profile> - Switch on the fly:
/sb profile <name> - Create/delete:
/sb create <name>//sb delete <name>
Animations
4 modes per profile, selectable in admin UI:
| Mode | Effect |
|---|---|
| None | Static text |
| Rainbow | Color wave cycling through lines |
| Scroll | Scrolling text for long lines |
| Flash | Pulsing color effect |
Screen Positions
5 positions, configurable per profile:
- Top-Right (default)
- Top-Left
- Bottom-Right
- Bottom-Left
- Center-Right
Position change takes effect on next /sb show or reconnect.
Custom Logo
- Create a PNG image (recommended: 240x60 pixels)
- Open the PerfectScoreboard JAR with any zip tool
- Replace
Common/UI/Custom/Textures/PerfectScoreboard/logo.png - Save and restart the server
- Toggle ON/OFF per profile in
/sb admin
Admin UI (/sb admin)
- Profile list on the left -- select or create profiles
- Title & footer text fields
- Line editor -- click any line to edit, add or remove lines
- Animation selector -- cycle through 4 modes
- Logo toggle -- ON/OFF
- Position selector -- cycle through 5 positions
- Logo file path displayed for reference
Commands
| Command | Description |
|---|---|
/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 setfooter <profile> <text> | Set footer |
/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 |
Configuration
File: UserData/Saves/MODDING/mods/KatsuyaTV_PerfectScoreboard/config.json
{
"lang": "EN",
"refreshMs": 1000,
"defaultProfile": "default",
"showOnJoin": true,
"worldProfiles": {}
}FAQ
Position change doesn't take effect?
Position is set at HUD creation time. Use /sb show or reconnect to reload with the new position.
How do I use color codes?
Use & codes in lines: &a = green, &c = red, &e = yellow, etc.
Can players hide the scoreboard?
Yes, /sb toggles visibility. Preference persists.