# 🎯 Velaboard, a Scoreboard API: [![Maven Central](https://img.shields.io/maven-central/v/io.github.velahere/velaboard?label=Maven%20Central)](https://central.sonatype.com/artifact/io.github.velahere/velaboard) [![License: ARR](https://img.shields.io/badge/License-ARR-yellow.svg)](https://velahere.github.io/velaHere.arr-license/) [![Minecraft](https://img.shields.io/badge/Minecraft-1.20--1.21.11-brightgreen)](https://www.minecraft.net/) [![GitHub](https://img.shields.io/badge/GitHub-velaHere-blue?logo=github)](https://github.com/velaHere) [![Java](https://img.shields.io/badge/Java-17-orange)](https://www.java.com/) **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. [Documentation](https://velas.mintlify.app/introduction) • [Discord Community](https://discord.gg/2C63RDgVAn)

--- 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

Just download Velaboard from above. It doesn't do anything on its own, it simply allows other plugins to function.

### For developers

Here are the documentation, API references, and examples—please review them to get a clear understanding of how everything works.

--- ## ❤️ Support the Project - **If this plugin helped you, ⭐ Star the project: [GITHUB](https://github.com/velaHere/velaboard). --- ## ✨ 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](https://modrinth.com/plugin/coordinates-sidebar)** - **Comming Soon** --- ## ⚠️ Requirements - Minecraft: 1.20-1.21.11 - Java: 17 --- ## 📥 Installation ### Maven ```xml io.github.velahere velaboard 1.0.1 provided ``` ### Gradle ```gradle dependencies { compileOnly 'io.github.velahere:velaboard:1.0.1' } ``` --- ## 📚 Documentation | Document | Purpose | |--------------------------|-------------------------------------------| | [**Getting Started**](https://velas.mintlify.app/) | Setup instructions and core concepts | | [**API Reference**](https://velas.mintlify.app/api/scoreboard-api) | Complete method documentation | | [**Examples**](https://velas.mintlify.app/coordinates-sidebar-plugin) | Real-world usage examples | --- ## 🔗 Links | Resource | Status | |-----------------------------|-----------------------------------------------------| | 📦 Maven Central Repository | [**Link**](https://central.sonatype.com/artifact/io.github.velahere/velaboard/overview) | | 📚 Full Documentation | [**Link**](https://velas.mintlify.app/introduction) | | 🎨 Spigot Resource Page | Coming Soon | | 💬 Discord Community | [**Link**](https://discord.gg/2C63RDgVAn) | --- ## 🛠 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](https://github.com/velaHere/velaboard/issues) 🎯

❓ 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.

---

[⬆ Back to Top](#top) Made with ❤️ for Minecraft servers If you find this helpful, please give it a ⭐!

Velaboard

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details

Velaboard

Coordinates Sidebar