AI2U Waifu Swap Tutorial (Beta)

Step 1: Launch the Mod Tool

1. Update AI2U to V.0.7.1.10 or newer

2. Click Play in Steam

3. Select Waifu Swap Mod Tool 

Step 2: Prepare Your Model

1. File format: FBX

2. Must be a humanoid character

3. Must include the standard body joints (arms, legs, head, etc.)

Tip: If your model already works with humanoid animations, you’re probably fine.

Step 3: Import & Assign Joints

1. Click Import and select your FBX file

2. Click Auto Assign

3. Make sure all joints turn green

Tip: If something is red, fix it using the dropdowns.

Step 4: Generate Avatar

1. Click Generate Avatar (top right). Your character should now move correctly.

Step 5: Adjust Size & Test Animation

1. Enable NPC Reference

2. Adjust Scale until it matches the reference NPC

3. Choose an animation (e.g. Dance)

4. Click Play Animation. If it looks wrong, go back and fix the joint assignment.

Step 6: Export or Upload

Click Export, then choose ONE of the following:

Option A: Save to Local (Recommended for Beginners)

• No Steam required

• Good for testing

• The mod is saved to your computer

Option B: Publish to Steam Workshop

• Uploads your mod to Steam

• Other players can subscribe

Advanced option:
If you enter a File ID, your upload will replace an existing Workshop mod.
Only do this if you know exactly what you’re doing.

Step 1: Subscribe

1. Go to the AI2U Steam Workshop page

2. Click Subscribe on a mod you like

3. Wait for Steam to finish downloading

If the game is already running, restart it.

Step 2: Apply the Mod In-Game

1. Launch AI2U

2. Go to Main Menu → Mod (Beta)

3. Select a mod from the list

4. Choose which levels it should appear in

5. Click Apply 

1. Forgetting to restart the game after subscribing

2. Publishing to Workshop when you only wanted to test

3. Entering a File ID without knowing what it does

4. If you’re unsure, Save to Local first.