Tutorial

Waifu Swap Mod

EXPERIMENTAL

This official guide walks you through AI2U's mod feature, which allows you to replace in-game NPCs with your own rigs. Players can import custom models and mapper configurations to modify the appearance of the catgirl, witch, and hologram in all three levels and the Atrium.

Modding is a beta feature in AI2U, which means that bugs and unexpected issues may occur. For questions or help troubleshooting, contact support@alterstaff.io. Meanwhile, welcome to share your thoughts or requests in our Discord Server.

Remember: Only the NPCs' appearance will change—their yandere nature is always there! Mod responsibly and have fun.

Getting Started

Find the Mod (Beta) button in the main menu.
This feature supports model replacement for all three levels.
To use your custom model, enable "Use imported rig in this chapter."

Ideal Scenario: Using a Custom Model with Auto-Rigging via Mixamo

The best approach is to:

Upload an unrigged model to Mixamo.
Use Mixamo's automatic rigging, placing markers as directed. This process aligns with the Upload a custom character section in Mixamo's rigging tutorial.
Download the rigged model from Mixamo.
Then, select "Use Pre-Set Avatar Mapper and upload the file" in our game.

Alternative: Using a Custom Model with Your Own Rigging

Alternatively, if your rig uses a custom format, you can upload your own bone mapping file, by clicking the purple upload button. Refer to our example for the .json file.

You can also click this button to review the uploaded mapper file and ensure it was imported correctly.

Note that:

The "Custom Avatar Mapper" is currently experimental and we're going to improve it and subject to change.
Advanced modders can attempt this, but results are not guaranteed, and our team cannot provide support.

Model Scaling

Imported models will automatically match the default NPC height.
To adjust size, enter a custom value in the "Scale" field. Values above 1 increase the model's size relative to in-game NPCs.

If successful, your chosen model will appear in the selected levels and can be called to the hub world.

IMPORTANT NOTES

Only the NPCs in our game are moddable. Do not attempt to modify other features in the game; we cannot guarantee a fix if you follow unofficial instructions.
Mods are "at your own risk" — we cannot support or guarantee compatibility with mods. Modding may impact performance or stability, so you may need to un/reinstall the game or start over if issues occur. We recommend backing up save files before using mods.
Before sharing your mods in any community or public channels, check the mod-posting guidelines to ensure yours complies.
If you did not create the custom model, ensure you have the necessary usage rights and credit the source accordingly.
Creating and using mods means you accept our modding guidelines and Terms of Service. We reserve the right to remove or restrict mods that violate them.

Page updated

Report abuse