Documentation

Theme System

LiquidBounce features a Theme System that allows you to customize the appearance of the client. The theme affects all graphical user interfaces (GUIs) throughout the client, including but not limited to the HUD, ClickGUI, main menu, and any other visual elements.

LiquidBounce Theme

The default theme of LiquidBounce provides a clean and modern look:

The LiquidBounce theme is included in LiquidBounce. However, if you want to create your own theme, see the Creating Your Own Theme section below.

Installing Themes from Marketplace

The easiest way to install themes is through the built-in Marketplace:

1. Browse available themes: .marketplace list theme

   • This displays all themes available in the marketplace

2. Install a theme: Click on your desired theme, which will run:

   • .marketplace subscribe <id>
   • The theme will be automatically downloaded and installed

3. Apply the theme: After installation, use:

   • .client theme list to see all installed themes
   • Click on the theme you just installed, which will run .client theme set <id>

Themes

JelloBounce Theme

Install with: .marketplace subscribe 265
Repository

BeautifyV2 Theme

Install with: .marketplace subscribe 581
Repository

Wurst Theme

Install with: .marketplace subscribe 561
Repository

Creating Your Own Theme

For developers who want to create custom themes:

1. Clone the theme template:

   git clone https://github.com/CCBlueX/LiquidBounce-Theme
   cd LiquidBounce-Theme
   

2. Edit the metadata file (public/metadata.json):

   {
     "id": "your-custom-id",
     "name": "YourTheme",
     "version": "0.1.0",
     "authors": ["YourName"]
   }
   

   Change from the default:

   {
     "id": "liquidbounce",
     "name": "LiquidBounce",
     "version": "0.1.0",
     "authors": ["CCBlueX"]
   }
   

3. Install dependencies and start development server:

   npm install
   npm run dev
   

4. Test your theme in LiquidBounce:

   • In the game chat, type: .client theme set http://localhost:5173/
   • Your theme will load in real-time as you make changes

5. Publish to Marketplace:

   • Once your theme is ready, you can submit it to the Marketplace for others to use by contacting us.

Security Warning

Only install themes from trusted sources!

Themes can establish HTTP/WebSocket connections to external servers, which means malicious themes could:

• Take over control of your client
• Steal sensitive information
• Perform unauthorized actions

We strongly discourage downloading themes from unknown sources or untrusted developers. Always use the official Marketplace when possible.