原神自定义模型导入总翻车先跨过这 7 个坎再谈魔改【免费下载链接】GI-Model-ImporterTools and instructions for importing custom models into a certain anime game项目地址: https://gitcode.com/gh_mirrors/gi/GI-Model-Importer工具装好了、教程翻完了、F10 也按了结果角色要么黑成一块要么直接闪退。 这句话几乎可以概括 3DMigoto GIMI 新手群里的日常求助。原神模型导入这件事说难也难说简单也简单——难在它绕不开一堆看不见的规矩简单在只要你搞懂了那几个坑剩下的全是重复劳动。先说清楚 GIMI 到底是干嘛的。它本质上是 3DMigoto 的一个定制版本专门为原神做了兼容改造。你用它把游戏正在绘制的模型数据钓出来在 Blender 里改完再放回去配合一套脚本工具和详细教程就能实现自定义角色外观、换武器皮肤、改特效颜色这类操作。项目本体不含模型文件模型原料和操作说明分布在仓库的 Tools 与 Guides 目录里。在动手之前有一点必须摆在最前面作者原话是强烈建议只在私人服务器上折腾。官方服务器上使用这些工具封号风险极高这个红线别碰。出发前的三件套先核对再开跑① 版本别选错。仓库提供了两个压缩包开发版for development带屏幕上下方的绿色调试文本、功能全开但更慢是做模组用的游玩版for playing mods砍掉了调试功能、速度更快是日常加载 mod 用的。新手排查问题基本都靠绿字所以前期请认准开发版。② 加载器指向要对。3DMigoto Loader.exe 启动前先确认 d3dx.ini 里的 target 行指向的是游戏本体 exe而不是启动器 exe——这两个文件都在游戏文件夹里很容易弄混。V7 及以上版本会自动处理老版本才需要手动改。③ 顺序别反。先双击 Loader再通过游戏 exe 启动原神。加载器提示 unable to verify 不代表注入失败只要游戏里有绿字、mod 能生效那个控制台窗口就可以直接关掉留着反而拖慢电脑。第一个坎模型数据到底从哪来很多新手以为换模型是去游戏文件里翻模型其实不是。原神里根本没有可以让你直接拖出来的模型文件你得用 3DMigoto 在游戏运行时抓数据。具体来说每一帧画面里角色的绘制都依赖顶点缓冲VB和索引缓冲IB这两样东西承载着模型的形状信息。你在游戏里按 F8工具会把当前帧相关的缓冲区整体转储出来形成一份 FrameAnalysis 文件夹里面全是散落的 .txt、.buf、.dds 文件。每个部件都对应一个 hash 值hash 就是后续一切替换操作的钥匙。好消息是你不必每次从零开始抓。仓库对应的模型资产库GI-Model-Importer-Assets里已经按角色整理好了现成的原始数据角色文件夹通常至少包含头CharHead和身体CharBody部分角色还有额外的部件CharExtra。把这些数据导入 Blender就是你在游戏里看到的那个模样的底稿。第二个坎想删掉某个部件凭什么能只删它拿入门教程里最常见的例子来说莫娜的帽子。在 3DMigoto 之前这顶帽子几乎无法干净地移除——它没有独立着色器、不是独立对象、骨骼还跟头发共用怎么删都会伤及无辜。3DMigoto 解决这件事靠的是狩猎模式。开发版启动后按小键盘 0 开启你可以用数字键在缓冲区里循环/、*切换顶点缓冲VB7、8切换索引缓冲IB9复制 hash4、5切换顶点着色器VS6复制 hash1、2切换像素着色器PS3复制 hash。被选中的对象会直接从画面里消失消失的那个就是你锁定的目标。找到后把 hash 记下来在 Mods 文件夹里写一个 .ini 文件加上handling skip让它永久跳过绘制游戏中按 F10 重载帽子就没了。细节操作含光照图阴影的修补可以照搬Guides/CN_MonaWalkthrough.md它是整套流程里最标准的入门范例。第三个坎进了 Blender为什么看着对却导不回去模型编辑在 Blender 里完成用的插件是仓库提供的blender_3dmigoto_gimi.pyBlender 2.80 以上。导入时选 File → Import → 3DMigoto Frame Analysis Dump角色文件夹下所有 .txt 一起选上即可。但这里有一堆隐藏规矩违反任何一条导出回游戏就是一场灾难顶点数有上限。旧版约 64KV7 及以上提升到了 40 万左右自定义高模得先掂量掂量顶点组、顶点色、自定义属性必须齐全。原始模型有的你都得有缺一个游戏里就错位、花屏甚至崩溃UV 通道命名要规范。原神只认 TEXCOORD.xy 这类标准命名Blender 默认的 UVMap 名字在它眼里等于不存在对象命名与导出位置有讲究。头部、身体、额外部件各归各位导出要落到带 hash.json 的原始数据文件夹里文件名也得对得上。这套规矩折磨人的地方在于出错时 Blender 里一切正常只有放进游戏才爆炸。所以仓库专门配了一堆 Blender 辅助脚本——清掉没用顶点组、填补权重空隙、转移自定义属性、合并顶点组都是在给这些隐形规矩擦屁股。建议动手前先扫一遍Tools目录里的脚本清单能省你大量手动操作。第四个坎只想换个颜色为什么也要大动干戈如果你只是想让武器换个配色、把某件衣服染成想要的样子完全没必要碰模型网格——原神模型的颜色和材质由贴图控制改贴图比改模型简单一个量级。做法是在开发版里用数字键 1、2 循环像素着色器找到让目标物件消失的那个 hash在 .ini 里用ShaderOverride指定它再按 F8 做一次定向转储就能把对应的贴图文件.dds挖出来。编辑后放回 Mods 文件夹用TextureOverride指向新贴图即可。这里有几个格式上的死规矩尺寸必须是 2 的幂1024×1024、2048×2048 这类整数比例颜色贴图存 BC7 SRGB、光照图存 BC7 Linearmipmap 必须生成别丢了 alpha 通道——原神里不少发光效果全靠 alpha 层驱动删了它贴图会亮得刺眼。想走捷径的话Tools里的genshin_set_color.py、genshin_set_transparency.py就是干这个的命令行传个参数就能批量调色、调透明度。完整的祈愿横幅、风之翼替换案例在Guides/CN_TextureModdingTutorial.md。第五个坎别人的模型放进来就乱到底谁在捣鬼从外部拿来的自定义模型最常见的问题出在权重上。原神角色靠顶点组分配骨骼权重外部模型哪怕形状很像顶点组的数量、顺序、位置跟原始模型对不上放进去就是人物扭曲、手指乱飞。经验是让新模型跟原模型尽量重叠把顶点组、权重、顶点色、自定义属性整体转移过去转移完务必逐组核对顺序4 6 7 8 5 这种乱序和缺组都是重灾区。朝向上也常栽跟头——外部模型尤其 MMD 模型经常跟原神坐标空间不一致导入后整体旋转 90 度再应用变换是常规操作。至于头发几乎每个老玩家都会劝你一句别碰。原神角色头发结构简单是有原因的复杂发丝进入这个游戏就是噩梦实在要处理把所有头发顶点归到头部顶点组、放弃飘动效果是最稳妥的出路。第六个坎多个 mod 打架怎么让它们共存玩到后面你会发现Mods 文件夹里一个角色一次只能放一个 mod 文件夹想给同一个角色换不同外观就得来回搬运文件。这时候genshin_merge_mods.py就派上用场了——它能把多个 mod 合并成一个并给你绑定一个按键游戏里按一下就能在几套外观之间切换还支持只对当前上屏角色生效的选项。类似的偷懒工具仓库里还有不少genshin_3dmigoto_collect.py负责把 F8 转储出来的散落缓冲区自动归类整理genshin_3dmigoto_generate.py负责把 Blender 导出的模型重新拆分成游戏能认的格式并重排 .ini——原神把角色数据拆在六七个缓冲区里这件事全靠这两个脚本兜底。第七个坎全搞砸了怎么快速定位是哪一步错了翻车不可怕可怕的是没头苍蝇一样乱试。按这个顺序过一遍大多数问题都能定位检查导出对象场景里是不是有重名对象、有没有完全空的网格至少保留一个面、COLOR 顶点色是否齐全检查文件落位导出是否进了带 hash.json 的原始数据文件夹、文件名是否正确检查格式贴图尺寸和格式是否合规、UV 命名是否标准检查冲突Mods 文件夹里是不是同时放了同一个角色的多份 mod有冲突警告先把重复的删掉清理缓存问题依旧就清空 ShaderCache 和 ShaderFixes 文件夹转储留下的着色器有时候会干扰加载看控制台Blender 导出报错时控制台窗口会给出具体原因比对着屏幕猜高效得多。Guides/CN_Troubleshooting.md把每个报错截图对应的原因都列出来了遇到不认识的错误先去那儿查比翻聊天记录靠谱。收尾一张上路检查表把整条流程压缩成一张速查卡贴在手边用开发版验证绿字出现target 指向游戏 exe角色原始数据来自模型资产库导入全部 .txt 文件顶点数在限制内顶点组、顶点色、UV 命名齐全规范对象按头/身体/额外部件命名导出到带 hash.json 的文件夹贴图走 BC7 格式、2 的幂尺寸、带 mipmap 和 alpha生成的 Mod 文件夹放进 Mods游戏里按 F10 生效只在私人服务器上测试这一路走完你对 3DMigoto GIMI 的理解基本就脱离了照着抄的阶段。更进阶的玩法还在后面等着香蕉武器教程讲怎么从零搓一把自定义武器Guides/CN_BananaWeaponWalkthrough.md特效教程教你怎么改技能颜色甚至做颜色循环动画Guides/CN_EffectModdingTutorial.md。想拿脚本和教程源码git clone https://gitcode.com/gh_mirrors/gi/GI-Model-Importer即可Tools 目录下的脚本随意使用在项目里用了记得注明出处就行。第一次成功把帽子摘掉、把喜欢的角色模型塞进游戏的那一刻你会觉得前面踩的坑都值了。动手吧从莫娜那顶帽子开始。【免费下载链接】GI-Model-ImporterTools and instructions for importing custom models into a certain anime game项目地址: https://gitcode.com/gh_mirrors/gi/GI-Model-Importer创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
