Skip to main content

​
Launch the client

After completing the installation, you’re ready to launch LiquidBounce.
1

Build and run

From your LiquidBounce directory, run:
./gradlew runClient
This will compile the project and launch Minecraft with LiquidBounce injected. The first launch may take a few minutes as Gradle downloads dependencies and builds the theme.
On Windows, use gradlew.bat instead:
gradlew.bat runClient
2

Wait for Minecraft to load

The Minecraft client will start with LiquidBounce integrated. You should see the LiquidBounce logo during the loading screen.
If this is your first time running the client, additional setup like downloading game assets may take extra time.
3

Join a world or server

Create a new world or join a multiplayer server to start using LiquidBounce modules. Most modules require you to be in-game to function.

​
Access the ClickGUI

The ClickGUI is your primary interface for managing modules and their settings.
1

Open the ClickGUI

Press the Right Shift key (default keybind) to open the ClickGUI interface.You can customize this keybind in the ClickGUI module settings located at:
src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules/render/ModuleClickGui.kt
2

Navigate the interface

The ClickGUI displays all modules organized by category:
  • Combat: KillAura, Velocity, Criticals, AutoWeapon
  • Movement: Speed, Flight, Spider, Step
  • Player: NoFall, Blink, AutoRespawn, InventoryCleaner
  • World: Scaffold, FastBreak, Timer, AutoTool, Nuker
  • Render: ESP, Nametags, Tracers, FullBright, ClickGUI
  • Misc: Various utility modules
  • Exploit: Advanced server-side exploits
  • Fun: Experimental and entertainment features
Click on a category to expand it and view available modules.
3

Configure settings

The ClickGUI includes several configuration options:
  • Scale: Adjust the UI scale (0.5x to 2x)
  • SearchBarAutoFocus: Automatically focus the search bar when opening
  • Snapping: Enable grid snapping for organized module placement
  • Cache: Use standalone screen caching for better performance
These settings are defined in ModuleClickGui.kt:57-99.

​
Enable your first module

Let’s enable Scaffold, one of the most popular modules for building and bridging.
1

Find the Scaffold module

In the ClickGUI, navigate to the World category and locate the Scaffold module.Alternatively, use the search bar to quickly find it by typing “scaffold”.
2

Enable the module

Click on the module to toggle it on. You should see a visual indicator that the module is now active.
The Scaffold module is located at src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules/world/scaffold/ModuleScaffold.kt.
3

Configure module settings

Click the settings icon next to the module name to access its configuration:
  • Technique: Choose bridging technique (Normal, GodBridge, Breezily, Expand)
  • Tower: Configure tower mode (Motion, Hypixel, Karhu, Vulcan, None)
  • Rotations: Adjust rotation settings for bypassing anti-cheat
  • AutoBlock: Automatically select blocks from inventory
  • Sprint Control: Manage sprinting behavior while scaffolding
These options are defined throughout the Scaffold module and its features.
4

Test the module

Hold the sneak key (default: Shift) and walk backwards off an edge. Scaffold will automatically place blocks beneath you.Try different techniques to find what works best for your playstyle:
  • Normal: Standard scaffolding with customizable features
  • GodBridge: Fast diagonal bridging technique
  • Breezily: Smooth bridging with speed optimization
  • Expand: Multi-directional block placement
Here are some essential modules to get you started:

KillAura

Automatically attacks enemies within rangeLocation: src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules/combat/killaura/ModuleKillAura.ktCategory: CombatKey settings: Range, CPS, Rotations, AutoBlock

FullBright

Increases brightness for better visibility in dark areasLocation: src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules/render/ModuleFullBright.ktCategory: RenderKey settings: Brightness level, Mode

Sprint

Automatically sprints while moving forwardCategory: MovementKey settings: Multi-directional, Food check

NoFall

Prevents fall damage using various techniquesLocation: src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules/player/nofall/ModuleNoFall.ktCategory: PlayerKey settings: Mode (Packet, Blink, NoGround, MLG)

​
Understanding module categories

LiquidBounce organizes modules into 8 categories defined in src/main/kotlin/net/ccbluex/liquidbounce/features/module/ModuleCategories.kt:23-68: 
object ModuleCategories {
    val COMBAT = register(ModuleCategory("Combat"))
    val PLAYER = register(ModuleCategory("Player"))
    val MOVEMENT = register(ModuleCategory("Movement"))
    val RENDER = register(ModuleCategory("Render"))
    val WORLD = register(ModuleCategory("World"))
    val MISC = register(ModuleCategory("Misc"))
    val EXPLOIT = register(ModuleCategory("Exploit"))
    val FUN = register(ModuleCategory("Fun"))
}
Each module inherits from ClientModule and specifies its category: 
// Example: ClickGUI module
object ModuleClickGui :
    ClientModule("ClickGUI", ModuleCategories.RENDER, bind = GLFW.GLFW_KEY_RIGHT_SHIFT, disableActivation = true)

​
Keybinds

Modules can be bound to keys for quick toggling:
  1. Open the ClickGUI (Right Shift)
  2. Navigate to the module you want to bind
  3. Click the keybind button
  4. Press the key you want to assign
  5. The module will now toggle when you press that key
Some modules come with default keybinds:
  • ClickGUI: Right Shift (GLFW.GLFW_KEY_RIGHT_SHIFT)
You can view default bindings in each module’s source code:
ClientModule("ClickGUI", ModuleCategories.RENDER, bind = GLFW.GLFW_KEY_RIGHT_SHIFT)
  1. Open the ClickGUI
  2. Navigate to the module
  3. Click the keybind button
  4. Press Escape or Delete to remove the binding

​
Configuration basics

LiquidBounce modules use a sophisticated configuration system:

​
Value types

Modules support various configuration value types: 
// Boolean toggle
val enabled by boolean("Enabled", true)

// Numeric value with range
val range by float("Range", 4.2f, 3f..8f)

// Integer with steps
val delay by int("Delay", 100, 0..1000, "ms")

// Choice from enum
val mode by enumChoice("Mode", TechniqueMode.NORMAL)

// Multiple selections
val requires by multiEnumChoice<Requirements>("Requires")

​
Example: Scaffold configuration

The Scaffold module demonstrates advanced configuration: 
// Technique selection
val technique = tree(
    ScaffoldNormalTechnique,
    ScaffoldGodBridgeTechnique,
    ScaffoldBreezilyTechnique,
    ScaffoldExpandTechnique
)

// Rotation settings
object ScaffoldRotationValueGroup : ToggleableValueGroup(this, "Rotations", true) {
    val rotationTiming by enumChoice("Timing", ON_TICK)
    val considerInventory by boolean("ConsiderInventory", false)
}

​
Tips for beginners

Start simple

Begin with basic modules like FullBright and Sprint before trying complex combat or movement modules.

Test in singleplayer

Try modules in a singleplayer world first to understand how they work without risking server bans.

Read module descriptions

Hover over modules in the ClickGUI to see descriptions and usage tips.

Join the community

Join the Discord server for support, configuration help, and module recommendations.
Using LiquidBounce on multiplayer servers may violate their terms of service. Use at your own risk and always respect server rules.

​
Next steps

Now that you know the basics, explore more advanced features:

Module documentation

Learn about all available modules and their configurations

Scripting API

Create custom modules and extend LiquidBounce with scripts

Contributing

Learn how to contribute to the LiquidBounce project

Advanced configuration

Deep dive into module configuration and customization

Build docs developers (and LLMs) love

Get started for freeTalk to us