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) (Windows)

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) (Linux w/ Wine/Lutris)

This is partially lutris specific, but you in no way need to use lutris.

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. Extract 3dmigito folder from the zip file to anywhere you want. Put in home folder or games/mods whereever. This will be a "semi" permanent location to where the 3DM Loader will be and the associated Mods folder. Tip: You should not extract this in your Genshin Path prefix folder, as it could be overwritten by launchers or game updates.

3. 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: . You should default to target = GenshinImpact.exe and only switch to hardcoded z:\ or c:\ paths if you want to tinker. The process should be found by your wine prefix.
   Comment out the line 'require_admin = true'. As it is not needed. Put a ; in front of it.

4. Open lutris and add a "Locally Installed Game". Set the Name to GIMI (or whatever you want), set the Runner to wine. In "Game Options", set the Executable to the 3dmigoto Exe you extracted. Set the working directory to the folder 3dmigoto and your Mods folder resides in.
   Wine prefix: You have some options, such as using a new prefix, but you can set this to the same prefix path your genshin game is installed in.
   Prefix Architecture: Auto (default) Now head over to runner options....
   If you have access to the wine runner from your locally installed genshin, click Browse on Custom Wine Executable and choose the wine64 runner that the local genshin install uses. Else....you may pick your own Wine Version from the drop down, if it doesnt match the one genshin game uses, your results may vary. (Might work, might have to mess around)
   You are done here. Press Save on the top right.

5. Select your 3dmigoto in lutris main play and click play on the bottom right. To open your logs click the dropdown next to the play button and select "Show Logs".

6. Once it says that 3dm is ready from your d3d11 dll, start up genshin. 3DMigoto ready - Now run the game.

7. The script logs willsay successfully attached 3dm and close. It may not always close and leave log output. 3DMigoto loaded :)

8. There are ways to auto run 3dm before starting genshin, but not always reliable. Not including this info here for now.

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!