Astral Party · 本地换皮 Mod 工具
一个界面里搞定:找资源 → 看图 → 换图 → 打包 → 装进游戏 → 不满意一键还原
给 Steam 版《吉星派对》（ 星引擎 Party / Astral Party）用的本地换皮工具。
起因很简单：我想给游戏换个卡面、换张立绘。
照着网上的教程走一遍才发现有多折腾——先开 dnSpy-net-win64 翻资源结构，再用 AssetStudio 把一堆哈希命名的 .bundle 导出来、在里面找到那一张图，改完还得手动打包、覆盖回游戏目录。两个工具来回倒腾，全程看不到「改之前长啥样、改之后又长啥样」，万一改错了想还原更是要命。
折腾几次就烦了，干脆自己写了这个：搜资源、预览、换图、生成 mod、装进游戏，全在一个窗口里；装之前自动备份，不喜欢一键还原。 换皮该有的顺手劲儿，我尽量都做进去了。
它只替换游戏目录里 Addressable 的
.bundle本地文件，装之前会把原文件备份好。不注入进程、不读内存、不动反作弊那一套。
功能不是全都一样成熟，别被功能表唬住，看这里：
| 类型 | 状态 | 能干嘛 |
|---|---|---|
| 贴图（卡面 / 立绘 / 图标 / 筹码…） | ✅ 稳定 | 预览、替换、导出 PNG/JPG——主力功能，就用它 |
| 文本 | 🧪 实验性 | - |
| 动画 | 🧪 实验性 | - |
| 3D 模型 | 👁 只读 | - |
一句话：现在稳的是换贴图，其它先当尝鲜。 别急着拿文本/动画去做正式 mod。
- 装别人的 Mod：选文件夹 /
.zip/.rar，自动比对当前游戏版本，只装对得上的包，跳过版本不符的。 - 备份 & 还原：装之前自动备份原文件；可以单个禁用 / 启用 / 卸载，也能侧栏「一键全还原」，随时退回没改过的样子。
- 浏览资源：按类型和细分类（手牌、立绘、筹码、地图格子…）翻，中间点、右边预览。
- 自己做：选中一张贴图 → 换成自己的图（可裁剪）→ 加进「作品集」→ 导出 ZIP 分享，或直接装进游戏。
要什么：Windows 10/11、装了 Steam 版《吉星派对》。不用装 Python。
怎么用：去 Releases 下最新那个压缩包，解压，双击 JiXingModHelper.exe。
备份、索引、作品集都写在 exe 同目录（
modkit_data、made_mods），所以整个文件夹一起拷，别只拷一个 exe 出来。
打开之后：
- 先看仪表盘是不是「游戏已连接」，没连上就点「刷新检测」。
- 想装现成的：Mod 管理 → 选文件夹/压缩包 → 看清「能装几个 / 跳过几个」 → 确认安装。
- 想自己改：浏览资源 → 选一张图 → 制作替换 → 我的作品集 → 导出或装进游戏。
左边下拉选类型，贴图还能再点细分类（手牌、立绘、筹码、地图格子…），中间点一项右边就出预览。看中了直接「去制作替换」。
小提示：列表如果空的，先点一次刷新索引（第一次要扫全部包，几千个，得等一会儿）。
选好文件夹或压缩包，它会告诉你「能装 X 个、跳过 Y 个」——跳过的多半是旧版本的包，对不上当前游戏。确认安装会先备份，之后随时能禁用/卸载。
浏览里选中 → 制作替换 → 选自己的图（可裁剪）→ 确认加进作品集。作品集里能对着看原图/新图，满意了导出 ZIP 或直接装。
游戏的美术资源在这儿：
...\Astral Party\...\StreamingAssets\aa\StandaloneWindows64\*.bundle
换皮说白了就是：用改过贴图的同名 bundle 覆盖原文件。本工具用 UnityPy 读写这些 bundle，覆盖前先把原件备份到 modkit_data/backups/，所以还原只是把备份拷回去而已。
# 装依赖
python -m pip install -r requirements.txt
# 直接跑（默认 HTML 前端，由原生 WebView2 窗口承载）
python -m astral_party_auto
# 打包成 exe
powershell -ExecutionPolicy Bypass -File .\build_exe.ps1打包产物在 dist\JiXingModHelper\，双击 exe 启动。
| 问题 | 处理 |
|---|---|
| 检测不到游戏 | 确认 Steam 里装了游戏，点「刷新检测」 |
| 浏览/搜索是空的 | 点一次「刷新索引」，第一次扫几千个包要等一会儿 |
| 装完进游戏没变化 | 确认「能装数量 > 0」；重启游戏；看是不是被别的 mod 覆盖了 |
| 文本/动画装了没用 | 这俩还在实验阶段，不保证生效，先以换贴图为主 |
| RAR 解压失败 | 装个 7-Zip，或先手动解压成文件夹再选 |
改的是你本机的游戏资源文件（有备份、能还原），联机别人是看不见的，只能本地过过眼瘾。
有问题开 Issue，PR 也欢迎，尽量小而清楚就行。