TCG 艺术扩展自动器

【标题】
《杀戮尖塔》卡牌遮罩批量处理脚本使用指南
【核心介绍】
自动为所有怪物卡牌（含基础卡与闪卡）叠加指定遮罩，适配「Art Expander」文件结构，一键生成可直接安装的 BepInEx 模组包。
【安装指南】
1. 下载本脚本（含 `.py` 文件及配套配置说明），解压至本地任意文件夹；
2. 按需准备三类文件夹并在脚本中准确填写路径：
– `INPUT_FOLDER`：存放所有原始怪物图片（需从游戏文件或 `.asset` 中提取，格式为 PNG）；
– `MASK_FOLDER1`：存放基础卡牌遮罩文件（命名需与扩展包标识一致，如 `EX`）；
– `MASK_FOLDER2`：存放闪卡遮罩文件（命名规则同上，与 `MASK_FOLDER1` 对应）；
– `OUTPUT_FOLDER`：指定最终模组输出路径（脚本将自动生成完整 BepInEx 目录结构）；
3. 运行脚本，等待完成提示；生成的 `Output/BepInEx` 文件夹可直接压缩为 ZIP，通过 Vortex 或手动方式安装。
【功能详情】
✅ 已优化：自动识别同名遮罩，优先叠加 `MASK_FOLDER1`（基础卡），再叠加 `MASK_FOLDER2`（闪卡）；
✅ 已优化：若缺失 `MASK_FOLDER1`，仍可单独应用 `MASK_FOLDER2` 生成闪卡；
✅ 已优化：严格遵循「Art Expander」目录规范，输出文件可直接被游戏识别；
❌ 未修改：不修改原始图片尺寸、格式或内容逻辑；
✨ 额外调整：支持高级用户自定义后缀名、遮罩 Alpha 滤镜强度、透明度及输出图像参数（详见脚本内注释）。
【使用要求】
– 必需安装 Python 3.8+（脚本运行环境）；
– 必需提前提取并整理好符合命名规范的怪物图片（PNG 格式）；
– 输出结果依赖「Art Expander」模组，需已安装「Art Expander」v1.9.0 或更高版本。
【兼容性说明】
– 兼容范围：所有基于「Art Expander」机制的扩展包（如「Neow’s Lament」「The Watcher」等）；
– 不兼容模组：无直接冲突，但不兼容擅自修改 `BepInEx/plugins/ArtExpander` 核心文件的第三方补丁；
– 兼容补丁：暂未推出专用兼容补丁。
【注意事项】
– 遮罩文件命名必须与目标扩展包标识完全一致（例：`EX.png` → 作用于「EX」扩展包所有卡牌）；
– `MASK_FOLDER1` 与 `MASK_FOLDER2` 中的同名文件将按顺序叠加，顺序不可颠倒；
– 脚本输出的 `Output/masks_preview` 文件夹内含 Alpha 遮罩效果预览图，可用于快速校验；
– 若运行报错，请检查路径中是否含中文或空格，并确认 Python 环境已正确配置。
【更新日志】
– 2024 年 5 月 12 日 支持自定义输出图像参数（尺寸缩放、Gamma 校正）；
– 2024 年 4 月 3 日 新增缺失基础遮罩时自动降级应用闪卡遮罩逻辑；
– 2024 年 3 月 1 日 首版发布，适配「Art Expander」标准目录结构。