Yusarina/Cats-Blender-Plugin
3
1
Fork 0
Code Issues Pull requests Releases 5 Packages Wiki Activity Actions
An Updated Version of Cats for Blender 5.1+
61 commits 1 branch 5 tags 4.4 MiB
  • Python 100%
Find a file
Exact
Rina 166809befd
All checks were successful
Blender Tests / blender (https://download.blender.org/release/Blender5.1/, 5.1) (push) Successful in 1m40s
Details
Blender Tests / blender (https://download.blender.org/release/Blender5.2/, 5.2) (push) Successful in 1m43s
Details
Static Tests / static (push) Successful in 19s
Details
Tidy Quick Access and warn Fix MMD Model is MMD/VRM-only
2026-07-28 00:30:15 +01:00
.forgejo Fix Blender tests and circular import 2026-07-24 20:03:13 +01:00
mmd_tools_local Update MMD Tools to 4.5.13 and rework bundling, fix sys.path policy violation 2026-07-22 13:05:23 +01:00
resources Tidy Quick Access and warn Fix MMD Model is MMD/VRM-only 2026-07-28 00:30:15 +01:00
scripts Update MMD Tools to 4.5.13 and rework bundling, fix sys.path policy violation 2026-07-22 13:05:23 +01:00
tests Add tests for the UV Tools 2026-07-27 20:04:29 +01:00
tools Add tests for the UV Tools 2026-07-27 20:04:29 +01:00
ui Tidy Quick Access and warn Fix MMD Model is MMD/VRM-only 2026-07-28 00:30:15 +01:00
wheels Update MMD Tools to 4.5.13 and rework bundling, fix sys.path policy violation 2026-07-22 13:05:23 +01:00
.coveragerc Harden test suite: shared file-walker, ruff, coverage, 5.1+5.2 matrix 2026-07-24 19:51:53 +01:00
.gitignore Harden test suite: shared file-walker, ruff, coverage, 5.1+5.2 matrix 2026-07-24 19:51:53 +01:00
.gitmodules Orignal Cats for Blender 5.0 2026-06-18 16:46:29 +01:00
__init__.py Version Bump 2026-07-28 00:21:27 +01:00
blender_manifest.toml Version Bump 2026-07-28 00:21:27 +01:00
extentions.py Add pluggable translation backends, remove bundled google_trans_new 2026-07-27 03:35:08 +01:00
globs.py Harden test suite: shared file-walker, ruff, coverage, 5.1+5.2 matrix 2026-07-24 19:51:53 +01:00
LICENSE Orignal Cats for Blender 5.0 2026-06-18 16:46:29 +01:00
README.md Add glTF/GLB import and unify Rigify detection 2026-07-25 02:21:44 +01:00
ruff.toml Fix Python Version 2026-07-24 19:56:46 +01:00
run_tests.py Harden test suite: shared file-walker, ruff, coverage, 5.1+5.2 matrix 2026-07-24 19:51:53 +01:00
updater.py Harden test suite: shared file-walker, ruff, coverage, 5.1+5.2 matrix 2026-07-24 19:51:53 +01:00

README.md

Unofficial Cats Blender Plugin

Static Tests Blender 5.2 Tests Latest Release

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.

  1. Download the latest .zip from the Releases page.
  2. Open Blender 5.2.
  3. Go to Edit > Preferences.
  4. Open Get Extensions.
  5. Use the top-right drop-down menu and choose Install from Disk.
  6. Select the downloaded Cats .zip.
  7. Open Add-ons, search for Cats, and enable the add-on if Blender did not enable it automatically.
  8. In the 3D Viewport, press N to open the sidebar and use the CATS tab.

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.