本地音乐与卡点教程 · 1.5.1

本目录随客户端首次启动生成。它是本地MP3文件夹，不是原版资源包，也不需要数据包。

一、示范歌曲与播放

1. 打开模组配置中的“音乐与卡点”，点击“打开音乐目录”。
2. 保留本目录的示范MP3，或放入自己的MP3；最多识别两级子目录。
3. 点击“重新扫描”，等待解码与分析完成。上一首、下一首切换歌曲。
4. 点击“试听 / 停止”；点击片段波形可改变试听位置。

二、宣传片示例卡点

示范音源为 The Opening。歌曲起点47.8秒，播放75秒片段；蓄力16秒、发射32秒、爆发70秒、结束75秒。换算到原歌曲：63.8秒蓄力、79.8秒发射、117.8秒爆发、122.8秒结束。

“示例卡点.json”通过SHA-256匹配相同歌曲字节，文件改名不影响匹配；不同编码版本或重新压缩后需要重新分析和校准。已有 selection.json 中保存的同首歌曲设置优先，示例不会覆盖它。

三、换歌与手动调整

“自动建议”重新推荐75秒片段；它根据音频能量与节奏估计，不保证识别歌曲高潮。歌曲起点按全曲秒数填写，三个阶段标记按演出开始后的秒数填写。

• 蓄力4–28秒。
• 发射至少比蓄力晚4秒，且不晚于55秒。
• 爆发至少比发射晚8秒，且不晚于72秒。
• 演出总长固定75秒；歌曲不足75秒时播放至歌曲结束，余下时间静音，不强制循环。

点击“保存”保存本地音乐设置；需要按新标记改变演出时，点击“按标记发动”（OP 2级）。普通 /thaumicstrike play 保持服务器默认预设的时间。服务器 defaultPreset 决定使用纯视觉还是实战规则。

四、音量与联机

确保模组音频、音乐开关已开启。音乐同时受模组音乐音量和原版“唱片机/音符盒”音量控制；原版“音乐”滑条控制Minecraft背景配乐。多人游戏每个客户端需要准备相同歌曲文件，模组不传输歌曲或本地路径。没有匹配歌曲仍可观看演出。

五、缓存和排错

修改歌曲后重新扫描；缓存位于 .cache，个人选择位于 selection.json。扫描报错先检查MP3是否能正常播放，最长支持60分钟；示例JSON需保留数字类型、英文引号，不能有注释或末尾多余逗号。无法匹配示例时仍可使用自动建议和手动输入。

示例只在首次安装本版时生成，不覆盖同名文件。删除示范歌曲后重新启动不会把它恢复；如需补齐缺失示例，删除本目录 .bundled-1.5.1 标记后重启，已有文件仍保留。

音频来源与许可状态见歌曲来源.txt。项目代码MIT不覆盖第三方歌曲。