Genshin Impact Model Importer (GIMI) V6.0  

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. 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

Version 6.0 of GIMI (Genshin Impact Model Importer) released!

Features:

• Vertex limits automatically raised for objects! V6.0 adds a new override type called VertexLimitRaise which tells the program which objects to increase the vertex limits for - the plugin and generate scripts handle this automatically, so you don't need to worry about setting it yourself as long as you are using the most up-to-date tools.

  • Note that limits can only be raised when that object is first loaded in-game, so you may have to unload and reload an object for the new limits to apply (e.g. swapping a character in and out of the party, or teleporting away and back). Worst case, just restart the game after adding a new mod to the Mod folder for any new limits to apply.

• Blender plugin now supports versions 2.93+! Based off the update done by MicroKnightmare from the DOA modding forum, and merged with the current script. The plugin should now work for any Blender version up to current.

• Better defaults for scripts! The blender plugin now automatically handles several common mistakes such as misnaming the export file and forgetting to name uv coordinates correctly.

• Fixed issues with the 3dmigoto loader failing to inject into games. Some people were reporting that the window was closing before the dll was injected, so I have increased the time delay to a few seconds which should hopefully fix the issue. Also improved the logging messages.

• Several bug fixes in the collect, generate and blender plugin scripts. Most notably, the overlapping face hash issue has been resolved so you should no longer get warnings when changing face textures for any models generated with the new scripts.

• Collect script now able to dump objects with mismatched vertex counts, as well as partial support for those weird objects which have 4D normals. Also more detailed logging messages and better error handling. If you are still having issues, try using --force on different listed relevant draw ids to see if any have better properties for scraping.

• Partial support for new version models. The collect script can now dump models that have normal maps by using the -has_normalmap flag. Still looking into ways to automatically identify texture maps.

For anyone who just wants to play mods, grab 3dmigoto-GIMI-for-playing-mods.zip. For anyone looking to develop, get the 3dmigoto-GIMI-for-development.zip and blender_3dmigoto_gimi.py to start.

Download:

3dmigoto-GIMI-for-development.zip
3dmigoto-GIMI-for-playing-mods.zip
blender_3dmigoto_gimi.py
genshin_3dmigoto_collect.py
genshin_3dmigoto_generate.py