Skip to main content

​
General Questions

LiquidBounce is a free and open-source mixin-based injection hacked client using the Fabric API for Minecraft. It provides various modules and features to enhance your Minecraft gameplay.
LiquidBounce is licensed under GPL-3.0 and is completely free to use.
Yes, LiquidBounce is open-source, which means anyone can review the code. You can check the source code on GitHub to verify there are no malicious components.However, using any client modifications may violate server rules or terms of service. Always check server policies before using LiquidBounce.
LiquidBounce supports multiple Minecraft versions through Fabric. Check the official website or GitHub releases for the latest supported versions.
Yes, LiquidBounce is completely free and open-source under the GPL-3.0 license. There are no premium features or paid versions.
Technically yes, but many servers prohibit the use of client modifications. Using LiquidBounce on servers may result in a ban. Always respect server rules and only use it where permitted.

​
Installation Questions

  1. Install Fabric for your Minecraft version
  2. Download LiquidBounce from the official website
  3. Place the .jar file in your .minecraft/mods folder
  4. Launch Minecraft with the Fabric profile
See the Installation Guide for detailed instructions.
LiquidBounce uses Fabric, not Forge. Make sure you have the Fabric mod loader installed, not Forge.
Place the LiquidBounce .jar file in your .minecraft/mods folder:
  • Windows: %appdata%/.minecraft/mods
  • macOS: ~/Library/Application Support/minecraft/mods
  • Linux: ~/.minecraft/mods
Check the following:
  1. You’re using Fabric, not Forge or Vanilla
  2. The .jar file is in the correct mods folder
  3. You’re using a compatible Minecraft version
  4. Check the logs for any errors (see Troubleshooting)
Yes, LiquidBounce is compatible with most Fabric mods. However, some mods may conflict. If you experience issues, try disabling other mods to identify conflicts.

​
Module Usage

Press the Right Shift key (default) to open the ClickGUI, then click on modules to enable/disable them. You can also bind modules to keys for quick toggling.
See the Modules Overview for detailed information.
  1. Open the ClickGUI (Right Shift)
  2. Right-click or hover over a module
  3. Click on the bind option
  4. Press the key you want to bind
Alternatively, use the command:
.bind <module> <key>
In the ClickGUI, click on a module to expand its settings. You can adjust values, toggle options, and configure the module to your preferences.
  • Modules are built-in features coded in Kotlin/Java
  • Scripts are custom modules written in JavaScript that extend functionality
Scripts allow users to create custom modules without modifying the core code.
Try the following:
  1. Check if the module is enabled
  2. Review the module settings - some require specific configurations
  3. Check for mod conflicts
  4. Verify you’re on a compatible server/version
  5. Check logs for errors (.minecraft/logs/latest.log)

​
Configuration Questions

LiquidBounce stores configurations in:
  • Windows: %appdata%/.minecraft/LiquidBounce/
  • macOS: ~/Library/Application Support/minecraft/LiquidBounce/
  • Linux: ~/.minecraft/LiquidBounce/
Copy the entire LiquidBounce folder from your .minecraft directory to a safe location. This includes all settings, scripts, and configurations.
Yes! You can export your settings and share the configuration files. Others can import them by placing the files in their LiquidBounce folder.
Delete or rename the LiquidBounce folder in your .minecraft directory. The client will create a new folder with default settings on next launch.
This will delete all your custom configurations, keybinds, and scripts. Make a backup first!
  • accounts.json - Saved alt accounts
  • settings.json - Module settings
  • binds.json - Keybinds
  • scripts/ - Custom scripts folder

​
Commands

Open the chat and type . (dot) followed by the command. For example:
.help
.bind Fly F
.toggle Sprint
The default command prefix is . (dot). You can change it in the settings if needed.
Type .help in chat to see a list of all available commands and their usage.
Yes, you can create custom commands using the scripting API. See the Scripting Guide for more information.

​
Scripting

LiquidBounce uses JavaScript for scripting, allowing you to create custom modules and commands.
Place script files (.js) in the LiquidBounce/scripts/ folder in your .minecraft directory.
Use the command:
.reload
This will reload all scripts without restarting Minecraft.
Check the Scripting Guide and the community forum for script examples and tutorials.
  1. Check the file extension is .js
  2. Verify it’s in the correct folder (LiquidBounce/scripts/)
  3. Check for syntax errors in your script
  4. Look at the console/logs for error messages
  5. Try using .reload to reload scripts

​
Performance

Try these optimizations:
  1. Disable unused modules
  2. Reduce render distance
  3. Lower graphics settings
  4. Disable resource-intensive modules (ESP, Tracers, etc.)
  5. Check for mod conflicts
See the Troubleshooting Guide for more tips.
  1. Install performance mods like Sodium or Iris
  2. Disable visual modules you don’t need
  3. Reduce particle effects
  4. Lower Minecraft’s graphics settings
  5. Allocate more RAM to Minecraft (2-4GB recommended)
Yes, LiquidBounce is compatible with performance mods like Sodium and Iris. They can actually improve performance when used together.

​
Troubleshooting

  1. Check you’re using the correct Minecraft version
  2. Verify Fabric is properly installed
  3. Check for mod conflicts
  4. Review crash logs in .minecraft/crash-reports/
  5. Try removing other mods to isolate the issue
See the Troubleshooting Guide for detailed help.
  • Latest log: .minecraft/logs/latest.log
  • Crash reports: .minecraft/crash-reports/
These files contain error messages that can help diagnose issues.
Debug mode provides additional logging information. Enable it in the LiquidBounce settings or check the logs for detailed error messages.

​
Still Have Questions?

Discord Community

Join our Discord server for real-time help

Forum

Browse discussions and ask questions

GitHub Issues

Report bugs or request features

Support Guide

Learn how to get help effectively

Build docs developers (and LLMs) love

Get started for freeTalk to us