- Python 100%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Rina
aece922875
All checks were successful
Blender Tests / blender (https://download.blender.org/release/Blender5.2/, 5.2) (push) Successful in 2m6s
Blender Tests / blender (https://download.blender.org/release/Blender5.1/, 5.1) (push) Successful in 2m10s
Static Tests / static (push) Successful in 20s
Blender Tests / blender (true, alpha, 5.3) (push) Successful in 2m0s
Blender Tests / blender (https://download.blender.org/release/Blender5.2/, 5.2) (pull_request) Successful in 2m2s
Blender Tests / blender (https://download.blender.org/release/Blender5.1/, 5.1) (pull_request) Successful in 2m9s
Static Tests / static (pull_request) Successful in 21s
Blender Tests / blender (true, alpha, 5.3) (pull_request) Successful in 1m59s
|
||
| .forgejo | ||
| mmd_tools_local | ||
| resources | ||
| scripts | ||
| tests | ||
| tools | ||
| ui | ||
| wheels | ||
| .coveragerc | ||
| .gitignore | ||
| .gitmodules | ||
| __init__.py | ||
| blender_manifest.toml | ||
| extentions.py | ||
| globs.py | ||
| LICENSE | ||
| README.md | ||
| ruff.toml | ||
| run_tests.py | ||
| updater.py | ||
Unofficial Cats Blender Plugin
Cats is a Blender add-on for importing, fixing, optimizing, and exporting avatar models, especially for VRChat-style workflows. This fork is maintained for modern Blender versions using Blender's extension package system.
This branch targets Blender 5.2. This version of the add-on currently supports Blender 5.2. For Blender 5.1 please see the latest release for Blender 5.1.
Features
- Import helpers for common avatar/model formats, including MMD, XNALara/XPS, Source, FBX, VRM, and glTF/GLB workflows.
- Export helpers for checked avatar export and Resonite export.
- Armature repair tools for common imported rigs.
- Bone tools for root bones, bone merging, twist bones, digitigrade legs, and manual armature cleanup.
- Mesh cleanup tools for separating by materials, loose parts, or shapekeys.
- Shape key tools for pruning, repairing, applying shape keys to basis, and optimizing static shape keys.
- Viseme generation tools for avatar mouth shapes.
- Eye tracking setup tools for legacy and SDK3-style workflows.
- Material tools for combining duplicate materials and converting textures to PNG.
- Atlas integration for Shotariya's Material Combiner.
- Translation tools for bones, shape keys, objects, and materials.
- Model scaling helpers, including Immersive Scaler integration.
- Built-in updater that checks NeoNeko Forgejo releases for the matching Blender branch.
- UI translations: English, Japanese, Korean, and Simplified Chinese.
Install
Use the release zip. Do not unzip it before installing.
- Download the latest
.zipfrom the Releases page. - Open Blender 5.2.
- Go to
Edit > Preferences. - Open
Get Extensions. - Use the top-right drop-down menu and choose
Install from Disk. - Select the downloaded Cats
.zip. - Open
Add-ons, search forCats, and enable the add-on if Blender did not enable it automatically. - In the 3D Viewport, press
Nto open the sidebar and use theCATStab.
Blender also exposes extension package installation through Preferences > Add-ons > Install from Disk; either path is fine as long as you select the release zip.
Update
Use the Cats updater panel inside Blender, or download a newer release zip and install it from disk again.
Updates are release-based and branch-aware. A Blender 5.2 install should only offer releases for the Blender 5.2 branch.
Compatibility
- Blender 5.2: supported.
- Older Blender versions: use an older branch or release made for that Blender version.
License
MIT. See LICENSE.