SB3Utility is an essential modding tool for several 3D games developed by Illusion, including Honey Select, PlayHome, and AI Shoujo. This paper provides a step-by-step tutorial for using SB3Utility to extract, replace, and manage game assets such as textures, meshes, and animation data. It covers installation, basic operations, common workflows, and troubleshooting tips, aimed at beginner-to-intermediate modders.
import sb3utility
This is the most common workflow for replacing character parts or outfits. Open the File : Drag and drop a file into the "Files" tab. Locate the Mesh : In the tree view, navigate to the tab and select the specific model part you want to edit. Export to 3D Software In the right-hand mesh editor, choose Metasequoia (.mqo) as the format. and save the file to your computer. Edit the Mesh sb3utility tutorial
SB3Utility (also known as SB3UGS) is a versatile modding tool used primarily for games from developers like Illusion (e.g., Honey Select, AI Shoujo, Koikatsu). It allows users to manipulate meshes, textures, animations, and scripts within game asset files. Top Feature: Drag-and-Drop Asset Swapping import sb3utility This is the most common workflow
Warning: Invalid JSON will corrupt your project. Always make a backup before manual editing. Export to 3D Software In the right-hand mesh
Fixing Visual Errors: Correcting "Normal" vectors or fixing bone selection issues that cause models to look distorted in-game. Resources for Further Learning
9. Troubleshooting Common Errors
| Error Message | Likely Cause | Solution |
|---------------|--------------|----------|
| MD5 collision detected | You replaced an asset with an identical MD5 (rare) | Use a different file or force a small change (e.g., add a transparent pixel to an image). |
| Cannot read project.json | Corrupted ZIP or invalid JSON | Try opening with 7-Zip manually. If you see garbled text, the file is corrupt beyond repair. |
| Asset not found in Scratch | You replaced an asset but didn't update references | Go to Tools → Rebuild Asset Index and resave. |
| File too large | Sound >10MB or Image >5MB (Scratch limit) | Compress your file outside SB3Utility, then re-import. |