音频层

音频层

从本地文件夹加载你自己的MP3文件,并在游戏内通过audiolayer命名空间播放它们。它还内置了对KubeJS客户端脚本的支持,并附带可直接使用的示例,用于整合包和玩法集成。

基础库

Audiolayer 是一个适用于 Minecraft 1.21.1 的 NeoForge 模组,允许你从本地文件夹加载自己的 MP3 文件,并在游戏内以 audiolayer 命名空间播放。它还内置了对 KubeJS 客户端脚本的支持,并提供了可直接使用的示例,用于整合包和玩法集成。

特性

  • 从 config/audiolayer/input/ 加载自定义 MP3 文件
  • 直接流式播放 MP3,无需先全部转换为 OGG
  • 基于文件夹结构的稳定声音 ID
  • 游戏内命令可列出、播放、停止和重新加载声音
  • 兼容服务端的声音播放,并路由到客户端
  • 内置 KubeJS 支持,用于客户端脚本
  • 提供简单的 Java API,供其他模组与 Audiolayer 集成
  • 自动生成运行时资源包

工作原理

将 MP3 文件放入:

config/audiolayer/input/

文件夹名称会成为声音 ID 的一部分。例如:

  • music/theme.mp3 -> audiolayer:music.theme
  • ui/confirm.mp3 -> audiolayer:ui.confirm

使用 /audiolayer list 查看已加载的声音,使用 /audiolayer play <sound_id> 播放其中一个,使用 /audiolayer reload 重新扫描文件夹。

KubeJS 支持

Audiolayer 包含内置的 KubeJS 插件。安装 KubeJS 后,你无需额外设置即可从客户端脚本控制 Audiolayer。

整合包使用

整合包作者可以自由地将 Audiolayer 包含在他们的整合包中。

注意事项

Audiolayer 仅面向本地音频文件设计。每位想要听到 Audiolayer 声音的玩家都需要安装该模组,并在本地拥有相同的音频文件。KubeJS 支持仅适用于客户端脚本。

版权与音频责任

Audiolayer 是一个播放工具,不授予任何音频内容的权利。

整合包作者、模组作者和最终用户有责任确保他们通过 Audiolayer 使用、捆绑或分发的任何音频文件已获得适当许可,或以其他方式合法允许用于其预期用途。

使用 Audiolayer 即表示你确认对加载到该模组中的任何音频内容拥有必要的权利。