NoteBlockAPI (Folia)
用于向玩家播放 .nbs 音符盒曲目的开发者 API —— 移植至 Folia,同时保持与经典 Paper 的兼容性。
本仓库是 koca2000/NoteBlockAPI 的一个兼容 Folia 的分支版本。
此分支包含的功能
- Folia 支持:提供
FoliaCompat调度器桥接,透明地将所有 Bukkit 调度器调用路由到 Folia 的全局 / 区域 / 异步 / 实体调度器(在普通 Paper 上回退到经典调度器)。 - 线程安全播放:曲目播放从共享的异步线程池移至 受追踪的专用线程;
playTick在 每个监听者所在的区域线程 上分发,避免跨区域实体/方块访问违规。 - 感知区域的的事件:
SongEnd、SongStopped等事件在 曲目的所在区域 触发(区块玩家对应区块区域,实体玩家对应实体区域),以便下游插件安全地操作相关的方块/实体。 - 清晰的启用/禁用逻辑:移除了会在 Folia 上抛出
UnsupportedOperationException的BukkitScheduler.cancelTasks/getActiveWorkers调用,替换为显式取消和线程中断。 - 依赖项更新:目标 Java 版本为 21,Paper API 1.21.1,
plugin.yml中标记folia-supported: true。
要求
| 组件 | 版本 |
|---|---|
| 服务器 | Folia 26.x(或 Paper 1.21+) |
| Java | 21+ |
构建
mvn clean install
产物:target/NoteBlockAPI-*-SNAPSHOT.jar(已整合 bstats)。install 命令还会将其发布到你本地的 Maven 仓库中,供下游插件如 MusicBox (Folia) 使用。
用法
在你的插件 plugin.yml 中声明 depend: [NoteBlockAPI],然后使用 SongPlayer API 来播放 .nbs 曲目。详情请参阅 Spigot 资源页面。
致谢与许可
- 原版作者:xxmicloxx 等人;分支作者:koca2000/NoteBlockAPI
- 许可证:LGPL v3(见 LICENSE),继承自原项目。
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
使床在所有维度中爆炸的模组
为 Armor Poser 模组添加兼容性
评论 0
登录后参与评分
还没有评论,来抢沙发吧