ArdaMusic

ArdaMusic

基于区域的 Minecraft 服务器音乐模组。你可以用 ArdaRegions 定义区域，在 ArdaMusic 中分配曲目，当玩家走动时背景音乐会随之切换。

同时支持服务器和客户端——所有需要听到音乐的玩家都必须安装本模组（及 ArdaRegions）。

功能

区域音乐

ArdaRegions 告知 ArdaMusic 你所在的区域。每个区域你可以选择曲目、设置优先级（首次进入时播放的曲目），并调整随机播放曲目之间的淡入/淡出/间隔。

后备音乐

在任何区域之外，可以播放后备播放列表。可以是全局统一列表，或者每个世界使用不同列表。

菜单音乐

在主菜单、服务器列表、连接中和加载时可播放可选的曲目——通过面板设置，从本地库读取。

曲库

曲目是 config/arda-music/library/ 目录下的 .ogg 文件。播放由客户端进行；ArdaMusic 运行时将关闭原版音乐。

曲目信息

/ardamusic info 切换一个小型覆盖显示，曲目开始时显示标题和作曲者。管理员在面板中编辑作者信息，这些信息存储在服务器上。

音量

管理员可以在面板中为每个曲目设置音量（0–200%）。设置会同步到客户端。

需求

• Minecraft 1.20.1
• Fabric Loader
• Fabric API
• Fabric Permissions
• ArdaRegions

可选

• LuckPerms

安装

1. 在服务器上安装

• 将 ArdaRegions、Fabric API 和 ArdaMusic 放入 mods/ 文件夹
• 启动一次——配置文件将在 config/arda-music/ 下生成

2. 在客户端上安装

• 客户端安装相同的模组，使用与服务器相同的 ArdaMusic jar 文件

3. 音乐文件

将 .ogg 文件放入每个客户端的 config/arda-music/library/ 目录。支持子文件夹；曲目名称为 library/ 下的路径（例如 ambient/CloudsAndRainTrack.ogg）。

4. 配置连接

• 首先在 ArdaRegions 中设置区域
• 给自己 op 权限或授予 ardamusic.admin 权限（见下文）
• /ardamusic panel —— 选择一个区域，添加曲目、优先级、淡入淡出
• 设置（齿轮图标）—— 后备列表、菜单曲目、每个世界的后备列表
• 作者/音量按钮 —— 元数据和音量级别

服务器会保存 music-config.json，并在玩家连接时或你在面板中保存时向客户端推送更改。

5. 权限

默认情况下，2 级以上的管理员可以使用面板。如果使用 LuckPerms（或其他支持 Fabric Permissions 的权限插件），将 ardamusic.admin 权限分配给需要编辑音乐的人。

命令

• /ardamusic panel —— 打开音乐编辑器（管理员）
• /ardamusic skip —— 跳到下一曲
• /ardamusic info —— 切换标题/作曲者覆盖显示

文件

• 曲库: config/arda-music/library/
• 配置: config/arda-music/music-config.json
• 作者信息: config/arda-music/music-credits.json
• 音量: config/arda-music/music-volumes.json

致谢

感谢所有提供帮助的人：

• Fornad 进行 Beta 测试
• Dain 进行 Beta 测试
• Xone 提供纹理
• ArdaCraft 团队