Why We Recommend the Unofficial Version
Current Status
As of August 2024, the Official Cats Blender Plugin appears to be in an indefinite hiatus. Here's the timeline:
- Last Official Release: June 27, 2021
- Last Main Branch Update: January 25, 2022
- Last Development Branch Updates:
- November 30, 2023 (minor fix)
- April 8, 2023 (version bump)
Official Statement (April 5, 2023)
The last official update provided the following information:
- No estimated timeline for official updates
- Project ownership limitations prevent community updates
- Community developers can't publish official releases
- Negotiations were ongoing for transfer of release permissions
While the last update mentioned ongoing negotiations, this information is now outdated. Neoneko has made multiple attempts to contact the original project developers to take over the Official discord and update the Github, all without success. The original project is 100% abandoned.
Neoneko's Statement (26/09/2024)
"At this point, it's safe to say that it's 100% been abandoned. Absolute Quantum (who goes by several different names) and Hotox are not active anywhere in the CATS community and haven't been for a very long time. I have recently tried to contact the main developer to see if we could take over the official CATS GitHub repository, but to no avail. At this point, I believe the main original developer has 100% vanished from the internet."
Additionally, Neoneko spent over 6 months working with Patreon's safety team to have the original Cats Patreon page taken down, as the original developers were still receiving money from users unaware of the project's abandoned status. After persistent communication with Patreon's safety team, the page was successfully removed to prevent further misleading of users.
Noeneko's Statement (24/05/2025)
"Neoneko has decided to take the drastic step to remove all content regarding the official Cats Blender Plugin. This is because there are still too many people trying to use it in contexts where they shouldn't. Using the old official Cats plugin is like trying to keep an outdated engine running long after its service life has ended - it might start, but you'll constantly run into problems and compatibility issues."
"Therefore, from now on Neoneko will no longer link to the old Cats whatsoever. Please just update to a newer version of Blender."
It's Time to Upgrade
Many Blender plugins no longer support older versions
As Blender evolves, plugin developers focus their resources on newer versions. This means that not only Cats, but many other essential plugins you rely on, are dropping support for older Blender versions.
Blender 2.x is ancient
Blender 2.x is now considered legacy software. Finding support, tutorials, or fixes for issues in these versions is becoming increasingly difficult. Most developers and community members have moved on to newer versions.
Even Blender 3.x is being phased out
While Blender 3.x is newer than 2.x, it's still becoming outdated. Many plugins are starting to drop support for the earliest 3.x versions, and development focus has shifted to Blender 4.x. The transition to move forward is happening now.
What This Means For Users
Official Cats Plugin Users | Unofficial Cats Plugin Users |
---|---|
No updates for new Blender versions | Regular updates for latest Blender versions |
No bug fixes or improvements | Active bug fixes and improvements |
No new feature additions | New features and enhancements |
No community support | Ongoing community support |
How To Help The Community
Comment on YouTube tutorials and guides
- Let viewers know the video uses outdated Cats Plugin
- Share the link to Unofficial Cats Plugin
- Mention that Unofficial Cats supports latest Blender versions
Engage with community platforms
- Update outdated forum posts
- Share success stories with Unofficial Cats
- Help redirect users to current documentation
Spread awareness on social media
- Share updates about Unofficial Cats
- Create new tutorials using current versions
- Join community discussions
Warning About Outdated Tutorials
Be cautious of outdated tutorials suggesting manual fixes or code modifications. The "Testing" error in Blender 3.0+ is not a code issue - it indicates you're using an incompatible Cats version.
Visit https://catsblenderplugin.xyz and use our version selector to get the correct version for your Blender installation.
Many content creators incorrectly suggest removing "Testing" from the code, contradicting official guidance from both the Cats Discord and Neoneko team. Following these incorrect fixes will leave you with an outdated, unsupported version of Cats that lacks crucial updates and creates additional compatibility problems with Blender 3.0+.
Active Development
The official Cats Blender Plugin has not been actively maintained since June 2021. In contrast, our unofficial version receives regular updates to support the latest Blender versions and features.
Modern Blender Support
The unofficial version fully supports modern Blender versions (3.6, 4.0, 4.1, 4.2, 4.3, 4.4, and 4.5), while the official version is not compatible with Blender 4.x due to significant API changes.
Bug Fixes and Enhancements
We've fixed numerous bugs from the original plugin and added new features and optimizations to improve the user experience and compatibility with various 3D models.
Upgrading to Blender 4.2 LTS
Why Blender 4.2 LTS?
Even though Blender 4.3 and 4.4 are available, we recommend Blender 4.2 as it's the latest Long-Term Support (LTS) release. LTS versions receive bug fixes and security updates for a longer period, making them more stable for production work.
Make sure you download the latest version of Blender 4.2 LTS. Blender regularly releases updates with bug fixes and security improvements, so check for updates periodically to ensure you're using the most stable version available.
Download Blender 4.2 LTS
You can download Blender 4.2 LTS from the official Blender website:
Download Blender 4.2 LTSYou can install Blender 4.2 alongside your existing Blender installation without conflicts.
Blend File Compatibility
When upgrading from Blender 2.8/2.9 to Blender 4.2, you may encounter file compatibility issues. Here's what you need to know:
Backward Compatibility:
- Blender 4.2 can open files created in older versions (like 2.8/2.9)
- Most data will be properly converted, but some deprecated features may not transfer perfectly
Forward Compatibility:
- Files saved in Blender 4.2 may not open correctly in Blender 2.8/2.9
- Opening newer files in older versions can result in data loss, incorrect results, or even crashes
- Critical compatibility breakages typically occur when moving between major versions (e.g., from 2.x to 3.x or 3.x to 4.x)
Best Practices:
- Always keep backups of your original .blend files before opening them in a newer version
- Consider using Blender 3.6 LTS as an intermediary converter if you need to move files between Blender 4.x and older versions
- For important projects, save versions in both the old and new Blender formats
- Test your workflow with non-critical files before committing to the upgrade for important projects
Key Differences Between Blender 2.8/2.9 and 4.2
Interface Changes:
- Redesigned Asset Browser for better organization
- Improved Node Editor with node groups and better organization
- Enhanced viewport performance and display options
- New Geometry Nodes system (replaces the old modifier workflow)
Technical Improvements:
- Better multi-threading and performance optimization
- Improved UV editing tools
- Enhanced animation tools and rigging systems
- More robust simulation systems (cloth, fluid, etc.)
- Better import/export compatibility with various formats
Add-on System Changes:
- Introduction of the Extensions platform (separate from traditional add-ons)
- More standardized installation procedures
- Better version compatibility management
Extensions vs. Add-ons
Blender 4.2 introduced the new Extensions platform, which is different from the traditional add-on system:
Traditional Add-ons:
- Installed manually by selecting ZIP files through Preferences
- Stored in the Blender user preferences folder
- May have compatibility issues between Blender versions (though this can also apply to Extensions)
Extensions Platform:
- Can be installed both from the online marketplace or locally from ZIP files
- Standardized distribution format
- More consistent update process for extensions installed from the marketplace (note that locally installed extensions still require manual updates)
To install Extensions locally:
- Download the Extension ZIP file
- Go to Edit > Preferences > Extensions
- Click on the Down arrow in the top right, then click 'Install from disk'
- Select the downloaded ZIP file
- The extension should automatically enable. If it doesn't, go to the Add-ons tab, find it in the list, and enable it by checking the box
To access the online Extensions marketplace in Blender 4.2:
- Go to Edit > Preferences > Extensions
- You'll need to allow online access when prompted (this usually appears on first access)
- Once allowed, a search box will appear that lets you search for extensions from the Blender extension platform
Both add-ons and extensions can have version compatibility issues. If a developer drops support for a specific Blender version, you may encounter problems regardless of whether it's an add-on or extension.
Essential Add-ons for VRChat Modeling in Blender 4.2
Unofficial Cats Blender Plugin
The original Cats Blender Plugin is no longer maintained, but the Unofficial Cats Blender Plugin continues development with support for Blender 4.2+ and many improvements.
Installation:
- Download from the official website: Cats Blender Plugin Website or GitHub Repository
- In Blender, go to Edit > Preferences > Add-ons
- Click 'Install' and select the downloaded ZIP file
- Enable the add-on by checking the box
Key Improvements in Unofficial Cats:
- Improved and faster Armature merging
- Improved and faster Eye Tracking and Viseme Creation
- UI Overhaul which is cleaner and more organized
- Enhanced Mesh Attachment System
- Faster Removed Doubles function
- Many bug fixes and improvements
- Latest MMD Tools integration
The Unofficial Cats Blender Plugin includes MMD Tools, so you don't need to install MMD Tools separately.
Tuxedo Blender Plugin
For model optimization and decimation, we now recommend using Tuxedo Blender Plugin alongside Unofficial Cats:
Installation:
- Download from GitHub: Unofficial Tuxedo Blender Plugin
- Install through the Add-ons preferences as described above
VRM Add-on
For working with VRM files (popular in VRChat and VTubing), you'll need the VRM Add-on.
Installation Options:
- Via Extensions Platform:
- In Blender, go to Edit > Preferences > Extensions
- Click 'Browse Extensions'
- Search for 'VRM'
- Click 'Install' on the VRM Add-on
- Manual Installation:
- Download from GitHub: VRM Add-on for Blender
- Install through the Add-ons preferences
Source Tools
For working with Source engine models (Valve games):
Installation:
- Download from Valve Developer Wiki: Blender Source Tools
- Install through the Add-ons preferences
MMD Tools (Only if not using Unofficial Cats)
If you're not using the Unofficial Cats Blender Plugin (which includes MMD Tools), you can install it separately:
Installation:
- Download from GitHub Releases: MMD Tools Releases
- Install through the Add-ons preferences
Verifying Installation
After installing add-ons:
- Restart Blender
- Check if the add-ons appear in their expected locations:
- Unofficial Cats: Should appear in the sidebar (N key) under 'Cats'
- VRM: Should appear in the import/export menus
- Source Tools: Should appear in the import/export menus
- MMD Tools: Should appear in the sidebar under 'MMD Tools'
Workflow Changes in Blender 4.2 with Unofficial Cats
General Blender Workflow Changes
Modifier System:
- The modifier stack now has better organization and visual feedback
- Geometry Nodes replace many traditional modifiers and offer more flexibility
- The Apply button has moved to the top of each modifier
Material Editing:
- The Shader Editor has improved node organization
- Material preview is more accurate in the viewport
- PBR workflow is better supported with improved nodes
UV Editing:
- UV tools are now more accessible in the UV Editor
- Better seam detection and unwrapping algorithms
- Multi-object UV editing is more streamlined
Animation:
- The Dope Sheet and Graph Editor have improved controls
- Better keyframe management and editing tools
- Enhanced rigging tools with improved weight painting
File Management:
- Asset Browser allows for better organization of commonly used assets
- Improved linking and appending workflow
- Better handling of external files and dependencies
Unofficial Cats Specific Changes
Quick Access Panel:
The Quick Access panel now includes:
- Improved model import with optimal settings
- Better export options for Unity and Resonite
- Enhanced material combining
- Streamlined pose mode controls
Custom Model Creation:
The Custom Model panel offers:
- More reliable armature merging
- Better mesh attachment options
- Improved bone handling during merges
- Enhanced shape key preservation
MMD Options Section:
Adapting Your Workflow
Import/Export:
- Use the Cats Quick Access panel for importing models instead of Blender's native importers
- For exporting to Unity, use the 'Export Model' option in Cats
- For Resonite, use the dedicated Resonite export option
Material Handling:
- The Material Combiner has been improved and is more reliable
- Texture atlasing works better with complex materials
- Better handling of transparency and special effects
Optimization:
- Use Tuxedo Blender Plugin for decimation and optimization
- Better polygon reduction while preserving important features
- Improved atlas generation for textures
File Organization:
- Take advantage of Blender 4.2's Asset Browser for organizing common avatar parts
- Use Collections more effectively to organize complex avatars
- Leverage the improved linking system for reusing assets across files
If you're coming from Blender 2.8/2.9 with the original Cats plugin, take some time to explore the new features in Unofficial Cats. Many workflows have been streamlined and improved.
Troubleshooting Common Issues
If add-ons don't appear after installation:
- Check if they're enabled in the Add-ons preferences
- Verify that you've installed the correct version for Blender 4.2
- Restart Blender completely
If models import incorrectly:
- Try using the Cats importer instead of Blender's native importers
- Check for any error messages in the Blender console (Window > Toggle System Console)
- Verify that your model files aren't corrupted
If you experience performance issues:
- In Blender 4.2, check Edit > Preferences > System for hardware acceleration settings
- Adjust the Viewport settings for better performance with complex models
- Consider using Simplify options in the Render Properties panel
Always keep backups of your projects when transitioning to a new Blender version. Some features and add-ons may behave differently than you're used to.
Ready to get started with the recommended version?