CatLean Client is a free, open-source Minecraft PvP client built for the Fabric mod loader. With over 150 modules, advanced combat utilities, and continuous updates for the latest Minecraft versions, it has quickly become a popular choice for players who want an edge in PvP and anarchy servers. This guide covers everything you need to know about CatLean, from installation to module breakdowns and safety tips.
What is CatLean Client?
CatLean Client is a Fabric-based Minecraft utility mod designed primarily for PvP, anarchy, and ghost client gameplay. It is developed as a modern alternative to the ThunderHack Recode Client, offering a similar feature set with active development and regular updates. The client is completely free to download and use, making it accessible to players who want advanced combat and utility modules without paying for premium clients.
One of CatLean's biggest strengths is its compatibility with the latest Minecraft versions. The development team prioritizes keeping the client updated, so you can expect support for new Minecraft releases shortly after they launch. As of mid-2026, CatLean supports Minecraft 1.21.4, 1.21.9, 1.21.10, 1.21.11, and the latest 26.2 snapshot. This rapid update cycle means you rarely have to wait long to use CatLean on the newest version of the game.
CatLean is categorized as both an anarchy client and a ghost client, meaning it is designed to work on servers that allow or disallow cheats. Its modules range from combat-focused tools like Sword HVH and Crystal HVH to utility features like Elytra Target and Auto Mine. Whether you are playing on a 2b2t-style anarchy server or a competitive PvP arena, CatLean has modules tailored to your playstyle.
The client is written in Kotlin, a modern programming language that runs on the Java Virtual Machine. This choice of language allows the developers to write clean, maintainable code and take advantage of modern language features. For users, this translates to a stable client with fewer bugs and faster update cycles compared to older clients written in legacy Java.
Key Features of CatLean Client
CatLean ships with a massive library of over 150 modules, but a few stand out as the most popular and powerful. Here is a breakdown of the core features that make CatLean worth trying.
Sword HVH
Sword HVH is CatLean's flagship combat module. It includes an Aura system with multiple methods designed to bypass anti-cheat plugins, allowing you to dominate opponents in sword fights. The module offers customizable rotation settings, target selection filters, and hitbox expansion options. You can fine-tune the aura to match your playstyle, whether you prefer aggressive rushing or calculated, timing-based combat.
The Sword HVH module also includes criticals, which automatically perform critical hits when you attack, and a shield breaker that can disable opponent shields at the right moment. These features combine to create a combat module that is both powerful and customizable. Whether you are fighting in a 1v1 duel or a chaotic free-for-all, Sword HVH gives you the tools to come out on top.
Komar HVH
Komar HVH is a utility-focused module built around Elytra combat. It includes the standard Elytra Target feature with customizable speed settings and advanced peak techniques for maximum efficiency. Beyond the basics, Komar HVH also features Elytra Mace Target, which automates mace attacks while flying, and the new Elytra Freeze module, which can lock opponents in place during aerial combat. These features make CatLean one of the most capable Elytra combat clients available.
The Elytra Target system in Komar HVH is particularly impressive. It can track opponents from extreme distances, adjust your flight path automatically, and time your attacks for maximum damage. The peak technique allows you to gain altitude quickly before diving on your target, giving you a significant speed and damage advantage. Combined with Elytra Mace Target, you can deliver devastating mace hits while maintaining full flight control.
Crystal HVH
Crystal HVH is CatLean's crystal PvP module, and it is one of the most advanced in the scene. The Auto Crystal feature comes with all essential functions you would expect, including automatic crystal placement, explosion timing, and target prediction. What sets CatLean apart is the advanced logic and synchronization with other modules like Speed Mine and Auto Mine. This coordination allows you to break opponent defenses and place crystals in a single, fluid motion, giving you a significant advantage in crystal fights.
The crystal placement algorithm in CatLean is designed to maximize damage while minimizing self-damage. It calculates the optimal position for each crystal based on the opponent's location, armor, and health. The module also includes a self-damage limiter that prevents you from placing crystals that would hurt you more than your target. This level of sophistication makes Crystal HVH a favorite among competitive crystal PvP players.
PVE and Utility Modules
Beyond combat, CatLean is a full-featured utility client with over 150 modules covering PVE, building, movement, and quality of life. You will find modules for auto mining, auto building, inventory management, and more. The PVE modules are particularly useful for anarchy server players who need to gather resources efficiently while avoiding griefers and hostile players.
The utility modules in CatLean are designed to work together seamlessly. For example, the auto mining module can be configured to automatically switch to the best tool for each block, repair your tools when they break, and send mined items to your inventory. The auto building module can place blocks according to a schematic, making it easy to construct bases or bridges without manual placement. These features save time and let you focus on the more exciting aspects of gameplay.
How to Install CatLean Client
Installing CatLean is straightforward if you have used Fabric mods before. Follow these steps to get up and running.
Requirements
Before downloading CatLean, make sure you have the following installed:
- Fabric Loader - The core mod loader required to run Fabric mods. Download it from the official Fabric website and run the installer for your operating system.
- Fabric API - A library mod that many Fabric mods depend on. CatLean requires it to function properly. Place the JAR file in your mods folder.
- Fabric Language Kotlin - CatLean is written in Kotlin, so this language module is mandatory. Without it, the game will crash on startup. This is the most commonly missed dependency.
Installation Steps
- Download and install the latest version of Fabric Loader for your Minecraft version from the official Fabric website.
- Run the Fabric installer and select your Minecraft version. The installer will create a new profile in your Minecraft launcher.
- Download the Fabric API JAR file from a trusted source and place it in your
modsfolder. The mods folder is located in your Minecraft directory. - Download the Fabric Language Kotlin mod and place it in the same
modsfolder. Make sure you download the version that matches your Minecraft version. - Download the CatLean Client JAR file from a trusted source and place it in your
modsfolder. - Launch Minecraft using the Fabric profile. CatLean should load automatically. You will see a confirmation message in the chat if it loaded successfully.
Tip: If the game crashes on startup, double-check that you have installed Fabric Language Kotlin. This is the most common cause of CatLean crashes, and it is an easy fix. Also verify that all your mods are for the correct Minecraft version.
Updating CatLean
When a new version of CatLean is released, simply download the new JAR file and replace the old one in your mods folder. It is a good idea to back up your CatLean configuration before updating, as major updates may change module names or settings. You can find your configuration in the config/catlean folder inside your Minecraft directory.
CatLean Modules Breakdown
With over 150 modules, CatLean can feel overwhelming at first. Here is a categorized overview of the most important module groups to help you get started.
Combat Modules
The combat category includes Sword HVH, Crystal HVH, Komar HVH, and several aura variants. These modules handle target selection, rotation, timing, and anti-cheat bypassing. Each combat module has extensive settings that let you adjust range, speed, rotation mode, and target priority. Spend time in a test world or on a practice server to fine-tune these settings before using them in real PvP.
CatLean also includes specialized combat modules for specific scenarios. For example, the Totem module automatically equips a totem of undying when your health is low, and the Gap module automatically eats a golden apple when you take damage. These small but crucial features can mean the difference between winning and losing a fight.
Movement Modules
Movement modules include speed, fly, elytra boost, and various movement assists. These are useful for traversing large anarchy server maps quickly or gaining a mobility advantage in PvP. Be aware that some movement modules are more detectable than others, so use them cautiously on servers with active anti-cheat systems.
The speed module in CatLean is highly configurable, allowing you to adjust speed levels, bypass methods, and movement style. The fly module offers multiple modes, including creative-style flight and packet-based flight, each with different levels of detectability. The elytra boost module enhances your elytra flight speed and can be combined with Komar HVH for devastating aerial combat.
Render Modules
Render modules add visual overlays like ESP, tracers, and HUD elements. These can help you locate players, see through walls, and track important game information at a glance. While render modules are generally safe to use on anarchy servers, they can be considered cheating on servers with strict rules.
The ESP module in CatLean can display player names, health, distance, and equipped items through walls. The tracer module draws lines to nearby players, making them easy to track even in crowded areas. The HUD module displays important information like your current module status, FPS, and coordinates in a customizable overlay.
Utility Modules
Utility modules cover everything from auto eating and auto tool switching to inventory management and chat commands. These quality-of-life features make CatLean more than just a combat client. They are perfect for players who want a single mod that handles all their gameplay needs.
Some of the most useful utility modules include Auto Eat, which automatically eats food when your hunger bar is low, Auto Tool, which switches to the best tool for the block you are mining, and Auto Refill, which restocks your inventory from a chest when items run low. These modules may seem simple, but they save a tremendous amount of time during long play sessions.
Is CatLean Client Safe to Use?
Safety is a common concern with any PvP client, and CatLean is no exception. Here is what you need to know about using CatLean safely.
Download Safety
Always download CatLean from the official source or a well-known, trusted mod repository. Avoid third-party download sites that may bundle malware with the mod JAR file. The official CatLean download links are verified and safe to use. Before running any JAR file, you can scan it with an antivirus program for extra peace of mind.
Server Rules
CatLean is designed for anarchy servers and servers that explicitly allow utility mods. Using it on servers that prohibit cheats can result in a ban. Always check the server rules before enabling any modules. If you are unsure, ask a server administrator or stick to servers that are known to allow CatLean. Many anarchy servers have Discord communities where you can ask about allowed mods.
Account Safety
Using CatLean on your main Minecraft account carries inherent risk. While the client itself is safe to install, using cheats on servers that prohibit them can lead to account bans. Consider using an alternate account if you plan to use CatLean on servers with uncertain rules. This way, your main account remains safe even if you get banned on a particular server.
Malware and Virus Concerns
CatLean itself is not malware. It is a legitimate Minecraft mod that does not contain viruses, trojans, or other malicious code. However, as with any mod you download from the internet, there is always a risk of downloading a modified version that contains malware. To minimize this risk, only download CatLean from the official source or trusted repositories like 9Minecraft or CurseForge.
Frequently Asked Questions
Is CatLean Client free?
Yes, CatLean is completely free to download and use. There are no premium tiers, subscriptions, or hidden costs. The development team maintains the client through community support and voluntary contributions. You will never be asked to pay for access to modules or features.
What Minecraft versions does CatLean support?
As of mid-2026, CatLean supports Minecraft 1.21.4, 1.21.9, 1.21.10, 1.21.11, and the 26.2 snapshot. The development team regularly updates the client to support new Minecraft versions shortly after release. You can check the official download page for the most up-to-date version compatibility information.
Why does my game crash after installing CatLean?
The most common cause of crashes is a missing dependency. Make sure you have installed Fabric Loader, Fabric API, and Fabric Language Kotlin. If all three are installed and the game still crashes, check that you are using the correct CatLean version for your Minecraft version. Also verify that you do not have any conflicting mods installed that may interfere with CatLean.
How do I open the CatLean GUI?
By default, the CatLean GUI opens when you press the P key. If pressing P does not open the GUI, check your keybind settings in the Minecraft controls menu. You can also rebind the GUI key to any key you prefer. Some users have reported that the P key conflicts with other mods, so try a different key if you experience issues.
How do I set keybinds in CatLean?
You can set keybinds using the in-game chat command. Type <module_name> bind <key> in chat to assign a keybind to any module. For example, typing Crystal bind P will toggle the Crystal module when you press P. You can also use the GUI to set keybinds by clicking on a module and selecting the keybind option.
Can I use CatLean on Hypixel or other minigame servers?
No. CatLean is not designed for minigame servers like Hypixel, and using it there will almost certainly result in a ban. CatLean is intended for anarchy servers, PvP practice servers, and servers that explicitly allow utility mods. Using cheats on servers that prohibit them is against the rules and can result in permanent bans.
Is CatLean better than ThunderHack Recode?
CatLean is designed as a spiritual successor to ThunderHack Recode, and in many ways it improves upon the original. It offers more modules, better performance, and more frequent updates. However, the best client for you depends on your specific needs and preferences. Some players prefer the interface of ThunderHack, while others prefer CatLean's module organization and customization options.
