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 LTS

You 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:

  1. Download the Extension ZIP file
  2. Go to Edit > Preferences > Extensions
  3. Click on the Down arrow in the top right, then click 'Install from disk'
  4. Select the downloaded ZIP file
  5. 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:

  1. Go to Edit > Preferences > Extensions
  2. You'll need to allow online access when prompted (this usually appears on first access)
  3. 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:

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:

Source Tools

For working with Source engine models (Valve games):

Installation:

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:

FIX MMD MODEL SHOULD ONLY BE USED FOR NEW MMD/VRM MODELS WHICH HAVE NOT BEEN SET UP FOR UNITY. DO NOT USE THIS IF YOUR MODEL HAS ALREADY BEEN SET UP FOR UNITY (PURCHASED FROM GUMROAD, BOOTH OR SIMILAR) OR IF YOU ARE CREATING YOUR OWN MODEL.

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?