⚠ Heads up: this wiki is for Cats 5.2.3.0 (upcoming).

Version 5.2.3.0 completely reworks the interface, so this documentation does not apply to 5.2.2.0 or earlier. If you're running an older release, please use the legacy wiki instead.

Cats Blender Plugin - Wiki

Welcome to the official documentation for the Cats Blender Plugin.

Cats is a tool designed to shorten the steps needed to import and optimize models for VRChat and other platforms. It supports a wide range of formats including MMD, XNALara, Mixamo, Source Engine, VRM, glTF/GLB, FBX, DAE and more.

Version Support

Plugin version	5.2.3.0
Supported Blender	5.1 and 5.2
Recommended	Blender 5.2 LTS

⚠ Blender 5.0 and below are not supported. If you need Cats for an older Blender release, download an older Cats version from the legacy releases (unsupported).

Quick Links

Getting Started

• Installation - How to install Cats and its optional add-ons
• Version Support - Supported and end-of-life versions

Interface Guides

• Quick Access - Import/Export, Fix MMD Model, quick actions, and pose mode
• Optimization - Atlas, materials, mesh & bone cleanup, and the nested Mesh Tools
• Converters - Rigify, Source/Valve, VRM, and MMD cleanup (formerly "MMD Options")
• Merge & Attach - Merge armatures and attach meshes (formerly "Custom Model Creation")
• Translation - The new multi-service translation system
• Bone Tools - Digitigrade legs and twist bones
• UV Tools - Align UV edges and find the shortest seam path
• Visemes - Lip-sync setup
• Eye Tracking - Eye movement and blinking setup
• Bone Parenting - Root bone management
• Scaling - Model scaling (Immersive Scaler integration)
• Settings - Plugin configuration and updates

Help & Support

• Troubleshooting - Common issues and solutions
• FAQ - Frequently asked questions

What's New in 5.2.3.0

• Reorganized interface - the panels were restructured so tools live where you'd expect them. Fix MMD Model now sits at the top in Quick Access; all format conversions moved into a single Converters panel.
• New translation system - a pluggable Translation backend lets you choose between the internal dictionary, Google, DeepL, LibreTranslate or MyMemory. The old bundled Google module is gone.
• UV Tools - a brand-new panel with Align UV Edges to Target and Find Shortest Seam Path.
• Bone Tools - digitigrade legs and twist-bone generation now have their own home.
• glTF / GLB import and unified Rigify detection.
• Blender 5.1 & 5.2 support (5.2 LTS recommended).

Key Features

• Model Import/Export - MMD, XNALara, Source, VRM, glTF/GLB, FBX, DAE and more
• Fix MMD Model - one-click conversion of fresh MMD/VRM imports for Unity/VRChat
• Optimization - material combining, texture atlasing, bone merging, remove doubles
• Converters - Rigify → Cats, Source/Valve, VRM fixes, MMD cleanup
• Merge & Attach - combine armatures and attach meshes
• Translation - internal dictionary first, with optional online services to fill the gaps
• Eye Tracking & Visemes - automated setup for VRChat avatars
• UV & Bone Tools - targeted mesh/rig helpers

Community & Support

• Source & Releases: git.neoneko.org/Yusarina/Cats-Blender-Plugin
• Older Cats versions (Blender 5.0 and below): Legacy releases on Disroot

We no longer run a Discord server or website. All support, bug reports and discussion happen on the Git repository above.

Contributing

We welcome contributions! If you'd like to help improve Cats, feel free to open a pull request on the repository.

---

Last Updated: July 28, 2026 | Plugin Version: 5.2.3.0 | Blender: 5.1 & 5.2 (5.2 LTS recommended)