? Velaboard,一个记分板 API:
一款功能强大、轻量级且易于使用的 Bukkit/Spigot 服务器记分板与团队管理 API。
使用最少的代码构建精美的记分板,管理团队,并控制游戏内交互。
文档 • Discord 社区
某些任务无法通过标准的 Bukkit API 完成,可能需要直接操作甚至修改 Minecraft。常见的方法是修改传入和传出的数据包(packets)或添加自定义数据包。然而,这相当复杂,尤其是对初学者而言。它还需要定期维护,因为 Minecraft 的更新(特别是由于代码混淆导致的更改)很容易破坏这些实现。
VelaBoard 为 Spigot 插件开发者提供了一个干净、灵活的 API 来管理 Minecraft 记分板。无论你需要的是针对单个玩家的 HUD 侧边栏、向整个服务器显示共享记分板,还是包含颜色和碰撞规则的全功能团队管理——VelaBoard 都能以极少的样板代码处理这一切。
对于服务器管理员
只需从上方下载 Velaboard。它本身没有任何功能,仅允许其他插件正常工作。
对于开发者
这里有文档、API 参考和示例——请查阅它们以清楚了解所有工作原理。
❤️ 支持该项目
喜欢这个资源包吗?您的支持有助于资助未来的更新、新功能、错误修复,
以及更多 Minecraft 项目的开发。每一份贡献都让这项工作得以延续和成长。
? 支付方式
- PayPal — 支持借记卡/信用卡和Apple Pay。
- Ko‑fi — 快速便捷的捐赠。
此按钮将安全地重定向到您托管在 GitHub Pages 上的官方支持页面,100% 安全。
✨ 特性
- ⚡ 简洁干净的 API — 代码极简,掌控力极强
- ? 玩家侧边栏 — 每个玩家独立的记分板,实时同步更新
- ? 共享侧边栏 — 一个记分板展示给多个玩家
- ? 团队系统 — 前缀、后缀、颜色、可见性及碰撞规则
- ? 实体支持 — 可将玩家和实体加入团队
- ? 灵活的伤害控制 — 启用/禁用友军伤害,适用于:
- 玩家 ↔ 玩家伤害
- 玩家 ↔ 实体伤害
- 实体 ↔ 实体伤害
- ? 事件驱动架构 — 监听团队和记分板的变更
- ? 自动玩家处理 — 内置加入/离开事件管理
- ? 版本支持 — 目前兼容 Minecraft 1.20-1.21.11
- ? 轻量级且零依赖 — 仅依赖 Bukkit API(JetBrains 注解除外)
⚠️ 示例
⚠️ 要求
- Minecraft: 1.20-1.21.11
- Java: 17
? 安装
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'
}
? 文档
? 链接
| 资源 |
状态 |
| ? Maven Central 仓库 |
链接 |
| ? 完整文档 |
链接 |
| ? Spigot 资源页 |
即将推出 |
| ? Discord 社区 |
? 支持
在报告错误之前:
❓ 常见问题
问:我添加了依赖项但不起作用!
答:确保您的服务器上已安装 Velaboard 插件。
问:调用 API 时出现 NullPointerException?
答:使用 /plugins 命令验证插件是否正在运行。
问:记分板未显示?
答:确保在设置后调用了 sidebar.show()。
⬆ 回到顶部
为 Minecraft 服务器 ❤️ 打造
如果你觉得这很有用,请给它一个 ⭐!
? 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.
Documentation • Discord Community
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
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
⚠️ 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
? Links
| Resource |
Status |
| ? Maven Central Repository |
Link |
| ? Full Documentation |
Link |
| ? Spigot Resource Page |
Coming Soon |
| ? Discord Community |
? 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.
⬆ Back to Top
Made with ❤️ for Minecraft servers
If you find this helpful, please give it a ⭐!
评论 0
登录后参与评分
还没有评论,来抢沙发吧