-
5.2.3.1 (Blender 5.2 LTS and 5.1)
StableAll checks were successfulBlender Tests / blender (https://download.blender.org/release/Blender5.1/, 5.1) (push) Successful in 2m9sBlender Tests / blender (https://download.blender.org/release/Blender5.2/, 5.2) (push) Successful in 2m12sPackage Add-on / package (push) Successful in 16sStatic Tests / static (push) Successful in 22sBlender Tests / blender (true, alpha, 5.3) (push) Successful in 2m5sBlender Tests / blender (https://download.blender.org/release/Blender5.2/, 5.2) (pull_request) Successful in 1m58sBlender Tests / blender (https://download.blender.org/release/Blender5.1/, 5.1) (pull_request) Successful in 2m15sStatic Tests / static (pull_request) Successful in 23sBlender Tests / blender (true, alpha, 5.3) (pull_request) Successful in 2m1sreleased this
2026-08-04 14:06:47 +00:00 | 3 commits to main since this releaseCATS Blender Plugin 5.2.3.1
This is primarily a maintenance release focused on bug fixes, reliability improvements, regression testing, and internal cleanup. It resolves several long-standing issues affecting armature tools, MMD bone morphs, shape keys, rigidbody removal, and Fix Model progress reporting.
Our new wiki is now live:
https://git.neoneko.org/Yusarina/Cats-Blender-Plugin/wiki
⚠️ Deprecation Warnings
Material Combiner and Atlas Generation will be removed in CATS Blender Plugin 5.2.4.0.
The current external Material Combiner plugin will be replaced by a new built-in CATS material tool.
Immersive Scaler will be removed in CATS Blender Plugin 5.2.5.0.
The current external Immersive Scaler plugin will be replaced by a new built-in CATS scaling tool.
These plugins are no longer maintained by the original authors.
Deprecation warnings are now shown directly inside the relevant CATS panels.
Fixed
- Fixed Remove Rigidbodies and Joints failing to detect some objects because its name check was case-sensitive and incorrectly grouped.
- Fixed Remove Rigidbodies and Joints crashing on nested matching objects.
- Children are now only scanned when their parent is not already marked for removal, preventing the same subtree from being deleted twice.
- Fixed Merge Armatures crashing when removing nested rigidbody objects.
- Matching children are no longer queued separately when their parent is already being removed.
- Fixed Connect Bones collapsing branching bones such as shoulders, legs, fingers, and other limbs towards the spine.
- It no longer enables
use_connecton every parented bone. - Bone connections now use
fix_bone_orientations, matching the behaviour of Fix Model's Connect Bones option.
- It no longer enables
- Fixed right-side bones being incorrectly renamed as left-side bones by Convert Bones to Valve.
- Removed right-side aliases such as
rshoulder,rarm,relbow,rwrist,rleg,rknee, andranklefrom the left-side alias lists.
- Removed right-side aliases such as
- Fixed Generate Twist Bones incorrectly reporting the Remove Constraints success message.
- It now reports the number of twist bones generated.
- Fixed Merge Armatures reading
attach_to_bonedirectly instead of using the safe enum getter.- Prevents dynamic enum indices from being treated as bone names.
- Empty enum placeholders are now ignored instead of being accepted as valid parent bones.
- Fixed
SavedDatanot always restoring the armature's originalpose_positionafter a mode change. - Fixed
clean_shapekeyscrashing after all shape keys had been removed and theshape_keysdatablock became empty. - Fixed Repair Broken Shapekeys selecting the wrong replacement point.
- The majority vote is now based on coordinates rather than separate
ShapeKeyPointobjects.
- The majority vote is now based on coordinates rather than separate
- Fixed Repair Broken Shapekeys failing on meshes that only contain a Basis shape key.
- Fixed Repair Broken Shapekeys spamming standard output with per-vertex debug messages.
- Fixed MMD bone morphs only being baked into the first mesh.
- Bone morphs are now baked into every mesh on models with separate body, face, hair, clothing, or accessory meshes.
- Each morph uses one pose and depsgraph evaluation across all relevant meshes.
- Fixed the Fix Model progress bar exceeding its total on models containing multiple meshes.
- Progress calculations now account for the number of meshes being processed.
Changed
- Changed the Remove Rigidbodies and Joints operator ID from
my_plugin.*tocats_manual.*. - Updated Connect Bones to use the shared
fix_bone_orientationslogic used by Fix Model. - Moved
Scene.pose_to_shapekey_namefrom the class body intoregister(). - Added a
report_lines()test helper for reading Blender operator reports through redirected standard output.
Tests
- Added regression tests for the repaired armature operators.
- Added static validation for the bone alias tables, including:
- Alias collisions
- Duplicate aliases
- Left and right side markers
- Left and right mirroring
- Added Blender regression tests for:
- Convert Bones to Valve
- Connect Bones
- Remove Rigidbodies and Joints
- Repair Broken Shapekeys
- Generate Twist Bones
- Merge Armatures attachment handling
- Added tests for safe
attach_to_boneenum handling and empty enum placeholders.
Internal Cleanup
- Removed an unreachable bone-collection block from Fix Model.
- The block could never run because all bone collections had already been removed.
- Removed the unused
bone_collections_backuplogic from Fix Model. - Removed the unnecessary Edit Mode round trip that only existed to populate the unused bone-collection backup.
- Kept the required Object Mode switch and bone-collection removal behaviour.
- Removed the unused
TransformValidatorvalidation scaffolding. - Removed duplicate implementations of
is_transform_cleanandvalidate_merge_armature_transforms. - Removed
attach_mesh_to_armature, which duplicated the behaviour ofAttachMesh.execute. - Removed the unused
detect_bones_to_mergeandmix_vertex_groupsfunctions. - Removed the always-false
mesh_onlyparameter and the unreadmesh_nameparameters. - Removed the unused
POSITION_TOLERANCEconstant. - Removed a redundant per-mesh loop around a scene-global operation.
- Removed outdated Blender 2.8-era
Object.layerschecks. - Removed three duplicate Edit Mode switches.
Downloads
-
Source code (ZIP)
25 downloads
-
Source code (TAR.GZ)
2 downloads
-
5.2.3.0 (Blender 5.2 LTS and 5.1)
StableAll checks were successfulPackage Add-on / package (push) Successful in 16sBlender Tests / blender (https://download.blender.org/release/Blender5.1/, 5.1) (push) Successful in 1m47sBlender Tests / blender (https://download.blender.org/release/Blender5.2/, 5.2) (push) Successful in 1m47sStatic Tests / static (push) Successful in 20sBlender Tests / blender (true, alpha, 5.3) (push) Successful in 1m39sreleased this
2026-07-30 11:40:49 +00:00 | 19 commits to main since this releaseThis is the biggest CATS update in a long time. It introduces a completely new translation system, adds glTF and GLB importing, brings new UV tools into CATS, significantly reorganises and polishes the interface, improves Rigify handling, and integrates our new wiki throughout the add-on.
Hopefully there are no bugs. xD
Our new wiki is now live:
https://git.neoneko.org/Yusarina/Cats-Blender-Plugin/wiki
⚠️ Deprecation Warnings
Material Combiner and Atlas Generation will be removed in CATS Blender Plugin 5.2.4.0.
The current external Material Combiner plugin will be replaced by a new built-in CATS material tool.
Immersive Scaler will be removed in CATS Blender Plugin 5.2.5.0.
The current external Immersive Scaler plugin will be replaced by a new built-in CATS scaling tool.
These plugins are no longer maintained by the original authors.
Deprecation warnings are now shown directly inside the relevant CATS panels.
Added
- Added glTF and GLB importing.
- Added a new pluggable translation system with support for:
- DeepL
- LibreTranslate
- MyMemory
- Internal dictionary only
- Added a Translation Service dropdown, allowing users to choose their preferred translation provider.
- Added unit tests for the new translation providers.
- Added a new UV Tools panel to the UV/Image Editor.
- Added Align UV Edges to Target, ported from Avatar Toolkit.
- Added Find Shortest Seam Path with a rewritten breadth-first search system.
- Added Find Shortest Seam Path to a new collapsed UV Tools panel in the 3D View sidebar.
- Added a new Bone Tools panel.
- Added help icons throughout the interface that open the relevant section of the new CATS wiki.
- Added shared interface helpers for section headers and wiki buttons.
- Added hint text to sections where the available actions were not immediately clear.
- Added the missing
noShapekeystranslation string.
Changed
- Replaced the outdated and unmaintained
google_trans_newpackage with a built-in translation provider system. - Translation dictionaries are still checked first, with the selected online service only translating missing entries.
- Translation providers now fail safely when a service is unavailable.
- Translation service settings are now stored in the global CATS settings file.
- Relabelled the old Use Old Translations option to better represent the new multi-service translation system.
- Unified Rigify detection through
Common.is_rigify_armature. - Removed the duplicate inline Rigify detection block from Fix Model, as the shared validator already handles both conditions.
- Moved
valve_resourcesfromextern_toolsinto the main resources directory. - Reorganised the CATS sidebar and reordered panels into a more logical order.
- Added Fix Model to Quick Access.
- Renamed MMD Options to Converters.
- Moved the Rigify, Valve and VRM converters into the Converters panel.
- Moved translation tools into a dedicated Translation panel.
- Renamed Custom Model Creation to Merge & Attach.
- Renamed the internal Fix Koikatsu Shapekeys functionality, which was incorrectly named as a VRM shapekey fix despite not being intended for VRM models.
- Updated the Fix Model warning to clarify that it is intended for MMD and VRM models.
- Reorganised the Optimization panel into:
- Materials
- Mesh Cleanup
- Shape Keys
- Bones & Weights
- Atlas Generation
- Moved Join Meshes and Remove Doubles out of Material Operations and into the relevant mesh sections.
- Removed the old Mesh Tools panel and moved its tools into the relevant Optimization sections.
- Moved Atlas Generation to the bottom of the Optimization panel because it is being deprecated.
- Made all Optimization sub-panels collapsed by default.
- Added consistent boxed sections throughout:
- Quick Access
- Converters
- Merge & Attach
- Translation
- Bone Tools
- Bone Parenting
- Visemes
- Scaling
- Eye Tracking
- UV Tools
- Settings
- Added spacing below section headers so they no longer sit directly against the first button.
- Removed trailing colons from section titles that were previously formatted like inline labels.
- Added titles to sections that previously had no header.
- Removed unnecessary boxes where the panel name already provided enough context.
- Split long labels, descriptions and button rows so they fit better inside narrow sidebar panels.
- Improved the layout and field spacing in the Visemes and Eye Tracking panels.
- Changed the eye-tracking progress bar so it is only displayed while an operation is running.
- Removed the old How to Use, MMD Options Wiki, Tutorial, and Support Us buttons.
- Removed the inline UV tool instructions, as this information is now available on the wiki.
- Updated the Credits help button to open the new CATS wiki.
- Translated the remaining hardcoded interface labels.
- Updated all supported locales to match the redesigned interface.
- Removed unused
bmeshcode from the UV edge alignment tool. - Narrowed exception handling in the new UV tools to expected error types.
Fixed
- Fixed the faulty UV repair report in Fix Model never appearing.
- The repaired UV counter is now preserved across all processed meshes instead of being reset before the report could read it.
- Fixed MMD bone-morph baking producing empty shape keys on Linux.
- Bone morphs are now baked from evaluated mesh positions instead of the undeformed base mesh.
- Bone posing now uses
matrix_basis, allowing Euler-mode bones to bake correctly. - Temporary modifiers, shape-key state and bone poses are restored after baking.
- Fixed the previous Find Shortest Seam Path search being unreliable by replacing it with a cleaner breadth-first search implementation.
- Fixed Find Shortest Seam Path unnecessarily requiring an armature.
- Fixed long labels, descriptions and button rows being truncated in narrow sidebar panels.
- Fixed the eye-tracking progress bar appearing when no eye-tracking operation was running.
- Fixed translation failures potentially interrupting the translation process when an online provider is unavailable.
Downloads
-
Source code (ZIP)
12 downloads
-
Source code (TAR.GZ)
2 downloads
-
released this
2026-07-24 18:48:47 +00:00 | 50 commits to main since this releaseThis update improves Blender extension compatibility, prevents translation downloads from freezing Blender, speeds up UV repairs, and improves error handling across several tools.
Fixed:
- Fixed user settings, translation caches, dictionaries, and downloaded translations being stored inside the extension package.
- Fixed user data being lost or becoming unwritable after extension updates.
- Fixed translation and dictionary downloads potentially freezing Blender indefinitely.
- Fixed an off by one error that skipped the final UV during repair.
- Fixed broad exception handlers hiding unexpected errors.
Changes:
- Runtime user data is now stored in Blender’s persistent writable user data location.
- Existing user settings are migrated automatically.
- UV NaN checking and repair now use vectorized NumPy operations for better performance on dense meshes.
- Exception handling across importer, armature, atlas, scale, and eye tracking tools now catches specific expected errors.
Compatibility:
- Updated runtime data handling to comply with Blender extension system guidelines.
Downloads
-
Source code (ZIP)
13 downloads
-
Source code (TAR.GZ)
2 downloads
-
released this
2026-07-23 19:58:49 +00:00 | 56 commits to main since this releaseThis update fixes several long-standing bugs and issues, adds a Rigify converter, improves internal functionality, and removes Blender extension policy violation warnings.
Fixes:
- Fixed custom split-normal baking in OptimizeStaticShapekeys.
- Fixed remove_doubles hanging on meshes with fewer than 100 vertices.
- Fixed translation placeholder errors and brought all locales back in sync.
- Fixed version checks by reading Cats_Version from the extension manifest.
- Fixed extension packaging and removed the sys.path policy violation.
- Fixed several long-standing TODOs involving MMD colour baking, eye tracking, VRM detection, and object visibility.
- Fixed invalid Python escape sequences across armature bone mappings.
Bone Protection and Reporting:
- End bones are now kept by default.
- Added protected bone patterns to prevent selected bones from being deleted or renamed.
- Added original bone-name tracking for more accurate change reports.
- Improved reporting to distinguish renamed bones from deleted bones.
Rigify Support
- Added a Convert Rigify to Cats operator.
- Supports Rigify and Metarig bone naming.
- Collapses split limb chains and can optionally merge twist bones.
- The button only appears when a valid Rigify armature is selected.
- Fix Model now directs Rigify users to the new converter.
The converter is currently located under MMD Options until a future UI rework.
Internal Changes
- Updated MMD Tools to 4.5.13.
- Reworked bundled dependencies into proper Python sub-packages.
- Removed outdated Blender pre-5.1 compatibility code.
- Removed committed bytecode and excluded development scripts from release packages.
- Renamed the project to Cats Blender Plugin.
- Updated project contact and credits.
Downloads
-
Source code (ZIP)
3 downloads
-
Source code (TAR.GZ)
2 downloads
-
released this
2026-07-17 14:15:51 +00:00 | 71 commits to main since this releaseThis update modernizes CATS internals, fixes several long-standing bugs and performance issues, and includes a best-effort fix for the Resonite exporter. This update works with Blender 5.1 and 5.2 LTS.
- Modernized CATS internals and removed outdated Blender code.
- Fixed several long standing bugs and performance issues.
- Fixed eye tracking backups by restoring a missing JSON import.
- Fixed pose modifier ordering warnings.
- Improved modifier removal reliability.
- Made network features fail gracefully when requests is unavailable.
- Updated the Resonite exporter to use automatic textures, export a single GLB, bake modifiers, and disable animations by default.
- Added tests for mesh repair deduplication and missing requests imports.
Resonite exporter changes are best effort and currently untested as I don't play it.
Downloads
-
Source code (ZIP)
15 downloads
-
Source code (TAR.GZ)
0 downloads
-
released this
2026-07-17 12:46:31 +00:00 | 76 commits to main since this releaseThis is a update for Blender 5.2 however it works on Blender 5.1 as there are no major API changes. All this release does is make sure CATS passes all tests and the wording is updated for Blender 5.2.
Downloads
-
Source code (ZIP)
2 downloads
-
Source code (TAR.GZ)
2 downloads
-
Source code (ZIP)
-
5.1.0.0 (Blender 5.1) Stable
released this
2026-06-18 16:28:28 +00:00 | 94 commits to main since this releaseThis version is only for Blender 5.1, this repo does not support older versions, see https://git.disroot.org/Neoneko/Cats-Blender-Plugin/releases for older versions.
This release just updates Cats for Blender 5.1.
Downloads
-
Source code (ZIP)
3 downloads
-
Source code (TAR.GZ)
2 downloads
-
Source code (ZIP)