NoteBlockAPI (Folia)

插件

· 作者 Tiancuo

一个用于向玩家播放 .nbs 音符盒歌曲的开发 API——已移植至 Folia,同时保持与经典 Paper 的兼容性。

0 本站下载 0 关注 更新于 3 个月前

最新 1.7.0-folia · 26.2 · Folia / Paper

一键开服(送7天)

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),继承自原项目。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源