If you’re wondering how to run them, just use them like any other Python script. On Windows, you typically either right-click the .py file and choose “Run with Python,” or open Command Prompt/PowerShell and type:

That said, I’ve only tested these on my MacBook, so I can’t guarantee they’ll run flawlessly on Windows. Also, most of this code was generated with the help of AI, so if something doesn’t work, it might not be the most efficient use of my time to debug it—consider that a heads-up.

For reference, it probably won't work on Termux.
Before I go over the tools, let me share a few useful things to know.

Member Scale​

Thigh Scale​

• ScaleX 1.0
• ScaleY 0.941748
• ScaleZ 0.932695
• ScaleX 1.0
• ScaleY 1.03884
• ScaleZ 1.0577

Skin Tone​

• bright : Guilty Kiss, AZUNA, eli, nico, dia, ai, emma, shioriko, mia
• default : CYaRon, Printemp, umi, maki, kanan, hanamaru, kasumi, karin, kanata, rina
• slight : nozomi, lanzhu
• medium tone : rin

FYI, a lot of the explanation below was written by AI, so please keep that in mind.

1. breast_size_changer.py

​

Summary:
Batch adjust the scale values of character breast GameObjects in SIFAS AssetBundles using an intuitive GUI. Enables precise x/y/z scaling or additive scaling to achieve consistent model resizes.

Usage:

• Specify input/output directories, filename filters, and scaling values.
• Target the breast GameObject by name and set scaling values directly or as increments.
• Supports both single and batch file processing.

Cautions:

• Modifies asset transforms directly—always backup originals before use.
• Models may deform if values are set inconsistently or outside expected ranges.

2. breast_dyna_changer.py

​

Summary:
This GUI tool modifies ‘breast jiggle’ physics (SwingBone parameters) on SIFAS AssetBundles in bulk. You can batch-target bones (like LeftBreastDyna/RightBreastDyna), adjusting stiffness, drag, and angular motion limits per-character or globally, with support for scalable 'jiggle’ profiles mapped by character.

Usage:

• Select individual bundles or entire folders for batch processing.
• Configure target bone names, set physical coefficients, and decide on per-character scaling (for automatic profile assignment).
• Run adjustments and inspect results in an interactive log window.

Cautions:

• Requires UnityPy and Pillow; will try to install if missing.
• Incorrect settings may result in unnatural or broken animations in-game. Experiment on test files before large-scale application.
• Group edits may not suit all characters; always preview results.

3. skirt_length_changer.py

​

Summary:
Batch tool for adjusting live skirt length and volume in SIFAS character models by modifying scaling values of relevant nodes. Supports both absolute and additive scaling and precise targeting by GameObject pattern.

Usage:

• Use GUI to specify input/output, patterns, scaling (x, y, z), and increments.
• View detailed logs listing all matched and modified assets.
• Suitable for fine-tuning model proportions in a controlled way.

Cautions:

• Changing skirt node scales can generate clipping or animation errors; check in-game after major changes.
• Ensure patterns match only intended GameObjects to prevent bulk errors.

4. Upleg_SwingCollider_changer.py

​

Summary:
Tweak or batch-modify swing collider parameters (radius/offset) for upper-leg colliders in SIFAS/SIFAC AssetBundles. Allows radius/offset setting, increments, and min/max clamping for bulk consistency in collider behavior.

Usage:

• GUI enables selection of single files or batch folders.
• Configure names/patterns (e.g., LeftUpLeg, RightUpLeg), set or increment parameters, and specify clamp limits.
• Inspect detailed logs after processing.
• Think of it as adjusting how close the skirt can get to the thighs.

Cautions:

• Collider parameter changes affect game physics and animation collision detection—test modified bundles in-game.
• Clamp ranges prevent extreme values; use them to ensure physical plausibility and stability.
• If the value is too large, the skirt can lift up even when there's quite a bit of distance between the legs and the skirt when lifting their legs. If the value is too small, the upper thighs or buttocks can clip through the skirt (though not often, and usually just briefly).

5. hips_size_changer.py

​

Summary:
Modifies the hips' scaling in SIFAS models via LiveCoreMemberNodeScaling entries in AssetBundles. GUI allows for absolute or relative size changes, batch or single-object operation, and log review.

Usage:

• Define the target GameObject name (default: “HipsSize”).
• Input new scaling or increments as needed.
• Run for single files or directories in batch mode.

Cautions:

• Like other transform editors, can potentially deform rigs if values are unreasonably set.
• Always validate output in-game and keep backups.

6. texture_batch_importer.py

​

Summary:
Batch-injects (or replaces) textures into SIFAS AssetBundles based on image file name matches and chosen texture format. Fully supports batch operations with recursive folder scan and tree preservation.

Usage:

• Select AssetBundles and the image root directory.
• Choose output bundles/folder and set output suffix if needed.
• Pick from numerous supported Unity texture formats (or keep original).
• Preview matched textures in the GUI before committing.

Cautions:

• Requires UnityPy and Pillow.
• Only injects textures if names match exactly—double-check image file naming.
• Overwriting textures may cause asset breakage if image resolutions or formats are incompatible.

7. sifas-assetbundle-renamer-by-texture.py

​

Summary:
This tool provides a GUI for batch-renaming SIFAS (School Idol Festival All Stars) Unity AssetBundle files according to their internal body texture names. It is designed to help modders keep their asset naming consistent and automated, especially when handling character body part textures.

Usage:

• Launch the tool and use the file selector to pick the target AssetBundle files.
• Options allow users to include costume IDs in filenames, remove special characters, and enforce length limits.
• The tool auto-detects texture names, assigns character and costume info, and applies naming conventions based on internal SIFAS patterns.

Cautions:

• UnityPy is required; the script attempts automatic installation but may require manual intervention if permissions are lacking.
• Only works reliably for AssetBundles containing standard SIFAS body texture naming patterns.
• Be careful not to overwrite original files—use backups if needed.

8. unity_costumemod_packer.py

​

Summary:
Comprehensive packaging tool for SIFAS costume mods with auto-detection for Rina (character 209) paired mods. Extracts body textures, generates moddesc/thumbnail, zips everything in a clean installable package, and supports batch processing.

Usage:

• Add AssetBundles (supports both masked and paired unmasked Rina mods).
• Set thumbnail size, output settings, and whether to detect IDs automatically.
• Batch process to generate .zip mod packages ready for sharing or personal use.

Cautions:

• Dependencies must be satisfied (UnityPy, Pillow).
• Be careful using batch mode with unrelated files to avoid packaging errors.
• Double-check Rina paired files to ensure correct matching.
• For Rina, it will only work after you run sifas-assetbundle-renamer-by-texture.py. Specifically, it only works if the name starts with 209rinaunmasked or 209rinamasked and the rest is identical.
• If you’ve done SIFAS modding before, you probably already know this, but special characters aren’t allowed in Unity file names.

9. assetbundle_Ios-Apk_batch_import.py

​

Summary:
Automates batch importing of patch/donor AssetBundles (e.g., from iOS to Android) using pathID intersection and selective copy in UnityPy. Essential for cross-platform modding, asset migration, and structure repair.

Usage:

• Point the tool at donor and target directories, set an export destination.
• Configure filters for types, pathIDs, and MonoBehaviours to include or exclude.
• Optionally set name-matching patterns and script class exclusions for fine-grained control.
• Start the pairing/import process; logs detail exactly which assets were paired and replaced.
• For items like ch_co_head, ch_co_head_rim, dropshadow, and foot_shadow_Plane, I’ve set them to be excluded to prevent incorrect behavior.
• For SwingBone and SwingCollider, you can include them if you want to initialize swingbones such as jiggle.

Cautions:

• Only works if pathID structure is compatible between donor and target bundles.
• May produce ambiguous pairings if coverage thresholds are not adjusted correctly—check logs for conflicts.
• Advanced filtering is powerful but can accidentally omit needed assets if misconfigured; always review results.

10. costume_addon_installer.py (termux batch function patched)

Summary:
I’ve implemented a Termux batch feature in costume_addon_installer. It performed well across several tests; however, as a precaution, please make a habit of backing up regularly.

Usage:

• If you wish to add multiple items, provide comma‑separated indices such as 1,4,5, or enter ALL to include every item in the list. Any costumes that already exist will be skipped automatically.
• Aside from that, it should be the same as the original costume_addon_installer.py.
• See the link below for how to replace costume_addon_installer.py.
• https://ayakamods.cc/mods/sifas-tools-clone-costume-backup-camera-timeline-replacer.1096/

Cautions:

• I don’t use SIFAS on Android, so my checks were just a handful of Termux tests, which isn’t enough to call it fully vetted.