silentnightsound/gi-model-importer

Tools and instructions for importing custom models into a certain anime game

EN | 中文

Genshin-Impact-Model-Importer (GIMI)

Tools and instructions for importing custom models into Genshin Impact.

DISCLAIMER: I strongly recommend only using private servers for modding. Using these tools on official Genshin servers carries a high risk of being banned. I do not condone the use of these tools and programs on official servers, and take no responsibility for any consequences as a result if you do.

GIMI is a version of 3DMigoto that I have modified to be compatible with Genshin.

Feel free to use or modify any of the scripts on this repo as you wish, though please give credit if you use these programs in your projects. I am continuing to update this page with new features and fixes, so check back often.

Troubleshooting guide: Troubleshooting

For a simple walkthrough of removing a portion of a character mesh using these tools, see Mona Walkthrough. For an intermediate walkthrough of creating custom weapons, see Custom Weapon Modding Walkthrough. For a more advanced example of importing a custom model, see Cybertron's great video walkthrough here and SinsOfSeven#3164 annotated transcript and troubleshooting guide here.

Model files for the importer are located at GI-Model-Importer-Assets

Installation Instructions (3DMigoto)

1. Download a 3dmigoto .zip from releases and extract it. I have provided two versions:

   • "3dmigoto-GIMI-for-development.zip" is a development version intended for creating mods which has all features turned on (including the green text at the top and bottom of the screen) but is slower
   • "3dmigoto-GIMI-for-playing-mods.zip" is a version of the program indended for playing mods which has development features turned off (no green text) but is faster

2. (for V6 GIMI and below; v7 and above does this automatically and you can skip this step) Depending on the location of your Genshin Impact .exe file, you may need to change this line in the d3dx.ini file to point to your own installation (the Genshin game .exe, not the Genshin launcher .exe - the one you want is usually located in the Genshin Impact Game folder). If changing it to your path doesn't work, try using target = GenshinImpact.exe:

3. Double click "3DMigoto Loader.exe" to start the loader, then start up Genshin through the GenshinImpact.exe. If everything is correct so far, 3DMigoto should be injected into the game and you should see a green text overlay (only if using the "for development" version, the "for playing" version does not show the green text):

• Note: some people have reported an issue where the loader lists that it was unable to verify if 3dmigoto was loaded. This does not mean that 3dmigoto failed to inject - if the green text and mods show up, there are no issues and you can close the command prompt

4. Installation complete! You should now be able to load custom resources and override textures and shaders with 3DMigoto. To add mods, place them in the Mods folder (one mod per character at a time) and press F10 to load them in game:

 

Installation Instructions (3DMigoto Blender Plugin)

In order to modify game models, you need to also setup your Blender plugins and environment. The 3DMigoto plugin works with Blender 2.80+

1. Download and install Blender

2. Download and install the modified 3DMigoto plugin (blender_3dmigoto_gimi.py) from releases. You can install an add-on in Blender by going to Edit -> Preferences -> Add-Ons -> Install, then selecting the .py file.

3. If done correctly, you should see 3dmigoto in the plugin list as well as new options in the import and export menus

 

Usage Instructions

See Usage Instructions

Also, if you any questions about modding come join the Genshin modding discord at https://discord.gg/gR2Ts6ApP7. The only verification is that you can 3dmigoto GIMI working by following the steps above.

 

Acknowledgements

Huge thank you to DarkStarSword, bo3b and Chiri for 3dmigoto!

gi-model-importer's Issues

Opening generate command

When I run genshin_3dmigoto_generate.py, it instantly closes. I'm assuming that's not suppose to happen?

can you add characterdata alternate outfits files on github?

GI 3.3 server mona capless not working

Hey, I have try "MonaBottomHeavyCapelessMod(CN)" in genshin impact 3.3 server and that not working but "MonaBottomHeavyMod" working. Any idea to fix it?

把一个角色身体一部分替换到另一个角色身上时,游戏内模型错乱

我把一个角色身体的一部分复制到另一个角色身上,并且缝合得很完美,在blender里看很正常,但当我在游戏中加载它时,模型却是错乱的。

可否根据血量变化来切换模组

有一个想法，希望能实现根据血量变化来切换mod,血量变少则自动切换到衣服少的mod。有个简单的构想是获取血条上某像素点的颜色，然后根据红、绿判断来切到对应mod，效果有点像战斗中爆衣。一个突发奇想，跟大大分享一下

请问hash_info.json是什么？

本人是个小白，网上找了一大圈也没有找到答案，实在不知道该怎么办了QAQ

，

can i add files for outfit/skin on this github?

hello! maybe if you guys can allowed me
i want add some outfit/skin files genshin 3dmigoto(original not modded) on this github

i extract this using 3dmigoto dump

if you guys can allowed me to upload the files on here i would really appreciate that but if you guys didn't allow that's okay @SilentNightSound

Nilou Reflection Normal Map Bug

Nilou's model uses a normal map unlike most other characters which seems to be under ps-t0 but that's also the texture used for the reflection colour map, setting the diffuse to ps-t0 fixes the reflection but then introduces lighting issues on the model itself.

Why is "Yelan" not in the "CharacterData" folder?

Why is "Yelan" not in the "CharacterData" folder?

疑惑

作者这么精通，却只看见了您把帽子去掉的模组🤔这是为什么?

(Not an issue)Write more information about how to re-apply the alpha channel in "MonaWalkthrough.md"

I would really appreciate it, thank you!

Is it possible to share how the mechanism works?

Hello, first thanks for making & sharing of this amazing tool!

I'm trying to understand how the model swap feature of this software works, but I'm having trouble figuring it out. And Google doesn't help. Could you provide some more information or documentation on its underlying mechanism? Thank you!

导出时Blender报错

Python: Traceback (most recent call last):
File "C:\Users\Administrator\AppData\Roaming\Blender Foundation\Blender\3.2\scripts\addons\blender_3dmigoto_gimi.py", line 2121, in execute
export_3dmigoto_genshin(self, context, object_name, vb_path, ib_path, fmt_path, self.use_original_tangents)
File "C:\Users\Administrator\AppData\Roaming\Blender Foundation\Blender\3.2\scripts\addons\blender_3dmigoto_gimi.py", line 1267, in export_3dmigoto_genshin
stride = obj['3DMigoto:VBStride']
KeyError: 'bpy_struct[key]: key "3DMigoto:VBStride" not found'
2.92，3.2都会出现这样的问题

When can I modify the face?

When can I modify the face?

Windows 10 IME suggestion list cannot be displayed, when using the Microsoft Pinyin IME(Chinese) with GIMI running.

Hi
I found that Windows 10 IME suggestion list(Chinese) is blank when using in-game chat via GIMI running.

1. With GIMI running, the IME suggestion list is blank:

2. Without GIMI run, the IME suggestion list works well:

I'm not sure this is a reproducible issue, and is it possible to be fixed in future? Thank you.

Another instance open bug?

Even after restarting my computer, this pops up, this is also my first time modding, and not sure how to fix it, please help.

Blender报错

Can't work with Ver.3.2(China mihoyo ver.)

I am sure that I have completed all the operations in readme, and I really use the development version. But in fact, green text did not appear. The model in the game has not changed, even after I press the F10 key. During the GIMI startup process, I did not see any abnormal prompts. This makes me very confused. Is it that GIMI can't work properly in the computer of AMD platform?

Not rlly an issue

Could you say how we can get the character data ourselfs?

(Dumb question) How can I run it with Cultivation?

ui

can we replace ui like special k does it?

请问目前可以实现两个角色的模型互换吗？

能否把Ganyu的mod安在RaidenShogun角色身上呢？以实现Ganyu的mod可以使用RaidenShogun角色的动作和技能。

能否添加模组管理功能

单一角色有多个mod，可否加上一个选择

NilouMod bugs

mod download link:https://gamebanana.com/mods/418608
Nilou charactor model broke after I use mod above with 3Dmigoto

为什么没有女士的模组

Doesn't work after wanderer update

Hi, i have a problem with GIMI not working anymore after the recent update.
It says that it found the process, then the window closes and genshin turns on, so everything as it should. But once in game there's no green text, mods aren't loading. And it used to work before.

Things i've tried:
Running as Admin
Checking the file path, also changing target to just GenshinImpact.exe
Moving the migoto folder into the game folder
Pressing F10 ingame
Both versions for playing and for development
Clearing ShaderCashe and ShaderFixes folders
Removing mods from the mods folder

The only thing the console gives me is "Unable to verify if 3dmigoto was succesfuly loaded: 5" and "Unable to verify if 3dmigoto was succesfuly loaded: 299"

It used to work before the update (although i had to open the game twice for it to load for some reason)
Could it be because i'm on Win7 and it uses some dll or directx things that aren't in it?

Edit: Updated my system to win10 and everything works now.

Export Genshin Mod folder

不好意思 上次問問題用了您傳的連結
現在跳了新的錯誤

並且只產生了

並沒有教學裡面的資料夾，請問問題為何
謝謝

已正确配置游戏路径，3DMigoto Loader.exe莫名闪退

在输出几句如图中所示语句后，程序闪退

Blender export Genshin mod folder

抱歉打擾了 當我在進行 export的時候 不知為何都會出現這個，是我的python版本問題嗎，還是我的插件載的是錯誤的，又或著是其他問題，這個問題困擾我很久了，如果可以的話請幫幫我 ， 非常感謝

Constant frame stuttering

Anytime I run the game with this enabled I get horrible frame stuttering. It's like every 10 seconds the game will freeze for a solid second. Has anyone else experienced this and if so does anyone know how to fix this?

skins not loading

i did everything it says but it cant load skin, changed the location and there is green text on the screen

about android version

will it have an android version?

雷莹术士和镜女mod出现了bug

在打开mod（h的）后，远离她俩，她们就会恢复原有皮肤，而且将镜头转向她们时画面就会直接卡住，镜头转移开就会恢复

problem with favonius sword mod

Make it only client side

So mihoyo doesnt detect u and you can enjoy your free skin lol

未见过的报错

我将原神的路径正常调换了，并且正常打开3dmigoto。

但在打开原神之后跳出了错误码：Checking if 3DMigoto GIMI was successfully loaded: 299

有时后该错误甚至会在显示了游戏路径之后出现

Exports genshin mod

Hello,I had some problems,This is normal do?help me,please.
您好，我遇到了一些问题，这是正常的吗？请帮帮我，祝您身体健康。

3dmigoto not compatible with 3.0?

I was going to test 3dmigoto with genshins beta version and it doesn't work in any way doesn't show green text or anything even inputting the games path at d3xd file

mirroring issue

If i use a custom model the model is mirrored in game, if i mirror it in blender it goes all broken ingame, can i fix that?

GenshinImpact.exe (35120): Unable to verify if 3DMigoto was successfully loaded: 5 error :')

hey! i followed all the rules and changed the d3dx.ini to my folder but it says GenshinImpact.exe (35120): Unable to verify if 3DMigoto was successfully loaded: 5 its loaded on my game but it says stereo disabled

discord链接失效

Effects not turning on

Using gura skin but the effects doesnt activate although i pressed "V"

Can we replace face models?

failed to load custom textures

i'm not sure why this happens, but my guess is on the ini file and the match_first_index = 0 might be causing it, is there a fix for this?

How to remove the shadows

Could you tell me in detail aboult #13 of Mona Hat Removal Walkthrough,I don't know how to remove the shadows.
老铁，莫娜帽子移除教程的第13条去除阴影是怎么做到的，能详细讲讲吗。
https://github.com/SilentNightSound/GI-Model-Importer/blob/main/Guides/MonaWalkthrough.md

?

Well, when I want to load my mod by pressing F10 It just does nothing
Maybe i fucked up with something idk
update: nvm

If the mod folder is named in Chinese, it will not load after merged

For a single mod there is no such problem, is this due to the merge script or is it due to 3dm?

当点击“exports genshin mod folder”时报错

我把最新的PlayerCharacterData文件夹下的Ganyu文件夹下的txt文件全部导入至最新版本的blender_2.92软件中（blender已经安装最新的插件），然后没有做任何模型的修改，直接点击导出，但是给我报了一个错误，无法找到"untitledHead.fmt“文件。

need some help with genshin_3dmigoto_collect.py

Looking for most recent frame dump folder
Found! Folder: FrameAnalysis-2022-07-02-104119
Creating output folder
Traceback (most recent call last):
File "G:\GenshinImpact_2.7.54_beta\genshin_3dmigoto_collect.py", line 328, in
main()
File "G:\GenshinImpact_2.7.54_beta\genshin_3dmigoto_collect.py", line 46, in main
if not os.path.isdir(character):
File "C:\Program Files\Python310\lib\genericpath.py", line 42, in isdir
st = os.stat(s)
TypeError: stat: path should be string, bytes, os.PathLike or integer, not NoneType

Is it possible that merged mods switch only the current character?

Now all characters using the same key will be switched together. Can you provide an option to control whether to switch together or not?