DiscX

DiscX

向Minecraft中添加自定义音乐唱片。

DiscX 是一款 Minecraft 模组,让你无需编写 Java 代码即可添加自定义音乐唱片。

DiscX 专为服务器所有者、整合包作者以及希望对自己的音乐拥有更多掌控的玩家而设计,只需使用一个简单的文件夹、一个小型 JSON 文件以及一条 MIDI 或 ABC 音轨,即可创建新唱片。添加可选的定制纹理,重新加载 DiscX,模组便会生成客户端听到和看到自定义唱片所需的资源包。

功能特性

  • 使用简单的 JSON 文件定义自定义音乐唱片
  • 支持 MIDI 和 ABC 音轨
  • 兼容原版点唱机
  • 自定义唱片标题和艺术家文本
  • 可选的自定义唱片纹理
  • 自动检测 MIDI 文件时长
  • 生成的资源包压缩文件
  • DiscX 创造模式选项卡
  • 支持多人游戏和专用服务器
  • 提供用于重新加载、验证、列出、检查、导出示例和给予唱片的命令

如何添加唱片

在以下路径内创建一个文件夹:

config/discx/discs/

文件夹结构示例:

config/discx/discs/my_custom_disc/
  disc.json
  song.mid
  disc.png

你也可以使用 song.midi 或 song.abc 代替 song.mid。

disc.png 是可选的。如果未包含自定义纹理,DiscX 将使用其默认唱片纹理。

disc.json 示例:

{
  "id": "my_custom_disc",
  "title": "My Custom Disc",
  "artist": "Artist Name"
}

对于 ABC 文件,请在 disc.json 中添加 duration_seconds,以便 DiscX 了解音轨应播放多长时间。

添加文件后,运行:

/discx reload

DiscX 将生成:

config/discx/generated_pack/discx_resourcepack.zip

多人游戏设置

对于多人游戏服务器:

  1. 在服务器上安装 DiscX。
  2. 在每个将听到自定义唱片的客户端上安装 DiscX。
  3. 将 discx_resourcepack.zip 提供给玩家,或将其托管为服务器资源包。
  4. 添加或更改唱片后运行 /discx reload。
  5. 如有需要,在添加全新唱片后重启服务器。

无需进行数据包设置。

命令

/discx reload
/discx list
/discx give <player> <disc> [amount]
/discx info <disc>
/discx validate
/discx export-example

给予命令示例:

/discx give <player> discx:my_custom_disc 1

重要版权声明

DiscX 不包含受版权保护的音乐或原始音频录音。

MIDI 和 ABC 文件并非原始音频录音,但歌曲、旋律、乐曲和编排仍可能受版权保护。请仅分发您自己创作的曲目、属于公有领域的曲目或您有权使用的曲目。