Amethyst Music

Amethyst Music

为SMP服务器定制音乐：在唱片刻录机中将服务器专属歌曲写入唱片，再放进紫水晶唱片机播放，最多可存放18张唱片。基于Amethyst Lib构建。

自定义音乐唱片

• 服务器所有者可添加自己的歌曲：将.ogg文件放入config/amethyst/discs/，然后重启。每首歌曲都会显示在唱片刻录机的列表中，并以文件名命名。
• 制作一张空白唱片（黑色染料、铁锭和紫水晶碎片，摆放位置不限）。
• 制作一台唱片刻录机（顶部放3个紫水晶碎片；中间一排依次放铁锭、唱片机、铁锭；底部放3个铁锭）。
• 右键点击唱片刻录机，搜索或滚动浏览歌曲列表，选择一首歌曲，放入空白唱片并点击刻录。刻录需要消耗3级经验。
• 每首歌曲都会有专属标签颜色，方便区分唱片。
• 刻录好的唱片可在任意唱片机中播放，可与红石比较器配合使用，也适用于Sophisticated Backpacks和Sophisticated Storage的唱片机升级。
• 唱片一经刻录便无法更改，不能重新刻录，也不能使用原版唱片。
• 歌曲名称、颜色和经验消耗量可在config/amethyst/discs.json中修改。
• 玩家可通过AutoModpack获取歌曲文件（将/config/amethyst/discs/*.ogg添加到其同步文件中），也可以把相同的文件放进自己的config/amethyst/discs/文件夹。
• 歌曲应使用单声道Ogg Vorbis文件，这样听起来才像是从唱片机中播放的。
• 声音太大？每位玩家都可以在自己的config/amethyst/music.json中调低discSoundVolume（默认值为0.3）。

紫水晶唱片机

• 制作时顶部放音符盒，四角放金锭，两侧和底部放紫水晶碎片，中间放唱片机。
• 可存放18张唱片（原版或自定义唱片）。漏斗可以放入唱片，但无法将唱片取出。
• 提供播放、暂停、停止、上一首和下一首按钮，并显示当前播放曲目、进度条和时间。
• 播放模式：顺序播放、随机播放、单曲循环和列表循环。
• 音量滑块（0到100%）采用曲线调节，低音量时更容易精细调整。
• 播放范围滑块（4到64格）：离得越远，音乐越平滑地渐弱，到达范围边缘时停止。
• 歌曲播放到一半时走近唱片机，会从当前进度听到音乐，而不是从头开始。
• 只有放置唱片机的玩家可以更改设置，其他人都能看到当前播放内容。
• 红石比较器会像读取普通唱片机一样读取当前歌曲。

自定义音效（无需资源包）

• 将.ogg文件放入config/amethyst/sounds/并重启。每个文件都会以bettersmp:<file name>的形式播放/playsound，例如rickroll.ogg会作为bettersmp:rickroll播放。
• 冒号前的名称可通过config/amethyst/music.json中的soundNamespace修改。
• 玩家可通过AutoModpack获取这些文件（将/config/amethyst/sounds/*.ogg添加到其同步文件中），也可以把相同的文件放进自己的config/amethyst/sounds/文件夹。

安装步骤

1. 安装Amethyst Lib。
2. 将.ogg歌曲放入config/amethyst/discs/并重启。选项位于config/amethyst/music.json和config/amethyst/discs.json中。

服务器和玩家的游戏都需要安装Amethyst Music。

兼容模组

• Amethyst Lib（必需）
• Sophisticated Backpacks / Sophisticated Storage（可选，唱片机升级可播放刻录好的唱片）
• AutoModpack（可选，可向玩家发送歌曲文件）

测试环境

Minecraft 26.1.2、NeoForge 26.1.2.109