Skip to main content

​
Getting Started

This guide will walk you through the essential features of LiquidBounce. By the end, you’ll know how to enable modules, set keybinds, use the ClickGUI, and execute commands.
Make sure you’ve completed the installation before starting this guide.

​
Opening the ClickGUI

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

Press the ClickGUI Keybind

The default keybind is Right Shift. Press it to open the ClickGUI.
The ClickGUI module is located in the Render category and is always running. It cannot be disabled, but you can change its keybind.
2

Navigate the Interface

The ClickGUI displays all modules organized by category:
  • Combat: PvP and combat-related modules
  • Movement: Speed, flight, and movement enhancements
  • Player: Inventory management and player utilities
  • World: Block interaction and world manipulation
  • Render: Visual enhancements and ESP
  • Misc: Miscellaneous utilities
  • Exploit: Server exploits and special features
  • Fun: Cosmetic and entertainment features
3

Search for Modules

Use the search bar to quickly find modules by name. The search supports auto-focus for faster access.

​
Enabling Your First Module

Let’s enable a simple module to get familiar with the interface.
1

Open the ClickGUI

Press Right Shift to open the ClickGUI.
2

Select a Category

Click on the Render category to see visual enhancement modules.
3

Enable FullBright

Find and click on FullBright to enable it. This module increases brightness so you can see in dark areas.
When a module is enabled, you’ll see a notification in the top-right corner confirming the activation.
4

Verify It's Working

Enter a dark cave or turn off all lights. You should now see clearly without torches!

​
Using Commands

LiquidBounce features a powerful command system accessible via the in-game chat.

​
Command Prefix

By default, all LiquidBounce commands start with a dot (.). You can change this prefix using the client settings.

​
Basic Commands

.toggle <module>
.t <module>

​
Example: Toggle a Module

1

Open Chat

Press T to open the chat.
2

Type the Command

Type .toggle FullBright or .t FullBright
Commands are case-insensitive and support auto-completion. Press Tab to cycle through suggestions.
3

Press Enter

The module will toggle on or off, and you’ll see a confirmation message.

​
Setting Keybinds

Keybinds allow you to quickly toggle modules without opening the ClickGUI.

​
Method 1: Using the ClickGUI

1

Open ClickGUI

Press Right Shift.
2

Select a Module

Click on any module to view its settings.
3

Find the Bind Setting

Look for the Bind option in the module settings.
4

Click and Press Key

Click on the bind field and press the key you want to assign.
5

Save

The keybind is automatically saved. You can now toggle the module with your chosen key.

​
Method 2: Using Commands

You can also set keybinds via commands: 
.bind <module> <key>
Examples: 
.bind KillAura R
.bind Fly G
.bind Sprint LCONTROL
Use key names like R, G, LSHIFT, LCONTROL, etc. Press Tab after typing the module name for key suggestions.

​
Bind Actions

Modules support different bind actions:
  • TOGGLE: Switches the module on/off (default)
  • HOLD: Module is active only while the key is held
You can configure the bind action in the module’s settings.

​
Exploring Module Settings

Most modules have configurable settings to customize their behavior.
1

Open a Module

In the ClickGUI, click on any module to open its settings panel.
2

Adjust Settings

You’ll see various configuration options:
  • Sliders: Adjust numerical values (range, speed, etc.)
  • Toggles: Enable/disable sub-features
  • Dropdowns: Select from predefined options
  • Text Fields: Enter custom text or values
3

Use Value Groups

Some modules have nested settings called “Value Groups” that organize related options.
4

Save Changes

All changes are automatically saved to your configuration.

​
Module Categories Explained

​
Combat Modules

Modules focused on PvP and combat:
  • KillAura: Automatically attacks nearby entities
  • Velocity: Reduces or removes knockback
  • AutoArmor: Automatically equips the best armor
  • Criticals: Forces critical hits

​
Movement Modules

Enhance your movement capabilities:
  • Fly: Allows you to fly in survival mode
  • Speed: Increases movement speed
  • Sprint: Automatically sprints
  • Step: Step up multiple blocks at once

​
Render Modules

Visual enhancements and information:
  • ESP: Highlights entities through walls
  • Tracers: Draws lines to entities
  • Nametags: Customizes name displays
  • HUD: Heads-up display with module list

​
Player Modules

Utilities for the player:
  • ChestStealer: Automatically steals from chests
  • InventoryCleaner: Organizes your inventory
  • NoFall: Prevents fall damage
  • AutoTool: Selects the best tool automatically

​
World Modules

Interact with the world:
  • Scaffold: Automatically places blocks beneath you
  • FastBreak: Breaks blocks faster
  • FastPlace: Places blocks faster
  • AutoMine: Automatically mines blocks

​
Configuration Management

LiquidBounce supports multiple configurations for different scenarios.

​
Save Current Config

.config save <name>

​
Load a Config

.config load <name>

​
List Configs

.config list

​
Local Configs

Local configs are server-specific configurations that load automatically: 
.localconfig create <name>
.localconfig load <name>
Create different configs for different servers or game modes (e.g., “hypixel”, “pvp”, “minigames”).

​
Managing the HUD

The HUD (Heads-Up Display) shows active modules and information.
1

Enable HUD Module

The HUD module in the Render category controls the on-screen display.
.toggle HUD
2

Customize HUD

Open the HUD module settings in ClickGUI to:
  • Change colors and themes
  • Enable/disable specific elements
  • Adjust positioning and size
  • Configure the module list (ArrayList)

​
Hiding Modules

You can hide modules from the HUD’s module list: 
.hide <module>
To unhide: 
.hide <module>
You can also set the Hidden option to true in the module’s settings.

​
Panic Mode

Quickly disable all modules at once: 
.panic
Panic mode will disable all active modules instantly. Use this if you need to quickly appear legitimate.

​
Script Support

LiquidBounce supports custom scripts for advanced users.

​
Load a Script

.script load <file>

​
List Scripts

.script list

​
Reload Scripts

.script reload
Scripts are loaded from the LiquidBounce/scripts folder in your Minecraft directory. Learn more about scripting in the Script API documentation.

​
Tips and Best Practices

Start Simple

Begin with simple modules like FullBright and Sprint before trying complex combat modules.

Test in Singleplayer

Always test new modules in singleplayer before using them on servers.

Read Module Descriptions

Hover over modules in the ClickGUI to see descriptions and learn what they do.

Use Tab Completion

Press Tab while typing commands to see available options and auto-complete.

Backup Configs

Regularly save your configurations so you don’t lose your settings.

Join the Community

Join the Discord or forums to get help, share configs, and learn from others.

​
Common Issues

Some servers have anti-cheat systems that may block or detect certain modules. Always check server rules before using LiquidBounce.
  • Check if another module is using the same keybind
  • Ensure you’re not in a GUI or typing in chat
  • Try rebinding to a different key
The ClickGUI module might have a different keybind. Check the module settings or use:
.toggle ClickGUI
Your config might not be saving. Check file permissions in the LiquidBounce folder and ensure the client has write access.

​
Next Steps

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

Module Reference

Detailed documentation for every module

Command Reference

Complete list of all available commands

Script API

Learn to create custom modules with JavaScript

Contributing

Contribute to LiquidBounce development
Have questions? Join our Discord or visit the forums for help!

Build docs developers (and LLMs) love

Get started for freeTalk to us