• 5.2.3.1 0129c11bf6

    5.2.3.1 (Blender 5.2 LTS and 5.1)
    All checks were successful
    Blender Tests / blender (https://download.blender.org/release/Blender5.1/, 5.1) (push) Successful in 2m9s
    Blender Tests / blender (https://download.blender.org/release/Blender5.2/, 5.2) (push) Successful in 2m12s
    Package Add-on / package (push) Successful in 16s
    Static Tests / static (push) Successful in 22s
    Blender Tests / blender (true, alpha, 5.3) (push) Successful in 2m5s
    Blender Tests / blender (https://download.blender.org/release/Blender5.2/, 5.2) (pull_request) Successful in 1m58s
    Blender Tests / blender (https://download.blender.org/release/Blender5.1/, 5.1) (pull_request) Successful in 2m15s
    Static Tests / static (pull_request) Successful in 23s
    Blender Tests / blender (true, alpha, 5.3) (pull_request) Successful in 2m1s
    Stable

    Yusarina released this 2026-08-04 14:06:47 +00:00 | 3 commits to main since this release

    CATS 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_connect on every parented bone.
      • Bone connections now use fix_bone_orientations, matching the behaviour of Fix Model's Connect Bones option.
    • 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, and rankle from the left-side alias lists.
    • 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_bone directly 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 SavedData not always restoring the armature's original pose_position after a mode change.
    • Fixed clean_shapekeys crashing after all shape keys had been removed and the shape_keys datablock became empty.
    • Fixed Repair Broken Shapekeys selecting the wrong replacement point.
      • The majority vote is now based on coordinates rather than separate ShapeKeyPoint objects.
    • 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.* to cats_manual.*.
    • Updated Connect Bones to use the shared fix_bone_orientations logic used by Fix Model.
    • Moved Scene.pose_to_shapekey_name from the class body into register().
    • 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_bone enum 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_backup logic 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 TransformValidator validation scaffolding.
    • Removed duplicate implementations of is_transform_clean and validate_merge_armature_transforms.
    • Removed attach_mesh_to_armature, which duplicated the behaviour of AttachMesh.execute.
    • Removed the unused detect_bones_to_merge and mix_vertex_groups functions.
    • Removed the always-false mesh_only parameter and the unread mesh_name parameters.
    • Removed the unused POSITION_TOLERANCE constant.
    • Removed a redundant per-mesh loop around a scene-global operation.
    • Removed outdated Blender 2.8-era Object.layers checks.
    • Removed three duplicate Edit Mode switches.
    Downloads
  • 5.2.3.0 b15ce848ba

    5.2.3.0 (Blender 5.2 LTS and 5.1)
    All checks were successful
    Package Add-on / package (push) Successful in 16s
    Blender Tests / blender (https://download.blender.org/release/Blender5.1/, 5.1) (push) Successful in 1m47s
    Blender Tests / blender (https://download.blender.org/release/Blender5.2/, 5.2) (push) Successful in 1m47s
    Static Tests / static (push) Successful in 20s
    Blender Tests / blender (true, alpha, 5.3) (push) Successful in 1m39s
    Stable

    Yusarina released this 2026-07-30 11:40:49 +00:00 | 19 commits to main since this release

    This 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:
      • Google
      • 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 noShapekeys translation string.

    Changed

    • Replaced the outdated and unmaintained google_trans_new package 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_resources from extern_tools into 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 bmesh code 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
  • 5.2.2.1 d3500e0d21

    5.2.2.1 (Blender 5.2 LTS and 5.1)
    All checks were successful
    Package Add-on / package (push) Successful in 17s
    Static Tests / static (push) Successful in 14s
    Blender 5.2 Tests / blender (push) Successful in 1m28s
    Stable

    Yusarina released this 2026-07-24 18:48:47 +00:00 | 50 commits to main since this release

    This 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
  • 5.2.2.0 b44b201efd

    5.2.2.0 (Blender 5.2 LTS and 5.1)
    All checks were successful
    Package Add-on / package (push) Successful in 16s
    Static Tests / static (push) Successful in 14s
    Blender 5.2 Tests / blender (push) Successful in 1m21s
    Stable

    Yusarina released this 2026-07-23 19:58:49 +00:00 | 56 commits to main since this release

    This 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
  • 5.2.1.0 c3bfab025d

    5.2.1.0 (Blender 5.2 LTS and 5.1)
    All checks were successful
    Package Add-on / package (push) Successful in 17s
    Static Tests / static (push) Successful in 14s
    Blender 5.2 Tests / blender (push) Successful in 1m17s
    Stable

    Yusarina released this 2026-07-17 14:15:51 +00:00 | 71 commits to main since this release

    This 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
  • 5.2.0.0 a6884e68d5

    5.2.0.0 (Blender 5.2 LTS and 5.1)
    All checks were successful
    Package Add-on / package (push) Successful in 16s
    Static Tests / static (push) Successful in 14s
    Blender 5.2 Tests / blender (push) Successful in 1m12s
    Stable

    Yusarina released this 2026-07-17 12:46:31 +00:00 | 76 commits to main since this release

    This 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
  • 5.1.0.0 584b1bc26c

    Yusarina released this 2026-06-18 16:28:28 +00:00 | 94 commits to main since this release

    This 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