Repository navigation
Releases: Krislyz/KAT-Tools
Releases · Krislyz/KAT-Tools
Release list
KAT v0.2.0
Added
- Refit clothes: put an outfit made for another avatar on yours. Skeleton fit, surface fit, weights and binding to your rig, in one press, with a progress bar. Cloth inside the body is pushed out, tight cloth is drawn on, loose cloth is left loose, and hems and collars come out clean. Trousers and other tight clothes stay smooth at the waist: a hidden cap or pocket bag inside the body is left alone.
- Refit keeps layers apart: every garment is stopped by the ones fitted under it the way the skin stops it, so a jacket does not sit inside a shirt. What was tucked in (a shirt hem in trousers) stays tucked in.
- Refit keeps hard parts hard: shoes, helmets, bags, ties, buckles and badges keep their shape and move as one block, onto the body and over the clothes under them. A belt, a frill or a cuff that is a piece of its own rides along with the cloth under it.
- Refit settles each garment with Blender's own cloth after the fit: stiff, held to the shape it has, colliding with your skin, so a suit stays a suit. Only cloth lying near the skin is settled, linings and loose cloth are held. It never pushes cloth into the body, blendshapes are left alone, props and hard parts are skipped, and a result that comes out torn is smoothed or thrown away. Settle with cloth and Stiffness are in the panel.
- Refit can finish the job: hide carried props, list the clothes in layer order, make the fit shapes and switch them on. Each step is optional.
- Unity: right-click a model, a prefab or an object and pick KAT > Send to Blender. It writes the sync file with the materials and textures as they are on that object, ready for Blender to pick up on import. The sync file also says whether each material is opaque, cutout or transparent, so Blender shows a texture's alpha only where Unity uses it.
- Merge armatures merges what matches: a Hips in both is one Hips, the weights go to the base bone and what hung from it hangs from the base bone. Options: keep or fold the extra bones, apply transforms, join meshes, remove unused bones, clean shape keys. Pick the two armatures in the panel.
- Bone merging: pick one chain (an ear, a tail) or all, send the weights to the parents or to the active bone, keep the merged bones, only touch visible meshes. A Delete box for bones without weights (twist and hidden bones can be kept), constraints and empty vertex groups, and Connect bones.
- Missing textures are looked for automatically when a .blend opens and after Refit, next to where the model came from. The Find missing textures button only asks for a folder when something is still missing.
Updated
- The panels follow the order you work in, and related ones sit inside each other: Face (Visemes, Blink & Eyes, Face tracking), Outfits (Refit clothes, Fit shapes), Optimize (Join & weld, Materials & atlas, Textures, Reduce triangles, Bone merging), World (Props).
- Find missing textures and Sync textures from Unity moved to Textures. The panels inside others start open.
- Refit no longer needs the skin to be listed first: it looks for it by name, and the button is always there once the outfit's armature is picked.
- Unity no longer writes the sync file by itself unless you turn it on.
- The Optimization panel is called Optimize.
Fixed
- Sync textures from Unity put the wrong textures on meshes that had been joined or atlased since Unity wrote the file. It now skips them, and skips materials KAT made in the atlas step.
Deleted
- Buttons that were there twice: Fix model and Check avatar in Quick access, Check and Name humanoid bones in the Pose panel, and the rank line in Quick access.
KAT v0.1.1
Added
- Unity: when you export a model again, KAT asks once whether to replace the materials it made last time or keep them as they are. Replace is the default, and it rewrites the same material assets, so scenes and prefabs keep their links.
- A README with install gifs for Blender and for VCC, and screenshots of the panels.
- A link to the website in the Credits panel, in the Blender manifest and in the Unity package.
Updated
- Combine materials says where the atlas ends up.
Fixed
- Export for Unity left out any texture that only existed inside Blender, like an atlas made in a .blend that was never saved, so the materials in Unity had no textures. They are saved as PNGs in a
<name>_texturesfolder next to the FBX now. - Unity: a material KAT had made earlier blocked the new textures. See the replace or keep question above.
KAT v0.1.0
First release.
Added
- Blender add-on (Blender 5.0 to 5.2, one extension zip) in one KAT tab: import any model file, find missing textures, use the textures Unity uses, flat texture view.
- Fix and clean: bone naming, T-pose, go into pose mode, save as rest pose, clean vertex groups, limit weights.
- Face: visemes (a-b-c order), blink and eye bones, all VRChat Unified face tracking shapes (the missing ones are approximated).
- Outfits: anti-clip shape keys for layered clothes. The skin can be several meshes. Works from the basis shape and tries around 30 poses.
- Optimization: one checklist with Safe, PC Good and Quest presets, bone merging, join and weld.
- Atlas: many meshes at once, with normal maps, emission and cut-out alpha.
- Textures: see what they cost, shrink the big ones without touching the files.
- Reduce triangles: one slider per mesh, hair, face and hands stay put. Optional real-time preview.
- World and props: scan, combine static meshes, collision, LODs, lightmap UVs, prop generators, export for Unity.
- Check against VRChat PC and Quest ranks.
- Version history for imports and exports, with their textures.
- Unity package (VPM, for VCC and ALCOM): humanoid import, materials from Blender's textures, VRChat avatar setup, outfit toggles, texture optimizer, world and prop import.
- Tests for Blender 5.0, 5.1 and 5.2, and CI.
Good to know
- Unity: add
https://cdn.krislyz.com/vpm/index.jsonto VCC or ALCOM. More at https://krislyz.com/kat/ - The Unity part is untested in a real project so far.
- A Quest rank is not always reachable: hair, face and hands are never reduced.
- GPL-3.0-only.