If you’ve ever wanted to go beyond the limitations of the standard Scratch editor—whether to inject high-quality custom sounds, import HD vector assets, or fix corrupted project files—you’ve likely stumbled upon the need for SB3Utility. This powerful, open-source tool acts as a surgical scalpel for .sb3 files (Scratch 3.0 project files).
In this comprehensive tutorial, you will learn what SB3Utility is, how to install it, and how to perform advanced operations like batch asset replacement, JSON editing, and project repair.
Same as texture workflow. Check in-game for distortion or missing faces.
If you clarify exactly which sb3utility you need, I can provide a complete, ready-to-run tutorial with examples.
For modders of Illusion games like Honey Select, AI Shoujo, and Koikatsu, SB3Utility (or SB3UGS) is an essential, high-powered tool for manipulating Unity assets. Originally developed by Alamar and now maintained by enimaroah, this utility allows you to extract, edit, and replace 3D models, textures, and animations directly within game files.
This tutorial provides a comprehensive guide on setting up SB3Utility and performing common modding tasks. Getting Started with SB3Utility
Before you can start modding, you need to ensure you have the correct version of the tool and any necessary supporting software.
Download: Get the latest stable release (often version 21.0.3 or higher) from the official GitHub repository.
Version Compatibility: While the latest version is generally recommended, some users find that specific older versions (like v21.2) are more stable for certain titles like Koikatsu Sunshine.
Unity Editor: For complex tasks, it is often helpful to have the version of Unity the game was built on (e.g., Unity 5.6.2f1 for Koikatsu). Core Modding Workflows
SB3Utility uses a tabbed interface to manage different asset types. Most operations begin by dragging a game archive (like a .pp or .unity3d file) directly into the program window. 1. Editing and Replacing Textures
Textures are the "skin" of your 3D models. Replacing them is one of the most common ways to customize characters or outfits.
Isolate the Material: Open your .xx mesh file, navigate to the Mesh tab, and identify the "Materials Used" for the part you want to change.
Add New Texture: Drag your new texture file (preferably .bmp or .tga) into SB3Utility. Under the Texture tab, select Add Image. sb3utility tutorial
Apply Change: Go to the Object Tree, find your target material, and update the "Texture Used" field to point to your newly added image. 2. Modifying 3D Meshes
To change the actual shape of an item, you will need to export it to a 3D editor and then re-import it. Digital Girl: Modding - Hgames Wiki
Imagine you have a complex project with 50 sprites named Sprite(1) through Sprite(50). Manually renaming them in Scratch is tedious. Here is how SB3Utility saves you hours.
Warning: If you rename a variable (e.g., score to highscore), Scratch will not automatically update the scripts referencing the old name. Use the Script Editor (Explained in Part 6) to replace text in the JSON.
Could you provide:
Targets are the core components of a Scratch project. They can be sprites, stages, or other objects. Here's how to access and manipulate targets:
# Get the stage
stage = project.stage
# Get a sprite by name
sprite = project.targets['Sprite1']
# Create a new sprite
new_sprite = sb3utility.Target(project, 'New Sprite')
project.targets.append(new_sprite)
SB3Utility (and its GUI version, SB3UGS) is a powerful tool primarily used for modding 3D games from the developer Illusion, such as Honey Select, Koikatsu, and AI-Shoujo. It allows you to extract and replace meshes, textures, and animations within .unity3d and .pp asset files. Essential SB3Utility Workflow Guide 1. Setup & Installation
Download: Get the latest release from the enimaroah SB3Utility GitHub.
Execution: Extract the files and run sb3utility.gui.exe to open the graphical interface. No complex installation is usually required; just keep the folder structure intact. 2. Core Modding Tasks Editing Textures Open a .unity3d file to swap images.
1. Drag the file into SB3UGS.2. Navigate to the texture asset.3. Right-click and choose Replace with your new PNG/DDS. Exporting Meshes Move game models into Blender/Maya.
1. Select the Mesh tab.2. Choose a format like FBX or MQO and click Export. Importing Meshes Add custom models into the game.
1. Drag your edited mesh file into the software.2. Use the Goto Frame tool to identify the target bone/mesh.3. Drag the imported mesh over the target mesh to replace it. Animation Handling Extract or play in-game animations.
1. Open an animation file (e.g., from studio anime folders).2. Set the Path ID to "body bone" to preview the movement. 3. Critical "Pro Tips" for Success If you’ve ever wanted to go beyond the
Always Backup: Before saving any changes, ensure you have a copy of the original asset. SB3UGS often creates an automatic .bak file, but manual backups are safer.
Search and Filter: Use the built-in search tool to find specific assets by name within large bundle files.
Normals and Physics: After importing a mesh, remember to check the Normals under the Mesh tab to ensure lighting looks correct in-game.
Saving Changes: Use Ctrl+S or File > Save to commit your changes to the asset bundle. Troubleshooting Common Issues
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
The most efficient feature for beginners is the ability to directly replace textures or meshes by dragging files into the interface. Quick Tutorial: Replacing a Texture Open the Tool: Run SB3UtilityGUI.exe.
Load Your File: Drag a .pp or asset bundle file from your game directory into the main window.
Identify the Target: Use the Mesh or Object Tree tabs to find the specific item you want to modify.
Import New Image: Drag your new texture (ideally in .png, .bmp, or .tga format) into SB3Utility. Swap and Save: Click on the original mesh in the Mesh tab.
Under the Materials section, select the material and change the Texture Used field to point to your imported image. Go to the File menu and save the modified .pp file. Essential Modding Capabilities
Mesh Export/Import: You can export meshes as .mqo (Metasequoia) or .fbx formats for editing in 3D software like Blender, then re-import them using the Goto Frame function to align them correctly.
Animation Preview: The tool features a Renderer window that allows you to preview animations by linking an animation clip to a character's "body bone".
Asset Cleaning: The Object Tree allows you to "Remove" unneeded parts of a file to isolate a specific accessory or mesh, which is vital for creating lean mods. If you clarify exactly which sb3utility you need,
For the latest updates and advanced features, you can visit the Official SB3Utility GitHub Repository. Using Koikatsu animation files in a Blender asset library
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:
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
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