Scripts
The Script API lets people from our community add features to LiquidBounce with JavaScript scripts, from simple macros to an NES Emulator.
Installing the Script API
Scripts need the Script API add-on. Without it, neither scripts nor the .script command are available.
- Install it from the Marketplace with
.marketplace subscribe 771, see Add-ons- Or download
liquidbounce-scriptapi-*.jarfrom the add-on's releases and install it like any other mod, either as an additional mod in LiquidLauncher or by placing it in the mods folder of a manual installation
- Or download
- Restart the game and check that
.addon listshowsliquidbounce-scriptapi
Managing Scripts
The following commands are available to manage your scripts:
.script list
Shows a list of all installed scripts, and the ones that failed to load.
.script browse
Opens the scripts folder where all your scripts are stored.
.script load <file>
Loads a script. Replace <file> with the script's file name.
.script unload <name>
Unloads a script. Replace <name> with the script's name.
.script reload
Reloads all scripts. Use this command after adding new scripts to load them into the client.
.script errors <name>
Shows the errors a script ran into.
.script edit <file>
Opens a script in your default text editor.
.script debug <file> [protocol] [suspendOnStart] [inspectInternals] [port]
Loads a script with a debugger attached, see Debugging.
Installing Scripts
You can find scripts in our community forum's script section. To install a script:
- Type
.script browseto open the scripts folder - Copy the script file into this folder. A script that comes as a zip file is extracted into its own folder, which needs a
main.js(ormain.mjs) file - Type
.script reloadto load the new script - Use
.script listto check that the script was loaded
Improving Script Performance
Scripts run considerably faster on GraalVM than on other Java runtimes. You have two options to use GraalVM:
-
Using LiquidLauncher (recommended)
- Open LiquidLauncher settings
- Set JVM Distribution to Manual
- Select GraalVM as the Distribution
-
Manual GraalVM installation
- Download GraalVM from GraalVM's official website
- Install it and set it as the Java runtime in your Minecraft launcher
- Launch LiquidBounce using the GraalVM installation
Source: A Simple Benchmark Performance Test for LiquidBounce's ScriptAPI
Developing Scripts
To write your own scripts, see Getting Started.
Last updated: 2026-11-11, based on source code