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 即表示你确认自己拥有加载到该模组中的任何音频内容所需的必要权利。
Audiolayer is a NeoForge mod for Minecraft 1.21.1 that lets you load your own MP3 files from a local folder and play them in-game under the audiolayer namespace. It also includes built-in KubeJS support for client-side scripting, plus ready-to-use examples for modpack and gameplay integration.
Features
- Load custom MP3 files from
config/audiolayer/input/
- Stream MP3 directly without converting everything to OGG first
- Stable sound IDs based on folder structure
- In-game commands to list, play, stop, and reload sounds
- Server-compatible sound playback routed to the client
- Built-in KubeJS support for client scripts
- Simple Java API for other mods to integrate with Audiolayer
- Runtime resource pack generated automatically
How it works
Place MP3 files into:
config/audiolayer/input/
Folder names become part of the sound ID. For example:
music/theme.mp3 -> audiolayer:music.theme
ui/confirm.mp3 -> audiolayer:ui.confirm
Use /audiolayer list to see loaded sounds, /audiolayer play <sound_id> to play one, and /audiolayer reload to rescan the folder.
KubeJS Support
Audiolayer includes a built-in KubeJS plugin. When KubeJS is installed, you can control Audiolayer from client scripts without extra setup.
Modpack Use
Modpack authors may freely include Audiolayer in their modpacks.
Notes
Audiolayer is designed for local audio files only. Every player who wants to hear Audiolayer sounds needs the mod and the same audio files locally. KubeJS support works from client scripts only.
Copyright and Audio Responsibility
Audiolayer is a playback tool and does not grant any rights to audio content.
Modpack authors, mod authors, and end users are responsible for ensuring that any audio files they use, bundle, or distribute through Audiolayer are properly licensed or otherwise legally permitted for their intended use.
By using Audiolayer, you confirm that you have the necessary rights to any audio content you load into the mod.
评论 0
登录后参与评分
还没有评论,来抢沙发吧