SimpleScoreboard

ConfigurableScoreboard Plugin 🎮

Fully customizable scoreboard plugin for Minecraft 1.21+ with real-time statistics and performance monitoring.

✨ Features

Player Statistics

• ❤️ Health & Hunger tracking
• ✨ Experience level & progress
• 📍 Real-time coordinates
• 🌍 World information
• 🌐 Player ping display

Server Monitoring

• ⚙️ Smart TPS Display - Automatic color coding:
  • 🟢 Green (≥19.0) - Excellent
  • 🟡 Yellow (≥17.0) - Good
  • 🟠 Orange (≥15.0) - Moderate
  • 🔴 Red (<15.0) - Poor
• 👥 Online player count
• 🕐 Real-time clock & date

Customization

• 🎨 Full color code support (&a, &c, etc.)
• 📝 20+ dynamic placeholders
• ⚡ Configurable update interval
• 🎯 Multiple pre-made designs included
• 💫 Unicode & emoji support

Technical

• Low resource usage with optimized tick scheduling
• Per-player scoreboard toggle
• Auto-enable for new players
• Vault integration for economy (optional)
• Async TPS calculation

📋 Placeholders

---

Placeholder	Description
{player}	Player name
{hp} / {max_hp}	Health points
{food}	Hunger level
{level} / {exp}	XP level and progress
{ping}	Player ping (ms)
{tps}	Server TPS
{tps_color}	Auto TPS color
{online} / {max_online}	Player count
{world}	World name
{x} {y} {z}	Coordinates
{time} / {date}	Current time/date
{money}	Balance (Vault)
{rank}	Player rank

🎮 Commands

• /sb - Show help
• /sb toggle - Enable/disable scoreboard
• /sb reload - Reload config (requires scoreboard.reload)

🎨 Color Codes

Use & for colors and formatting:

• &0-9, a-f - Colors
• &l - Bold
• &m - Strikethrough
• &n - Underline
• &o - Italic
• &r - Reset

💡 Quick Tips

Performance: Set update-interval: 40 (2 seconds) for large servers

Design: Use empty lines "" for spacing, combine codes like &b&lBold Aqua

Creative: Use &m with spaces for lines: &7&m----, or Unicode boxes: ┌─┐│└┘

TPS Colors: Use {tps_color}{tps} for automatic performance indication

🔧 Configuration

Simple YAML setup in config.yml:

• Customize title, lines, and colors
• Adjust update frequency
• Enable/disable auto-start
• Create unlimited custom designs

🔌 Integrations

• Vault - Display player economy balance
• Permission Plugins - Show player ranks (LuckPerms, PermissionsEx, etc.)

📊 Technical Highlights

• Rolling average TPS calculation over 20 ticks
• HashMap-based player tracking with auto cleanup
• Bukkit Scoreboard API with custom wrappers
• Thread-safe async operations
• Supports Paper & Spigot

🆘 Troubleshooting

Not showing? - Check /sb toggle or auto-enable: true in config

No colors? - Use & not §, check YAML formatting (spaces, not tabs)

Placeholders broken? - Verify spelling, reload with /sb reload

---

Version: 2.0 | MC: 1.21+ | Java: 21+