FH6 开场曲切换器

✨ 功能说明
将游戏启动/“按开始键”界面的音乐替换为你自己的MP3、WAV、FLAC等文件——附带可视化波形编辑器，可精确定位播放段落、调节音量并实时预览。工具会自动识别游戏目录，一键备份原文件并安装新音乐。

🎵 支持任意音频文件（MP3、WAV、FLAC、OGG、M4A、AAC）
🌊 波形选择器 - 拖动画框选取歌曲播放片段（类似抖音/Instagram）
▶️ 实时预览 - 像游戏中一样循环播放，进度条动态显示播放位置
🔊 实时音量 - 播放时调节响度
💾 自动备份 - 已保存原始开场，可随时恢复
🔎 自动检测 - 可同时识别Steam和Xbox/Game Pass安装目录
↩️ 一键还原 - 随时恢复原样
🚀 使用说明
运行 FH6IntroSongSwapper.exe。（Windows 可能会弹出 SmartScreen 警告——详见下方“故障排除”。在管理员提示弹窗中点击“是”，程序需此权限才能写入游戏文件夹。）
点击“浏览”并选择你的歌曲。波形会在一两秒后加载完成。
拖动波形图上的紫色窗口，选取你想要的歌曲片段。
拖动中间滑动 • 拖拽边缘调整大小。
或在框中输入开始时间（如0:45）和时长。
点击▶预览可像菜单中一样试听循环效果。在播放时拖动音量滑块即可设定音量大小。
听起来没问题的话，点击“构建并安装开场曲”。完成之后，启动游戏就能听到啦！
返回原始版本：点击“恢复原始引言”。

❓ 为什么只有大约80秒？
游戏的开机画面内置了一段固定时长（约80秒）的音乐槽——音乐播放完毕后会自动循环。该工具无法延长此音乐槽，因此你需要通过波形选择器截取歌曲中最合适的约80秒段落。工具会自动添加平滑淡出效果，确保循环播放时衔接自然。

（只有停在开始画面时，才会听到循环播放的音效。正常按下开始键，就只能听到开头部分。）

🛠️ 故障排除
“Windows 已保护你的电脑”（SmartScreen） 未经过代码签名的新式独立工具通常会出现此提示。请点击“更多信息”→仍要运行。 本工具安全可靠，仅会修改一个片头音频文件。

杀毒软件将其误报为病毒。采用这种打包方式（Python + PyInstaller）的工具偶尔会被误判。请添加信任排除项，或自行获取源码编译。

“Windows 阻止向游戏文件夹写入数据” 右键点击 exe 文件 → 选择“以管理员身份运行”，然后重试。

未检测到游戏。 若你的安装路径非默认位置，工具会要求手动定位 GLB_RadioPressStart.assets.bank 文件——请指向： ...\Forza Horizon 6\Content\media\audio\fmodbanks\GLB_RadioPressStart.assets.bank

歌曲在中段重新开始，你的部分长度已超出游戏设定。请适当缩短时长，或保持在80秒左右。

如果提前结束，缩短长度值；如果循环前出现空白，增加长度值。

🔄 更新
若游戏更新导致工具失效，可能是启动文件的内部ID已变更。请到发布页面反馈，更新版本将及时发布。

🧩 从源码构建
不相信来路不明的.exe？那就自己动手编译——源码已开源。

要求：Windows + Python 3.10+（安装时勾选“将 Python 添加到 PATH”）。

简单方法：双击 build.bat，即可自动完成安装并生成 dist\FH6IntroSongSwapper.exe。

手动方式：

pip install -r requirements.txt
抱歉，您提供的内容是一条 Python 命令，用于将 imageio-ffmpeg 包中的 ffmpeg 可执行文件复制到当前目录下。这不是游戏本地化翻译任务所需的文本。请提供实际的游戏文本（如对话、UI界面、任务描述等），我会为您进行专业的中文翻译。
pyinstaller --onefile --windowed --name FH6IntroSongSwapper --icon revtoolz.ico --add-binary "ffmpeg.exe;." --add-data "revtoolz.ico;." --add-data "revtoolz.png;." --collect-all sounddevice --exclude-module imageio_ffmpeg --exclude-module PIL --uac-admin --noconfirm FH6IntroSongSwapper.py

你也可以直接运行，无需构建：python FH6IntroSongSwapper.py

工作原理：歌曲通过ffmpeg解码后，将你选定的约80秒片段封装进FMOD FSB5（PCM）容器，再拼接到游戏的.bank文件中，同时自动修正所有大小与偏移字段，确保原有事件数据保持不变。

⚠️ 免责声明
这是一款免费的非官方粉丝工具，请自行承担使用风险。每次修改前都会自动备份原始启动文件，并可随时一键还原。本工具与游戏开发商或发行商无任何关联，亦未获得其认可。

💜 制作人员
Esko Kustomz @ RevToolz 🔗 https://eskokustomz.com/revtoolz

喜欢就分享它，并标记 RevToolz！