Module System

Overview of LiquidBounce’s powerful module system

LiquidBounce’s module system is the core of the client, providing a wide range of features organized into categories. Each module can be toggled on/off and configured to suit your needs.

Module Categories

Modules are organized into nine main categories:

Combat

Attack and defense modules for PvP combat

Movement

Enhanced movement and mobility modules

Player

Player automation and enhancement modules

Render

Visual enhancements and ESP modules

World

World interaction and building modules

Exploit

Server exploit and bypass modules

Misc

Miscellaneous utility modules

Fun

Fun and cosmetic modules

Using Modules

Toggling Modules

Modules can be enabled/disabled through:

• ClickGUI - Press the configured key (default: Right Shift)
• Console Commands - .toggle <module> or .t <module>
• Keybinds - Assign custom keybinds to modules

Configuring Modules

Each module has various configuration options:

1. Open ClickGUI and navigate to the module
2. Click on the module to expand its settings
3. Adjust values, toggles, and modes as needed
4. Changes are automatically saved

Module Structure

All modules follow a consistent structure:

object ModuleExample : ClientModule("Example", ModuleCategories.CATEGORY) {
    // Configuration options
    val option by boolean("Option", true)
    val range by float("Range", 4.5f, 1f..10f)
    
    // Event handlers
    @Suppress("unused")
    private val tickHandler = tickHandler {
        // Module logic
    }
}

Module Features

Modes

Many modules support multiple modes for different situations or anti-cheat bypasses:

val modes = choices("Mode", ModeA, arrayOf(
    ModeA,
    ModeB,
    ModeC
))

Value Groups

Modules can organize related settings into groups:

object Rotations : RotationsValueGroup(this) {
    val timing by enumChoice("Timing", NORMAL)
    val speed by float("Speed", 180f, 1f..180f)
}

Event Handlers

Modules respond to game events:

• tickHandler - Runs every game tick
• handler<Event> - Handles specific events
• rotationUpdateHandler - Handles rotation updates
• packetHandler - Handles network packets

Source Code Reference

All modules are located in:

~/workspace/source/src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules/

Explore each category to learn about specific modules and their capabilities.