IV电台编辑器

https://github.com/ZSabakh/IVRadioEditor

IV 电台编辑器

一款桌面应用程序，允许您在《侠盗猎车手IV》中自定义广播体验，通过替换歌曲的同时保持游戏的音频格式和完整性。

⚠️ 重要提示

• 游戏版本兼容性：此工具兼容GTA IV可执行文件版本1.0.4.0、1.0.4r2、1.0.6.0、1.0.7.0、1.0.8.0、1.2.0.32、1.2.0.43或1.2.0.59（不支持其他版本）。如果您拥有其他版本的合法副本，您可以临时使用兼容版本可执行文件的备份文件放入游戏目录中以确保兼容性。用户必须拥有游戏的合法副本才能使用此工具。
• 未在自由城之章（EFLC）版本中进行测试——可能无法正常工作
• 文件修改：此工具提供两种替换方法：
  • FusionFix（推荐）：安全修改更新文件夹中的文件，保持原始游戏文件不变。
  • 直接替换：直接修改游戏文件（有风险 - 建议备份）。
• 依赖项：推荐的替换方法需要使用FusionFix。
• 免责声明：创建者不对因使用本应用程序而产生的任何问题负责。

功能特色

• 用户友好界面：基于PySide6构建的现代化深色主题GUI
• 安全模组功能：支持FusionFix的更新文件夹机制，防止覆盖原始游戏文件。
• 逐步工作流程：替换歌曲的指导过程
• 电台支持：旨在兼容所有《侠盗猎车手IV》的电台
• 音频处理：自动处理音频格式转换
• 元数据更新：更新游戏文件中的歌曲时长和元数据

依赖项

• PySide6：基于Qt的现代GUI框架
• pydub：音频处理库
• pyrpfiv：《侠盗猎车手IV》的RPF文件格式解析器（已发布在PyPI）
• qt_material：材料设计样式

项目结构

├── app.py                  # 主应用程序入口文件
├── ui/                     # 用户界面组件
│   ├── main_window.py     # 主应用程序窗口
│   ├── pages/             # 各个页面的具体实现
│   │   ├── intro.py       # 游戏目录选择
│   │   ├── radio_select.py# 电台选择
│   │   ├── song_select.py # 歌曲选择
│   │   ├── replace.py     # 新曲选择
│   │   └── progress.py    # 进度追踪
│   ├── signals.py         # Qt 信号
│   ├── styles.py          # UI 样式
│   └── widgets.py         # 自定义组件
├── replace_audio/         # 音频替换功能
│   ├── replace_audio.py   # 音频转换逻辑
│   └── *.dll             # 必需的音频处理库
├── update_length/         # 歌曲长度更新
│   └── update_song_length.py  # 歌曲长度修改逻辑
└── assets/               # 应用资源
    ├── fonts/           # 自定义字体
    └── radio/           # 广播电台图像

运作方式

该应用提供了一个简单的工作流程：

1. 选择您的GTA IV安装目录
2. 选择你的替换方法（为了安全，推荐使用FusionFix）
3. 选择一个广播电台
4. 选择你想要替换的歌曲
5. 选择你的新歌曲文件
6. 等待过程完成

要求

• 侠盗猎车手IV（版本1.0.4.0、1.0.4r2、1.0.6.0、1.0.7.0、1.0.8.0、1.2.0.32、1.2.0.43或1.2.0.59）
• Python 3.6 或更高版本
• 必需的Python包（参见依赖项）
• pyrpfiv 库
• FusionFix（可选但推荐）

文件格式支持

应用程序会自动处理音频转换，但为获得最佳效果，输入的音频文件应符合以下要求：

• 高质量（至少192kbps）
• 立体声音频
• 常见格式（MP3、WAV等）

故障排除与卸载

如果使用FusionFix（推荐）

如果您遇到问题或希望将广播电台恢复至原始状态：

1. 导航到你的《侠盗猎车手IV》文件夹 -> update -> pc -> audio -> sfx。
2. 删除与电台相对应的 .rpf 文件（例如 radio_vladivostok.rpf）。
3. 导航至 update -> pc -> audio -> config 并删除 sounds.dat15。注意：这将重置所有已修改电台的歌曲长度元数据。
4. 游戏将自动还原为使用原始原版文件。

如果使用直接替换

要撤销更改，你必须还原在修改前创建的备份文件。

此方法修改的文件：

• 位于 \pc\audio\sfx 中的 Radio .rpf 文件
• \pc\audio\config\sounds.dat15（用于正确的时间戳）

如果你没有创建备份，可能需要通过Steam/Rockstar启动器验证游戏文件以恢复原始文件。

贡献指南

支持维护和更新此工具的内容将受到感谢，特别是以下几个方面：

• 测试并增加对《自由城之章》的支持
• 提高与不同游戏版本的兼容性
• 错误修复和功能改进

致谢

该项目使用了多个第三方工具和库：

RAGE音频工具包 + 音频编辑器

• 由 AndrewMulti 创作
• 存储库： RAGE音频工具包
• 用于音频文件处理和转换

低音音频库

• 由Un4seen Developments开发
• 使用的组件：
  • BASS：核心音频库
  • BASSmix：音频混音功能
  • BASSenc：音频编码功能

IV音频编辑器 (ivam.exe)

• 作者：AndrewMulti
• 用于元数据编辑
• 处理 sounds.dat15 与 JSON 之间的转换
• 已集成 update_song_length.py 用于元数据更新

GTA论坛社区

• 特别感谢 MeshugaPalejo 提供的详细 电台歌曲替换指南

此工具实现了指南中所述的手动流程自动化。

免责声明

本项目包含《侠盗猎车手IV》中的广播电台标志，该游戏最初由Rockstar Games创作。这些标志仅供识别和视觉用途。

logo图标来源于Sborges98的高清电台图标1.2版本，并且我们认为其使用符合版权法中的合理使用原则。具体来说：

• 这些图标出现在一个非商业性的粉丝制作项目中。
• 它们的使用仅限于帮助用户在游戏中识别广播电台。
• 本项目不包含任何其他专有游戏资产，也不助长盗版行为。
• 该项目不鼓励盗版行为，不规避数字版权管理（DRM）保护，也不包含任何受版权保护的游戏文件，但基于合理使用原则使用的第三方资产除外。

如果您是版权所有者，对此用途有疑虑，请联系我，我将及时处理该问题。

注释

• 如果使用直接替换，请始终备份您的游戏文件
• 确保你有足够的权限修改游戏文件
• 兼容于GTA IV版本1.0.4.0、1.0.4r2、1.0.6.0、1.0.7.0、1.0.8.0、1.2.0.32、1.2.0.43或1.2.0.59

许可证

本项目采用MIT许可证。

您可自由使用、修改及分发本软件，但需保留对原作者的适当署名。本软件按"现状"提供，不提供任何明示或暗示的担保，包括但不限于适销性、特定用途适用性及不侵权担保。

查看 https://github.com/ZSabakh/IVRadioEditor/blob/main/LICENSE 文件以获取完整的许可证文本。