EN | 中文
Tools and instructions for importing custom models into Honkai Star Rail.
DISCLAIMER: I strongly recommend only using private servers for modding. Using these tools on official Star Rail 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.
SRMI is a version of 3DMigoto/GIMI that I have modified to be compatible with Star Rail. Note that a lot of the files here have been ported over from GIMI and I am in the process of fixing them for Star Rail - many of them might have compatability issues and there may be a few references that still point to genshin resources.
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
Star Rail modding is still recent, so guides are still in progress. Many of the techniques are similar to GIMI, but for more help modding please visit the AGMG discord (https://discord.gg/agmg)
Model files for the importer are located at SR-Model-Importer-Assets
-
Download a 3dmigoto .zip and extract it. I have provided two versions:
- "3dmigoto-SRMI-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-SRMI-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
-
For loading the plugin, it depends if you are on Windows 10 or Windows 11.
For Windows 11, the process of loading 3dmigoto is the same as GIMI - find the target = line in the d3dx.ini and set it to StarRail.exe (target = StarRail.exe
). Then, run the W11Loader.exe as admin.
For Windows 10, you will need to use the modified loader as admin. I have provided an exe called W10Loader.exe compiled from python, but it tends to trigger Windows Defender (since Windows Defender really, really doesn't like exe compiled from python). You can either add it as an exception or run the python script (W10Loader.py, but you need to install the dependencies as well)
-
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):
-
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:
In order to modify game models, you need to also setup your Blender plugins and environment. The 3DMigoto plugin works with Blender 2.80+
NOTE! If using the GIMI plugin, please uninstall that version and use the SRMI plugin instead. They have almost the same functionality, but the SRMI plugin has an additional export option for Star Rail mods.
-
Download and install Blender
-
Download and install the modified 3DMigoto plugin (blender_3dmigoto_srmi.py) from releases. You can install an add-on in Blender by going to Edit -> Preferences -> Add-Ons -> Install, then selecting the .py file.
-
If done correctly, you should see 3dmigoto in the plugin list as well as new options in the import and export menus
Also, if you any questions about modding come join the Star Rail modding discord at https://discord.gg/agmg. The only verification is that you can 3dmigoto SRMI working by following the steps above.
Huge thank you to DarkStarSword, bo3b and Chiri for 3dmigoto!