Certain tasks are impossible to perform with the standard Bukkit API and may require working with and even modifying Minecraft directly. A common method is to modify incoming and outgoing packets or add custom packets. However, this can be quite complicated, especially for beginners. It also requires regular maintenance, as updates to Minecraft particularly due to code obfuscation can easily break these implementations.

VelaBoard gives Spigot plugin developers a clean, flexible API for managing Minecraft scoreboards. Whether you need a per-player HUD sidebar, a shared scoreboard displayed to an entire server, or full team management with colors and collision rules — VelaBoard handles it with minimal boilerplate.

For server operators

For developers

✨ Features

• ⚡ Simple & Clean API — Minimal code, maximum control
• 👤 Player Sidebars — Individual scoreboards per player with live updates
• 👥 Shared Sidebars — One scoreboard displayed to multiple players
• 🧠 Team System — Prefix, suffix, colors, visibility, and collision rules
• 🎮 Entity Support — Add both players and entities to teams
• 🔥 Flexible Damage Control — Enable/disable friendly fire for:
  • Player ↔ Player damage
  • Player ↔ Entity damage
  • Entity ↔ Entity damage
• 📡 Event-Driven Architecture — Listen to team and scoreboard changes
• 🔄 Automatic Player Handling — Built-in join/quit event management
• 🎯 Version Support — Currently Compatible with Minecraft 1.20-1.21.11
• 📦 Lightweight & Zero Dependencies — Only Bukkit API (except JetBrains annotations)

⚠️ Examples

• Coordinates Sidebar
• Comming Soon

⚠️ Requirements

• Minecraft: 1.20-1.21.11
• Java: 17

📥 Installation

Maven

<dependency>
    <groupId>io.github.velahere</groupId>
    <artifactId>velaboard</artifactId>
    <version>1.0.1</version>
    <scope>provided</scope>
</dependency>

Gradle

dependencies {
    compileOnly 'io.github.velahere:velaboard:1.0.1'
}

📚 Documentation

| Document | Purpose |
|--------------------------|-------------------------------------------|
| Getting Started | Setup instructions and core concepts |
| API Reference | Complete method documentation |
| Examples | Real-world usage examples |

🔗 Links

| Resource | Status |
|-----------------------------|-----------------------------------------------------|
| 📦 Maven Central Repository | Link |
| 📚 Full Documentation | Link |
| 🎨 Spigot Resource Page | Coming Soon |
| 💬 Discord Community | Link |

🛠 Support

Before reporting bugs:

• Update to latest version
• Check docs/FAQ
• Include server version + plugin version + full error logs
• Need help? Open an issue on GitHub 🎯