Tutorial

Waifu Swap Mod

EXPERIMENTAL

The Mod (Beta) feature enables users to replace the game’s original humanoid models with custom ones, providing players with flexibility to personalize their in-game experience.

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 in the #waifu-swap-mods channel.

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

Overview Steps

(Optional) Prep your custom rig for the Mod Tool
Joint Assignment With the Mod Tool
Import Mods into AI2U

Step 1. Prep your custom rig

We highly recommend that you prep your custom rig before using the external Mod creation tool.

Supported model file type: FBX
Name the joints

In the Mod Tool, we are using the following 19 joints. For the best results, make sure your rig includes all of these joints and that they’re properly named. The more accurate the joints are named, the better the result from the auto assignment function.

1. - Hips
  - Spine
  - Chest
  - Neck
  - Head
  - LeftShoulder
  - LeftUpperArm
  - LeftLowerArm
  - LeftHand
  - RightShoulder
  - RightUpperArm
  - RightLowerArm
  - RightHand
  - LeftUpperLeg
  - LeftLowerLeg
  - LeftFoot
  - RightUpperLeg
  - RightLowerLeg
  - RightFoot

Step 2. Joint Assignment with the Mod Tool

Before you start:

Download the Mod Tool from the links below:

a. Google Drive- Windows Build (Recommended for players outside Mainland China): Link

b. 百度网盘 - Windows Build (Suggested for users in Mainland China): Link, Access code: tubg

The Mod Tool we developed currently only works on PC.

Open the Mod Tool
Click the ‘Import’ button located at the upper-left corner and select your model file from your computer.

3. After the rig loads in the viewport, you can assign the joints using one of two methods:

a. Auto Assigning: Click the Auto button to assign the joints automatically.

b. Manual Assigning: Use the dropdown menus to match each joint to the correct body part.

Unselected joints show a red indicator and selected joints show in green. The color doesn’t indicate whether you’re correctly assigned; it’s simply a reminder of whether a joint is selected for each body part.
Use the ‘Clear’ button next to each dropdown to reset your selections quickly.
A progress tracker on the right side under the console shows the number of joints remaining unselected.

If you are satisfied with the result, click ‘Generate Avatar’ located at the right hand side of the viewport. Then, click ‘Export’ located at the upper-right corner.

To test the joint assignment, select the ‘Dance’ button under the animation preview section and then click ‘Play Animation’ (upper-right of the viewport). Your custom rig will play a simple dancing cycle.

The Modded model would be exported to

a. C:\Users\[YOUR USER NAME]\AppData\LocalLow\AlterStaff\AI2U - With you til the end\AI2U_Mod_Exports\

b. Replace [YOUR USER NAME] in the path with your Windows username, and paste the path into the FIle Explorer address bar to locate the folder

You can rename the exported folder (in this case, "AI2U_Mod_Exports") to any name you prefer, and this name will appear in the in-game Mod Page.

Do not edit or remove any files in this folder, or the mod might malfunction or fail to load. Do not manually edit or delete any files in this folder, as it may cause the Mod to fail to load properly.

Step 3. Importing Mods into AI2U

Before you start:

Make sure you are finished exporting the folder from the previous step
Copy and paste your exported folder(s) to
C:\Users\[YOUR USER NAME]\AppData\LocalLow\AlterStaff\AI2U - With you til the end\Mods\
Check if your game is up-to-date. Version number: V.0.5.8 (or newer)

1. In the main menu, click the ‘Mod (Beta)’ button

2. All imported files under the assigned folder should be listed in the panel.

You can also import external Mod folders by clicking the ‘Import’ button on the upper left corner.

3. Preview the Mod. To preview, select a Mod that you want to apply from the list by clicking the ‘Preview’ button. A preview panel will appear at the right hand side.

4. Apply Mod to Levels

a. Under Level Selection in the preview panel, Check the boxes for the levels where you want to apply the Mod. (You can select multiple levels.) Then, click the ‘Apply’ button at the lower right corner of the preview panel.

b. To remove a Mod, click ‘Delete’ in the lower left side of the preview panel.

5. Revert to the Original Model

a. Click ‘Reset All’ (next to the ‘Import’ button) to undo all changes made on the Mod page.

b. If you only want to adjust a specific Mod, click ‘Preview’ for the Mod you’re using and uncheck the boxes for any levels where you no longer want the Mod applied. Then click ‘Apply’ to confirm your selection.

6. Click the ‘Close’ and start the game as usual. Your modded rig will replace the original rig in the selected levels.

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