二次开发 工具 娱乐 【YccMusic——沉浸式奏乐】原版乐器演奏 / 沉浸式奏乐 / 自定义歌曲/自定义乐谱 / 怪物同步合奏 /1.0正式版 2026-08-21

YccMusic 1.0正式版 更新内容

◆ 新增 Fabric 客户端快捷键配置，可在 Mod 设置界面自定义按键。
◆ 优化 YCCM NB 模式，自动演奏时对应琴键会同步高亮，并显示按下效果。
◆ 修复自动演奏与键盘 UI 互相打断的问题。
◆ 修复手动演奏误触数字键、切换物品栏后退出演奏的问题。
◆ 优化吹奏类乐器持续发声，按住按键时声音更加连续稳定。
◆ 优化弦乐器延音与衰减效果，减少短促和断音。
◆ 优化 MIDI 播放节奏、和弦衔接及音符追赶机制，减少卡顿和明显停顿。
◆ 修复乐器 3D 手持模型、指挥棒模型及资源路径问题。
◆ 修复 CraftEngine 资源包加载失败、紫黑材质和模型为空的问题。
◆ 优化 Hold My Items 第一人称显示兼容性。
◆ 修复乐谱选择歌曲后自动打开的问题，现在必须手动点击“打开乐谱”。
◆ 优化浮空乐谱显示位置、缩放比例和边框范围，避免文字超出显示区域。
◆ 优化怪物乐队和指挥棒联动逻辑，提升多人同步演奏流畅度。
◆ 优化 C 大调基准音调及各类乐器音准。
◆ 完善 /yccm reload 对 MIDI 文件的重新扫描和加载。
◆ 优化插件提示文本、YCCM NB 开关提示及手动演奏状态提示。
◆ 修复多个 UI 错位、文本显示不全和按钮状态异常问题。
◆ 更新资源包结构，插件本体与 CraftEngine 资源包分离，重载插件时不重复替换材质。
◆ 统一插件与客户端 Mod 的交互逻辑，客户端 Mod 仍为可选组件。

新增 Paper / Purpur 兼容支持

• 支持 Minecraft 1.21.x
• 支持 Minecraft 26.1.x
• 支持 Minecraft 26.2.x
• Paper 和 Purpur 使用同一套插件包

1. 新增独立版本 JAR
   • 1.21.x 使用 Java 21
   • 26.1.x 使用 Java 25
   • 26.2.x 使用 Java 25
   • 根据服务器版本选择对应 JAR，不要同时安装多个版本
2. 修复全新服务器模型贴图消失问题
   • 修复首次启动时 CraftEngine 资源包无法正确解压的问题
   • 修复乐器模型、贴图、物品显示异常的问题
   • 插件会自动安装模型与贴图到 plugins/CraftEngine/resources/yccmusic
3. 优化琴谱背景图片处理
   • 启动时自动请求网站图片
   • 改为逐张下载、逐张裁切、逐张高斯模糊处理
   • 降低服务器启动时的内存占用
   • 图片获取失败时自动使用内置背景，不影响开服
4. 优化 26.x 服务端适配
   • 适配新版 Paper API 格式
   • 更新 Java 25 构建支持
   • 修复 26.x 服务端加载兼容问题
5. 稳定性验证
   • Paper 1.21.11 启动通过
   • Paper 26.2 启动通过
   • Purpur 26.1.2 启动通过
   • Purpur 26.2 启动通过
   • 单元测试 23/23 通过

YccMusic 2.8 更新公告

适用版本：Paper 1.21.x
运行环境：Java 21
Paper 移植与扩展：yccslim
QQ：1549611570
原项目：Immersive Melodies（Luke100000）

本次 2.8 版本相较于 2.3.1 进行了大规模重制，重点完善了乐器模型、MIDI 演奏、数字琴谱、怪物乐队与资源包加载体验。

一、界面与物品

1. 插件名称统一为 YccMusic，主命令统一使用 /yccm。
2. 乐器、工具、GUI 与提示信息全面中文化。
3. 现有 11 种乐器：风笛、迪吉里杜管、长笛、鲁特琴、钢琴、三角铁、小号、小鼓、维埃尔琴、末影贝斯、手碟。
4. 重制 CraftEngine 物品贴图和三维手持模型，完善第一人称与第三人称显示。
5. 新增乐谱、调音器、指挥棒三种工具，并加入耐久/使用次数限制。
6. 新增管理员物品 GUI，可集中获取全部乐器和工具。
7. 增加 Hold My Items 兼容处理，并修复副手乐器可能被错误放置的问题。

二、歌曲与 MIDI

1. 新增分页歌曲 GUI，可直接查看和选择服务器内的歌曲。
2. 支持把 .mid 或 .midi 文件放入 plugins/YccMusic/melodies 后加载。
3. 修复执行 /yccm reload 后新增 MIDI 不显示、无法加载的问题。
4. 自动演奏保留完整 MIDI 音轨和不同乐器音色，不再只播放单一主旋律。
5. 新增 MIDI 主旋律提取，可把歌曲转换为数字琴谱。
6. 优化密集音符、和弦和高速度歌曲的调度，减少卡顿、空窗和失音。
7. 修复快速演奏时切换快捷栏导致音符丢失的问题。

三、玩家演奏

1. 歌曲 GUI 支持“手动弹奏”和“自动演奏”两种模式切换。
2. 自动模式下选择歌曲后，手持任意乐器右键即可播放。
3. 潜行长按右键 2 秒进入手动演奏，按 Shift 退出。
4. 手动演奏使用快捷栏数字键输入音符，1-7 对应 Do-Si，8 对应高音 Do，并支持调音器调节主手乐器音调。
5. 玩家自动演奏时使用动作栏显示歌曲进度和状态，不占用 Boss 栏。
6. 左键可停止自动演奏；切换歌曲会停止旧歌曲并清除旧进度提示。
7. 演奏中切换、丢出或收起乐器会暂停，默认暂停 5 秒后自动结束。
8. 暂停期间可换用其他乐器右键继续演奏，并使用新乐器音色。
9. 修复右键开始后立即停止、重复触发点击和播放状态残留等问题。

四、数字琴谱

1. 新增聊天分段导入数字谱，支持较长琴谱连续粘贴，输入“完成”后生成。
2. 支持识别 1-7、0、横线、竖线、连写数字、高低音和常见分隔符。
3. 演奏时在玩家面前显示浮空琴谱，按对音符后自动变色并推进。
4. 手动完成琴谱或退出手动演奏后，琴谱会自动关闭。
5. MIDI 歌曲可自动提取单一主旋律并生成练习琴谱。
6. 提供隐藏辅助演奏模式：启用后按任意数字键都会演奏琴谱中的正确音符，速度由玩家控制。
7. 重做琴谱排版、字号、可视音符数量、显示距离和背景面板尺寸，使远距离查看更清楚。
8. 琴谱背景可在服务器启动和 /yccm reload 时，从 t.alcy.cc 获取 5 张横屏图片并自动裁切、压暗和安装。
9. 新增高斯模糊三级设置：1 为低模糊/较清晰，2 为中等，3 为旧版高模糊效果；默认使用 1 档。
10. 网站请求失败时保留内置背景，避免琴谱只显示黑色或完全没有背景。

五、怪物音乐与乐队

1. 新增怪物乐手系统，自然生成的指定怪物有概率携带乐器。
2. 支持僵尸、尸壳、骷髅、凋灵骷髅、猪灵、猪灵蛮兵、僵尸猪灵、掠夺者、溺尸、僵尸村民、流浪者、沼骸、卫道士和唤魔者。
3. 怪物会优先捡起乐器，可通过配置调整生成概率、掉落概率和替换原武器行为。
4. 自然生成的乐手怪物可随机演奏歌曲。
5. 新增指挥棒：右键怪物可开始或结束怪物演奏，空手可取下怪物手中的乐器。
6. 新增怪物乐队 GUI，最多支持 10 名成员，默认需要管理员权限打开。
7. 怪物乐队以第一名怪物为中心演奏，使用 Boss 栏显示进度。
8. 优化怪物乐队的音准、同步、追帧和连续性，减少多人演奏时的停顿。
9. 乐手怪物带有保护标记，避免被常见实体清理逻辑误删。
10. 乐器、乐谱、调音器和指挥棒可通过怪物掉落获得，相关概率均可配置。

六、资源包与配置

1. 插件 JAR 内置公开版 CraftEngine 模型与贴图，首次启动时可自动安装到 CraftEngine 资源目录。
2. 私用资源包包含原 Mod 乐器音频，可获得更完整的专属乐器音色。
3. 工作台配方已完整加入，但默认关闭；可在 config.yml 中整体开启，也可单独控制每件物品的配方。
4. 新增演奏距离、全局音量、工具耐久、怪物概率、播放性能、琴谱位置和背景处理等配置项。
5. /yccm reload 会重新加载配置、MIDI 歌曲、配方和琴谱背景图片。
6. 已移除在线密钥/授权服务器功能，插件无需密钥即可启动。

七、稳定性与保护

1. 修复乐器模型丢失、旧材质残留、物品原型冲突和指挥棒手持位置异常。
2. 修复末影贝斯可被食用的问题。
3. 修复切换歌曲后旧演奏没有停止、动作栏没有清除的问题。
4. 修复调音后手动演奏音高未变化、调音时没有反馈的问题。
5. 优化 MIDI 批处理和追帧上限，密集段落会尽量保留完整和弦。
6. 2.8 正式 JAR 已进行代码混淆和调试信息清理，提高直接反编译与修改难度。

主要命令

/yccm songs 打开歌曲 GUI
/yccm band 打开怪物乐队 GUI，需要权限
/yccm list 查看已加载歌曲
/yccm mobs 查看可演奏怪物列表
/yccm play <歌曲> 选择歌曲
/yccm stop 停止演奏
/yccm scoreconvert <歌曲ID> 将 MIDI 主旋律转换为数字谱
/yccm admin 打开管理员物品 GUI
/yccm give <物品> [玩家] 给予乐器或工具
/yccm reload 重载配置、歌曲、配方和琴谱背景

安装说明

1. 使用 Java 21 运行 Paper 1.21.x 服务端。
2. 安装与服务器版本匹配的 CraftEngine。
3. 将 YccMusic-2.8.jar 放入 plugins 文件夹。
4. 完全关闭后重新启动服务器，不建议使用 PlugManX 等热加载插件。
5. 上传 MIDI 到 plugins/YccMusic/melodies，执行 /yccm reload 即可刷新。

特别说明


本版本相较 2.3.1 改动较大，升级前请备份 plugins/YccMusic 和 plugins/CraftEngine/resources/yccmusic。建议删除旧版 YccMusic JAR，只保留 2.8，并进行一次完整重启。