emavinnhappynight8/ac4-blackflag
GitHub: emavinnhappynight8/ac4-blackflag
一款面向《刺客信条4：黑旗》的开源综合工具包，提供存档编辑、Anvil 引擎资源提取、性能配置和 Mod 加载等一站式功能。
Stars: 0 | Forks: 0
# 🏴☠️ AC4 Black Flag Toolkit
[](../../releases/tag/Release)
### 面向《刺客信条4：黑旗》的开源工具包 — 存档编辑器、Anvil Engine 资源管理器、mod 加载器以及 PC 和 Steam Deck 的性能配置工具。
[](LICENSE)
[](https://isocpp.org/)
[](https://github.com/yourusername/ac4-blackflag-toolkit/releases)
[](https://github.com/yourusername/ac4-blackflag-toolkit/stargazers)
[](https://github.com/yourusername/ac4-blackflag-toolkit/actions)
## 🧠 关于 AC4 Black Flag Toolkit
**AC4 Black Flag Toolkit** 是一款专为 PC 平台《刺客信条4：黑旗》打造的开源 mod 与增强工具套件。它集成了存档文件编辑器、Anvil Engine 资源浏览器、性能配置管理器以及一个轻量级 mod 加载器 —— 所有这些功能都集中在一个轻量级的 C++20 应用程序中。
由社区构建，为社区服务。无论你是想恢复损坏的存档、突破原版限制调整 FOV、解锁所有船歌和地图以供探索，还是为了 mod 研究而检查原始的 Anvil Engine 数据 —— 这款工具包都能满足你的需求。
完全兼容 2013 年的原版以及 **Resynced Edition (2026)** 重制版。
## 🚀 功能特性
- 💾 **存档文件编辑器** — 编辑金币、材料、船歌、船员、船只升级、任务标记和地图完成度
- 🗂 **Anvil Engine 资源浏览器** — 浏览、提取和预览 `.forge` 归档内容：网格、纹理、音频、动画
- ⚙️ **性能配置管理器** — 一键解锁 FOV、修复带鱼屏显示问题、调整阴影/LOD、解除帧率上限
- 🗺 **地图揭示工具** — 解锁完整的加勒比海地图、所有鸟瞰点和快速旅行地点
- 🎵 **船歌解锁器** — 无需推进剧情即可恢复或解锁所有海上船歌
- 🔁 **mod 加载器** — 无需重新打包 `.forge` 归档即可加载散装的资源文件
- 🖥 **Steam Deck 配置文件** — 专为 Deck 的 800p 屏幕和 TDP 限制预先调整的图形预设
- 📦 **单一可执行文件** — 无需安装程序，无需运行时，终端用户机器上零依赖
- 🔍 **十六进制查看器** — 用于原始存档和资源检查的轻量级内置十六进制编辑器
- 📋 **CLI 模式** — 可通过命令行编写脚本，用于批量存档操作或 CI mod 测试
## 📸 预览
*存档编辑器 — 编辑金币、船只升级和任务进度*
*带有纹理预览的 Anvil Engine `.forge` 归档浏览器*
*性能面板 — FOV、带鱼屏修复、阴影、帧率上限*
## 📦 安装说明
### 前置条件
- Windows 10/11 (x64) 或 Steam Deck (Proton 9+)
- 《刺客信条4：黑旗》（Steam、Ubisoft Connect 或 Resynced Edition 版本）
- Visual C++ Redistributable 2022（包含在发布的 ZIP 文件中）
### 快速开始
1. 从 **[Releases](#)** 下载最新的发布 ZIP 文件
2. 解压到任意文件夹 — 无需安装
3. 运行 `ac4toolkit.exe`
4. 在首次启动时将其指向你的 AC4 安装目录
### 从源码构建
```
git clone https://github.com/yourusername/ac4-blackflag-toolkit.git
cd ac4-blackflag-toolkit
mkdir build && cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
cmake --build . --parallel
```
## 🛠 使用说明
### GUI 模式
启动 `ac4toolkit.exe` 并使用选项卡式界面：
- **Save Editor** 选项卡 → 打开你的 `ACBF_SAVE_*.dat` 文件 → 编辑数值 → 保存
- **Assets** 选项卡 → 指向你的 `DataPC.forge` → 浏览并提取
- **Performance** 选项卡 → 应用预设或微调单个设置
- **Mods** 选项卡 → 拖入散装的 mod 文件，设置加载顺序，应用
### CLI 模式
```
# 打印存档文件摘要
ac4toolkit save --info "C:\saves\ACBF_SAVE_0.dat"
# 将金币数量设置为 999999
ac4toolkit save --edit "ACBF_SAVE_0.dat" --gold 999999
# 解锁所有 shanties
ac4toolkit save --edit "ACBF_SAVE_0.dat" --shanties all
# 从 forge archive 中提取纹理
ac4toolkit forge --extract "DataPC.forge" --file "edward_kenway_diffuse.dds" --out textures/
# 应用 ultrawide + FOV 解锁配置
ac4toolkit perf --apply ultrawide --fov 90
```
## 📥 下载
适用于 Windows x64 和 Steam Deck 的预编译二进制文件：
[](../../releases/tag/Release)
## 🧩 技术栈
| 组件 | 技术 |
|---|---|
| 核心 | C++20 |
| GUI | Dear ImGui 1.91 + SDL2 |
| 十六进制查看器 | ImHex 集成 |
| 文件解析 | 自定义 Anvil `.forge` 解析器 |
| 配置 | TOML++ |
| 构建 | CMake 3.27 |
| 封装 | NSIS (Windows 安装程序) |
| 测试 | Google Test |
## 📁 项目结构
```
ac4-blackflag-toolkit/
├── src/
│ ├── save/ ← Save file parser and editor
│ ├── forge/ ← Anvil Engine archive reader
│ ├── perf/ ← Performance config writer
│ ├── modloader/ ← Loose file mod injector
│ └── ui/ ← Dear ImGui interface
├── main.cpp
├── utils.h / utils.cpp
├── config.json
├── LICENSE
└── README.md
```
## 📈 关键词
AC4 Black Flag Toolkit 是一款专为 PC 平台《刺客信条4：黑旗》打造的开源 mod 工具和存档编辑器。它支持 Anvil Engine 资源提取、存档文件编辑、FOV 解锁、带鱼屏修复、Steam Deck 优化，并且可加载 mod，同时兼容 2013 年原版和 Resynced Edition 2026 重制版。专为游戏 mod 制作、性能调整、开放世界探索工具，以及对 Ubisoft 的 Anvil Engine 进行逆向工程研究而设计。兼容 Windows 10、Windows 11 平台的 Steam、Ubisoft Connect 和 GOG 版本，以及通过 Proton 运行的 Steam Deck。
## 📜 许可证
基于 **MIT License** 授权 — 详见 [LICENSE](LICENSE)。
*本项目不隶属于 Ubisoft，也未获得其认可。所有游戏资产仍归 Ubisoft 所有。*
[](../../releases/tag/Release)