Troubleshooting FPS Drops & Freezing
Does your game lag or freeze with LiquidBounce, while playing or when you open the HUD, ClickGUI or a menu? Work through these steps in order. Most people only need the first few.
Table of Contents
- Check RAM Allocation
- Check RAM Speed (Critical)
- Verify GPU is Being Used
- Update GPU Drivers (Critical)
- Remove Conflicting Mods
- Enable Accelerated Paint (Critical)
- Optimize HUD and Theme Settings
- Limit GUI Renderer FPS
- Reduce Rendering Quality (Last Resort)
1. Check RAM Allocation
The game needs enough memory (RAM). Too little is one of the most common reasons for lag.
Using LiquidLauncher
LiquidLauncher gives the game 4 GiB by default, which is enough for most people. To check it:
- Open LiquidLauncher
- Go to Settings or Launch Options
- Check the RAM allocation (it should be at least 4 GiB)
- Change it if needed
Using Minecraft Launcher
The official Minecraft Launcher often gives the game only 2 GiB, which may not be enough:
- Open Minecraft Launcher
- Go to the Installations tab
- Hover over your installation, click the three dots, then Edit
- Click More Options
- Find the JVM Arguments field
- Look for
-Xmx2G(this means 2 GiB at most) - Change it to
-Xmx4G(or-Xmx6Gif your computer has 16 GB of RAM or more) - Make
-Xmsthe same, for example-Xms4G -Xmx4G - Save and launch
For more help, see this tutorial on allocating RAM to Minecraft.
Check System Environment Variables
Some settings on your computer can override what the launcher says. Check them too:
Windows:
- Press
Win + R, typesysdm.cpl, and press Enter - Go to the Advanced tab, then Environment Variables
- Look in both User variables and System variables for:
_JAVA_OPTIONSJAVA_TOOL_OPTIONSJDK_JAVA_OPTIONS
- If one of them has a low
-Xmxor-Xmsvalue (like-Xmx2G), either:- delete the variable, or
- raise the values to at least
-Xms4G -Xmx4G
- Click OK and restart your computer
Linux/macOS:
- Open your shell configuration file (
~/.bashrc,~/.zshrc, or~/.profile) - Look for lines like:
export _JAVA_OPTIONS="-Xmx2G" export JAVA_TOOL_OPTIONS="-Xmx2G" - Delete these lines or raise the values to
-Xmx4G - Reload your shell with
source ~/.bashrc(or open a new terminal)
Note: 4 to 6 GiB is a good amount. Don't give the game more than half of your computer's total RAM.
Verify RAM Allocation In-Game
- Launch Minecraft with LiquidBounce
- Press F3 to open the debug screen
- Look at the memory line in the top right corner (for example "Mem: 25% 1024/4096MB")
- The second number should match the RAM you set (4096MB = 4 GB)
2. Check RAM Speed (Critical)
LiquidBounce's menus are drawn by a small built-in web browser, and every picture it draws goes through your RAM before it reaches the graphics card. Slow RAM makes the game lag, even with a fast graphics card.
The gl-bench tool tests whether your RAM is the slow part.
Enable XMP in BIOS
XMP (Extreme Memory Profile) lets your RAM run at the speed it was sold with. Without it, RAM often runs slower:
- Restart your computer and open the BIOS (usually by pressing
Delete,F2, orF12while it starts) - Find the XMP, DOCP or EOCP setting (where it is depends on your motherboard):
- ASUS/MSI/Gigabyte: usually under "AI Tweaker", "OC", or "Advanced"
- AMD motherboards: look for DOCP (Direct Overclock Profile)
- Turn on XMP Profile 1 (or DOCP)
- Save and exit the BIOS
This has fixed FPS drops for many players.
Check RAM Slot Configuration
Your RAM sticks should sit in the right slots:
- Check your motherboard manual for which slots to use
- With 2 sticks, this is usually slots 2 and 4 (or A2 and B2)
- Reseat the sticks if needed
Alternative: Reset BIOS Settings
If you don't want to change BIOS settings yourself, you can reset them:
- Open the BIOS
- Find "Load Optimized Defaults" or "Reset to Default"
- Save and exit
3. Verify GPU is Being Used
If your monitor cable is plugged into the motherboard instead of the graphics card, your computer uses the weaker built-in graphics.
Check Your Monitor Connection
- Look at the back of your computer
- Find where the monitor cable is plugged in:
- Right: in the graphics card (usually lower on the case, in its own slot)
- Wrong: in the motherboard (usually higher up, near the USB ports and audio jacks)
- If it is in the motherboard, shut down your computer and move the cable to the graphics card
Verify in Windows
- Open Task Manager (
Ctrl + Shift + Esc) - Go to the Performance tab
- Look for GPU 0 and GPU 1 (you see both if your computer has built-in graphics)
- Launch Minecraft with LiquidBounce
- Check which GPU is busy. It should be your graphics card (NVIDIA or AMD), not Intel built-in graphics
4. Update GPU Drivers
Old graphics drivers can cause lag and other problems.
NVIDIA:
- Visit NVIDIA Driver Downloads
- Select your GPU model and operating system
- Download and install the latest Game Ready Driver
AMD:
- Visit AMD Driver Downloads
- Select your GPU model
- Download and install the latest Adrenalin driver
Intel:
- Visit Intel Driver & Support Assistant
- Use the auto-detect tool or pick your GPU yourself
- Download and install the latest driver
5. Remove Conflicting Mods
Other mods can slow the game down or clash with LiquidBounce:
- Make a backup of your mods folder
- Remove every mod except LiquidBounce and the mods it needs
- Check if the lag is still there
- If it's gone, add your mods back one at a time to find the one causing it
6. Enable Accelerated Paint
Accelerated Paint lets your graphics card draw the menus directly, which can make them much faster. It is set to Auto, so it turns on by itself on computers where it is known to work.
To turn it on yourself:
- Open the ClickGUI (RSHIFT)
- Go to Settings, then GuiRenderer, then AcceleratedPaint
- Set it to On
Good to know:
- It only works on Windows and Linux.
- AMD graphics cards: a known bug can slowly fill up your video memory over a long session. Keep an eye on it.
- Intel graphics: not supported because of driver problems.
- Linux: works on both Wayland and X11.
7. Optimize HUD and Theme Settings
Use Default Theme
Custom themes can be slower. To switch back to the default theme:
- Open the chat
- Type
.client theme set liquidbounce - The default theme loads right away
Learn more on the Theme System Overview page.
Disable Unnecessary HUD Components
Every HUD element costs a little speed. Turn off the ones you don't use:
- Go to HUD, then Themes, then your theme's name (for example LiquidBounce), then Components
- Look through the elements that are turned on
- Turn off the ones you don't need
See HUD Customization for more.
8. Limit GUI Renderer FPS
With no limit, the menus can redraw as often as your screen allows. Setting a limit of 60 can help a lot:
For HUD:
- Go to HUD, then Renderer, then Fps
- Set it to
60
For ClickGUI:
- Go to ClickGUI, then Renderer, then Fps
- Set it to
60
9. Reduce Rendering Quality (Last Resort)
If nothing else helped, you can lower the quality of the menus. They will look blurry (at the lowest setting they draw at half resolution), but the game can run much faster:
- Open the ClickGUI (RSHIFT)
- Go to Settings, then GuiRenderer, then Quality
- Lower the value (1 is full quality, 0.5 is the lowest)
Only do this if every other step failed.
Still Having Issues?
Contact our support team and send:
- Your computer's parts (CPU, GPU, RAM)
- Your Minecraft version and LiquidBounce build
- What you do when the problem happens
- Your latest.log file from the logs folder:
- LiquidLauncher (Windows):
%APPDATA%/CCBlueX/LiquidLauncher/gameDir/nextgen/logs - LiquidLauncher (Linux):
~/.local/share/liquidlauncher/gameDir/nextgen/logs - LiquidLauncher (macOS):
~/Library/Application Support/liquidlauncher/gameDir/nextgen/logs - Minecraft Launcher:
.minecraft/logs/
- LiquidLauncher (Windows):
- A video of the problem, if you can