Sb3utility Tutorial [patched] Info
SB3Utility (often abbreviated as SB3UGS) is a powerful asset manipulation tool primarily used for modding games developed by Illusion, such as Koikatsu, Honey Select, and AI Shoujo. It is considered essential for modders because it can modify asset bundles directly rather than just extracting them. Core Functionalities
Asset Extraction & Modification: Allows users to extract and edit meshes, animations, textures, audio clips, and scripts from game files like .pp or .unity3d.
Asset Bundle Manipulation: It is one of the few tools capable of modifying Unity asset bundles, which is critical for porting custom models into games.
Editor Interface: The GUI features specific tabs for different asset types, including Meshes, Materials, Textures, and Animations. Basic Tutorial Steps
Preparation: Download the latest version from the SB3Utility GitHub repository.
Opening Files: Run SB3UtilityGUI.exe and drag-and-drop the desired game file (e.g., a .pp or .unity3d file) into the program window. Editing Textures: sb3utility tutorial
Navigate to the specific texture path within the asset bundle.
Export the existing image, edit it in software like Photoshop (maintaining file type and dimensions), and then replace the original file within the utility. Editing Meshes:
Select the mesh from the Mesh tab and export it, often in Metasequoia (.mqo) format for editing.
After editing, drag the new .mqo file back into SB3Utility and use the "Goto Frame" function to align and replace the original mesh.
Saving Changes: Use File > Save or the shortcut Ctrl+S. The tool typically creates a backup automatically. Key Considerations for Beginners SB3Utility (often abbreviated as SB3UGS ) is a
Backups: Always back up your original game files before attempting any modifications to prevent game instability.
Tool Complexity: SB3Utility is more complex than other extraction tools like AssetStudio, but it offers deeper control for advanced modding tasks like rigging and material editing.
Unity Compatibility: For modern Illusion games like Koikatsu, SB3Utility is often used alongside Unity Editor 5.6.2f1 to ensure full compatibility with the game's engine version. Honey Select UI Modding Tutorial
Part 4: Workflow — Importing Assets (Modding)
This is where you put your custom content back into the game. This is usually done to replace an existing outfit with a custom one.
**1.
5. Tutorial Part 1: Replacing Costumes (High-Resolution Images)
Scratch limits imported images to certain dimensions. SB3Utility bypasses this.
Part 3: Basic Tutorial – Extracting All Media from a Project
Scenario: You created a game on Scratch and want to use a specific sound effect in a professional video editor, but you lost the original MP3.
Step-by-step:
- Open the SB3 file: In SB3Utility, navigate to your
.sb3file using the left Explorer panel. Double-click it. - View the structure: The right panel now shows a tree:
Project>Stages>Sprites. - Navigate to assets: Expand
Sprites>Sprite1>Sounds. - Export:
- Right-click the sound file (e.g.,
Meow.wav). - Select Export.
- Choose a destination folder on your PC.
- Right-click the sound file (e.g.,
- Repeat for costumes: Navigate to
Costumesand export the SVG or PNG files.
Pro Tip: To export everything at once, right-click the root Project node and select Export All Assets. This saves every sprite, script, sound, and costume into organized folders.
5.3 Re-import the Mesh
- In SB3Utility, right-click the original mesh >
Import. - Select your edited
.obj. - Ensure the log shows no errors about vertex count mismatch.
Example Use Case: Generating a Project Programmatically
Here's an example of how to generate a simple Scratch project programmatically: Open the SB3 file: In SB3Utility, navigate to your
import sb3utility
# Create a new project
project = sb3utility.Project()
# Create a new sprite
sprite = sb3utility.Target(project, 'Hello World')
project.targets.append(sprite)
# Create a new block
block = sb3utility.Block('looks_say', 'MESSAGE': 'Hello, world!')
sprite.blocks.append(block)
# Save the project
project.save('path/to/hello_world.sb3')