🎯 Velaboard, a Scoreboard API:
A powerful, lightweight, and easy-to-use Scoreboard & Team management API for Bukkit/Spigot servers.
Build stunning scoreboards, manage teams, and control gameplay interactions with minimal code.
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
❤️ Support the Project
Enjoying this resource pack? Your support helps fund future updates, new features, bug fixes, and the development of more Minecraft projects. Every contribution keeps the work alive and growing.
💳 Payment Options
- PayPal — supports debit/credit cards and Apple Pay.
- Ko‑fi — quick and easy donations.
This button will safely redirect you to my official support page hosted on GitHub Pages, which is 100% safe.
✨ 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 🎯
❓ Common Issues
Q: I added the dependency but it doesn't work!
A: Make sure the Velaboard plugin is installed on your server.
Q: NullPointerException when calling the API?
A: Verify the plugin is running using /plugins.
Q: Scoreboards not displaying?
A: Ensure you called sidebar.show() after setup.
