universal-modder实战如何在帝国时代2里造一个全新文明3D模型转16向精灵图全流程【免费下载链接】universal-modderPoint Claude at any game. Skills, tools and the fal MCP that let Claude Code mod almost any PC game you own: recon, reverse engineering, fal-generated art/3D/audio, in-game testing, showcase videos.项目地址: https://gitcode.com/gh_mirrors/un/universal-modderuniversal-modder是一套让 AI 编程代理为 PC 游戏制作 MOD 的工具集。这篇文章带你用它为《帝国时代2决定版》从零打造一个可玩的新文明——旧金山人AI 生成单位概念图与 3D 模型把 3D 模型渲染成游戏需要的16 个朝向精灵图帧再写入游戏自己的.sld精灵格式最后组装成数据 MOD 安装进游戏。整个过程就是一个完整的3D 模型转 16 向精灵图流水线。最终效果一个完整的新文明这个 MOD 里的旧金山人文明包含Robotaxi无人出租车城堡时代训练的独特单位一辆会撞人的自动驾驶车还有精英升级版Delivery Drone快递无人机城堡时代起的悬浮远程单位泛美金字塔新奇迹建筑✨ 文明加成村民工作 10%、骑兵移动 10%、两个独特科技、专属徽章与科技树它占用了勃艮第人的槽位只有在遭遇战大厅选中这个数据 MOD 时才生效原版游戏完全不受影响随时可移除。完整说明见 examples/aoe2-de-civ/README.md踩坑经验沉淀在 knowledge/games/age-of-empires-ii-de/san-franciscans-civ.md。快速开始安装 universal-modder只需一个 Python 环境3.10、ffmpeg以及重新渲染精灵图时的 Blendergit clone https://gitcode.com/gh_mirrors/un/universal-modder uv tool install githttps://gitcode.com/gh_mirrors/un/universal-modder生成美术资源需要 fal 的 API Keyexport FAL_KEY...。本示例脚本在 examples/aoe2-de-civ/核心是三个脚本make_sprites.py3D 转精灵、build_mod.py生成数据 MOD、sld.py逆向出来的.sld精灵读写器。第一步AI 生成概念图再转成 3D 模型美术资源全部由 fal 生成提示词集中写在 assets/gen.sh流程分两段概念图用 FLUX 画白色背景、干净产品照风格的单位概念图。注意一个关键细节——想让哪个部位显示玩家颜色就把它画成高饱和的蓝色后面打包精灵时会按色相自动掩码。3D 模型um fal model3d把概念图转成带贴图的 GLB 网格Trellis 图生 3D 模型。奇迹建筑不走 3D它是单帧贴图直接用 FLUX 按帝国时代2 的等距视角画出来make_wonder.py 再把它拟合到 5x5 格占地范围。第二步3D 模型转 16 向精灵图帧这是整个流水线最核心的魔法。帝国时代2 的引擎要求每个单位16 个朝向从正东开始顺时针每 22.5° 一帧相机为正交投影、俯角 30°单位接地点位于画布中心。um render3d --preset aoe2一条命令就搞定Blender 会自动摆好相机和灯光对 idle待机、walk行走、attack攻击、death死亡等每个动画逐帧渲染外加一轮独立的地面阴影通道python make_sprites.py all robotaxi drone渲染参数模型朝向forward_yaw、1x 下的像素长度length、每个动画的帧数与时长都在 civ.py 里声明改数即可微调。生成build/previews/unit_sheet.png预览表一行一个动画、16 列朝向一眼就能看出车头朝向或大小是否合适。第三步精灵帧打包成游戏的 .sld 文件.sld是帝国时代2 DE 的专有精灵格式BC1 压缩的主体层外加 BC4 的阴影层和玩家颜色层。sld.py 是这个格式逆向出来的读写器打包前先对原版骑士精灵做了往返测试解码→编码→再解码平均误差 0.91/255确保格式完全正确。打包时自动完成三件事逻辑在 make_sprites.py蓝色像素 → 玩家颜色掩码脱色成灰色渐变游戏运行时染上队伍色死亡帧做烧焦处理压暗成残骸质感 写入build/graphics/*.sld主体、阴影、玩家色三层分开放第四步构建数据 MOD 并安装进游戏数据层面由 build_mod.py 基于genieutils-py完成把新文明写进游戏数据的槽位 36深拷贝模板单位再改属性追加科技、字符串、图标与 JSON 配置。python make_wonder.py # 奇迹精灵 python build_mod.py --install # 生成并安装到 profile/mods/local/游戏里单人 → 遭遇战 →Data Mod 下拉框选 San Franciscans文明列表里就能看到旧金山人取代了勃艮第人。分享前建议跑一下um publish check确保没有混入游戏原文件。如何改成你自己的文明作者把整个文明定义成了纯数据只改一个文件civ.py 就能造自己的文明选要占用的槽位SLOT和基础文明BASE_CIV提供科技树与建筑风格填文明名、加成、UNITS每个单位只写属性差异其余从模板单位继承和两个独特科技换成你自己的美术改 assets/gen.sh 的提示词重新生成或直接放入同名文件make_sprites.py all unit→build_mod.py --install→ 大厅选 MOD容易踩的坑❓新文明不出现在选择器可执行文件的文明表是硬编码的新增文明能玩但选不到必须替换槽位❓MOD 像没生效带.dat的数据 MOD 必须在大厅 Data Mod 下拉框里勾选❓游戏内图标不变命令面板图标来自不可扩展的图集游戏内用原版图标菜单里才用自己的美术这套流程同样适用于其他老游戏——16 向精灵图只是其中一种投影um render3d还支持iso8、topdown、turntable等预设。想要更完整的踩坑记录可以翻 examples/aoe2-de-civ/README.md 的 Lessons 一节那里把每一个症状→原因→修复都记下来了。【免费下载链接】universal-modderPoint Claude at any game. Skills, tools and the fal MCP that let Claude Code mod almost any PC game you own: recon, reverse engineering, fal-generated art/3D/audio, in-game testing, showcase videos.项目地址: https://gitcode.com/gh_mirrors/un/universal-modder创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考