Cats Blender Plugin - Wiki

Welcome to the official documentation for the Cats Blender Plugin for Blender 5.0+!

Note: Cats is currently on life support until Avatar Toolkit is more stable. We will continue pushing updates to Cats but will transition once Avatar Toolkit reaches a stable release.

What is Cats Blender Plugin?

Cats is a tool designed to shorten the steps needed to import and optimize models for VRChat. It supports various model formats including MMD, XNALara, Mixamo, Source Engine, Unreal Engine, DAZ/Poser, Blender Rigify, Sims 2, Motion Builder, 3DS Max, and more.

Current Version Support

Supported Blender Version: Blender 5.0+

⚠️ Important: We only support Blender 5.0 and above. Older versions are no longer supported.

Quick Links

Getting Started

• Installation - How to install Cats Blender Plugin for Blender 5.0
• Version Support - Supported and end-of-life versions

Interface Guides

• Quick Access Panel - Import/Export and common tasks
• Optimization Panel - Atlas, Material, and Bone Merging tools
• Custom Model Creation - Merge armatures and attach meshes
• MMD Options - Tools for MMD/VRM model preparation
• Visemes - Lip sync setup
• Eye Tracking - Eye movement and blinking setup
• Bone Parenting - Root bone management
• Scaling - Model scaling tools (Immersive Scaler integration)
• Other Options - Additional tools and utilities
• Settings - Plugin configuration and updates

Help & Support

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

Key Features

• Model Import/Export - Optimized import for MMD, XNALara, Source, VRM, FBX, and more
• Armature Tools - Merge armatures, attach meshes, fix bone hierarchies
• Optimization - Material combining, texture atlasing, bone merging
• Eye Tracking - SDK3 and Legacy eye tracking setup
• Viseme Generation - Automatic lip sync shape key setup
• Translation Tools - Translate object, bone, material, and shape key names
• VRChat Optimization - Tools specifically designed for VRChat avatar creation

Community & Support

• GitHub Repository: Cats-Blender-Plugin-Unofficial-
• Website: catsblenderplugin.xyz
• Discord: Join our community for support and discussions

Contributing

We welcome contributions! If you'd like to help improve Cats feel free to put a PR in.

About This Version

This wiki is specifically for Cats Blender Plugin version 5.0+ which supports Blender 5.0 and above only.

Why Blender 5.0 Only?

We've focused our development efforts on Blender 5.0+ to:

• Take advantage of the latest Blender features and improvements
• Maintain cleaner, more maintainable code
• Provide better performance and stability
• Focus support resources on a single, modern platform

If you're using an older version of Blender, please upgrade to Blender 5.0 or use an older version of Cats (no longer supported).

---

Last Updated: November 14, 2025 | Plugin Version: 5.0.1.0 | Blender Version: 5.0.0+