Puderzo/outlaws-bv2-tools
GitHub: Puderzo/outlaws-bv2-tools
实验性工具，用于检查和修补《星球大战：法外狂徒》BV2 格式的 .mmaterial 材质文件中的颜色值。
Stars: 0 | Forks: 0
## 目前可行的功能
已确认的槽位：
- `leather_base`
- 已在 `mat_chr_botm_0_gen_boot_003_leather.mmaterial` 上确认。
- 已在 `mat_chr_top_1_gold_kay_jacket.mmaterial` 上确认。
- Record 5，color3 payload。
- Header：`09 02 / 11 09 / 11 09 / 29 02 / 01 01`。
- `shirt_primary`
- 已在 `mat_chr_top_1_gold_kay_shirt.mmaterial` 上确认。
- Record 5，color3 payload。
- Header：`29 02 / c1 09 / c1 09 / 09 02 / dd 00`。
实验性回退槽位：
- `primary`：通用的 record-5 color3 候选项。
- `auto`：与 `primary` 思路相同，没有严格的 header 验证。
## 快速开始
```
python .\src\outlaws_bv2_tools\mmaterial_color_patcher.py --version
python .\src\outlaws_bv2_tools\mmaterial_color_patcher.py --list-slots
```
扫描材质：
```
python .\src\outlaws_bv2_tools\mmaterial_color_patcher.py `
--input .\some_material.mmaterial `
--scan-slots
```
修补已确认的皮革底槽位：
```
python .\src\outlaws_bv2_tools\mmaterial_color_patcher.py `
--input .\mat_chr_top_1_gold_kay_jacket.mmaterial `
--slot leather_base `
--preset debug_red `
--output .\mat_chr_top_1_gold_kay_jacket.mmaterial
```
修补已确认的衬衫主槽位：
```
python .\src\outlaws_bv2_tools\mmaterial_color_patcher.py `
--input .\mat_chr_top_1_gold_kay_shirt.mmaterial `
--slot shirt_primary `
--hex "#3366cc" `
--output .\mat_chr_top_1_gold_kay_shirt.mmaterial
```
## 仓库结构
```
src/outlaws_bv2_tools/mmaterial_color_patcher.py Mmaterial color changing tool
docs/BV2_FINDINGS.md Confirmed mappings and observations
docs/USAGE.md Usage examples
docs/RESEARCH_WORKFLOW.md Suggested workflow for new mappings
tests/ Synthetic tests, no game assets
```
## 许可证
MIT 许可证。详见 [LICENSE](LICENSE)。
标签：逆向工具