国乐

描述

State Music 让你在玩《怪物猎人：荒野》时播放自己的歌曲，并根据你当前的行为自动选择。它在你探索时播放一首曲目，在战斗时播放另一首——你甚至可以为每个区域设置不同的音乐，包括探索和战斗。所有主要功能都列在下面！

安装说明

1. 1. 安装 REFramework（必需——见下方“要求”）。
2. 2. 将本模组解压到你的游戏文件夹中。
3. 3. 将你的音频文件（mp3, wav, ogg, flac）放入： MonsterHunterWilds/reframework/data/StateMusic/
4. 4. 启动游戏，打开 REFramework 菜单，找到 State Music。
5. 5. 从下拉菜单中选取你的曲目。如果在游戏运行时添加文件，请点击 刷新文件。 从较低的音量开始 —— 最大音量时音频可能会非常响。

主要功能

• 根据游戏状态播放自己的音乐 —— 自动切换探索和战斗曲目。
• 针对特定怪物的战斗主题 —— 为你正在战斗的特定怪物播放专属曲目，直接从游戏自身的战斗音乐中读取（非血量猜测）。你也可以提前从下拉菜单中为任何怪物指定主题，无需先与其战斗。
• 分区域音乐 —— 为每个区域（风音平原、绯红森林、油涌盆地等）设置独立的探索和战斗主题。
• 怪物低血量主题 —— 在怪物濒死时触发你的“英雄之证”燃爆时刻（默认15%血量，可完全调整，当怪物血量低时，我也喜欢播放《排球少年》的直接对决原声带）。
• 追逐主题 —— 在怪物逃跑时播放。
• 死亡主题 —— 在你力竭倒下时播放。
• 任务结果主题 —— 为完成/失败/放弃分别设置曲目。
• 曲目间的交叉淡入淡出。
• 按文件音量均衡 —— 将录制音量较高的歌曲调平，并提供“试听（8秒）”预览，防止突然吓到你。
• 所有位置均有按字母排序、可按名称筛选的文件列表 —— 即使曲库庞大也能瞬间找到曲目。
• 通过链接或整个播放列表下载 —— 可选功能，通过 yt-dlp 实现（参见下方 V2 说明）。
• 音量控制 —— 按住 Ctrl 并点击滑块可输入精确数值。
• 支持 mp3（也应该支持 wav、ogg、flac，但我还没试过）。

要求

• 适用于《怪物猎人：荒野》的 REFramework（在此处提供链接）。
• 在选项 → 音频中调低游戏 BGM，使其不会盖过你的音乐。我还没找到静音游戏自带的音频的方法，但我会继续努力尝试，使其尽可能完美。

更新日志

更新内容越来越长，我现在有点懒得写所有细节了，如果没忘记的话，以后会补上。

V4.4： 现在发生任何问题时，会在模组界面显示错误（独自升级？）

V4.3： 现在可以播放播放列表 + 版本跟踪器以及一些错误修复

V4.2：预设 + 更智能的音量系统 新增：

• 预设 — 将你当前的曲目分配保存为一个名称（一套金属乐设置、一套管弦乐设置、一套搞怪设置...），并一键切换。按文件音量保持共享，因此你只需设置一次，它们就会在所有预设中生效。
• “正在播放”快速音量 — 打开“按文件音量”，你当前正在听的曲目已被选中，并带有其专属的实时滑块。战斗中音量太大？当场调整，无需滚动列表查找。 更改：
• 全局音量滑块现在变为“默认音量（所有文件）”：它会一次性设置所有文件的音量。微调单个文件时，该值会覆盖该文件的默认值（并附带“恢复默认”按钮用于撤销）。无需再逐个调整每个文件的音量 — 设置一个合理的默认值，然后只调整那些异常的即可。
• 所有“按名称筛选”框（默认音乐/按文件音量/当前区域）现在同步 — 在任意一个框中输入，它们会一起筛选。两个按怪物筛选的框保持独立。

V4.1： 修复筛选在2个区域不显示的问题 + 修复按文件音量可能自行改变的 bug。 强烈建议升级到4.1版本!!!

V4：这是一个大版本！ 新增：

• 针对特定怪物的战斗主题：现在读取游戏内部状态，而不是根据血量猜测你攻击的是哪个怪物。
• 提前为任何怪物指定主题（下拉菜单），无需先与其战斗（既然按怪物主题运行良好，我就可以添加了。我知道不是所有怪物都显示在下拉菜单中，因为并非所有怪物都有自己的主题。我会看看是否仍能为所有怪物做到这一点）。
• 怪物低血量主题 — 经典的燃爆时刻，英雄之证或任何你想要的，默认15%血量，但可调整。
• 追逐主题（怪物逃跑，但根据我的测试它持续不了多久），死亡主题（你倒下时，大约3秒左右，可以放《艾尔登法环》的死亡BGM）。
• 任务结果主题：完成/失败/放弃（欢迎回来，《冬日天空中的凯旋之歌》和天回龙死亡曲！）。
• 按文件音量均衡，带“试听（8秒）”预览 + 名称筛选器 — 因为我被吓到过很多次（我为什么现在还在说这个）。
• 所有位置均有按字母排序、可筛选的文件列表，嗯，就不多解释了。
• 下载播放列表（仍然使用 yt-dlp，如需此功能请查看 V1 说明） — 播放列表下载使用 yt-dlp，并自动将名称转换为 ASCII 码，因此下载是安全的。如果你是手动添加自己的文件，请保持文件名使用 ASCII 码（英文字母）——非 ASCII 码名称（日语、带音标的字母、西里尔字母等）会导致 REFramework 的文件扫描器崩溃。抱歉，我的亚洲/俄罗斯/阿拉伯朋友们... 修复：
• 当曲目具有自定义按文件音量时，交叉淡入淡出不再出现音量突跳。
• 任务开始时音乐不再中断/重启；任务完成盖章期间无间隙。

V3.1： 改进了双怪物任务中怪物的检测 - 提醒：此功能仍为测试功能，可能存在 bug。

V3：按文件音量 + 测试：每个怪物专属曲目 每个怪物的专属曲目目前是实验性的。如果你选择使用它，最终可能会遇到一些 bug，有的可能会很有趣，有的可能会非常烦人，你可以随时启用/禁用。如果你确实发现了 bug，请在错误报告区报告，如果忘了开放错误报告区请在评论中说明。

V2.1： 修复淡出不正常工作的 bug

V2：通过链接下载曲目 本模组可以直接从链接（YouTube 等）下载音频，省去手动添加文件的麻烦。使用方法：

1. 在任何终端中使用以下命令安装 yt-dlp 和 ffmpeg：

   winget install yt-dlp.yt-dlp
   winget install Gyan.FFmpeg
   

   然后完全重启 Steam。
2. 在 State Music 菜单中，打开“从链接下载”，粘贴链接，输入名称，点击下载。

从脚本下载歌曲的功能在未安装 yt-dlp 和 ffmpeg 的情况下无法工作，因为这是外部依赖项。我能理解有些人不希望为了安全而安装额外的软件，这只是生活品质功能，并非必需。 仅供个人使用 —— 从 YouTube 下载可能违反其服务条款。