Skip to main content
Fun modules add cosmetic effects and silly features for entertainment. These modules don’t provide competitive advantages but can make your gameplay more enjoyable.

Cosmetic Modules

Exaggerated view bobbing.Source: fun/ModuleDankBobbing.kt

Features

  • Adjustable bobbing intensity
  • Customizable patterns
  • Smooth transitions
Makes your head spin randomly.Source: fun/ModuleDerp.kt

Features

  • Random head movements
  • Configurable speed
  • Server-side visibility
Makes your hand move randomly.Source: fun/ModuleHandDerp.kt

Features

  • Random hand animations
  • First-person effects
  • Customizable intensity
Rapidly changes skin layers.Source: fun/ModuleSkinDerp.kt

Features

  • Toggle skin layers
  • Random pattern
  • Strobe effect

Movement Effects

Makes your character twerk.Source: fun/ModuleTwerk.kt

Features

  • Rapid sneaking animation
  • Configurable speed
  • Farming effect (bone meal)
Throws items like vomiting.Source: fun/ModuleVomit.kt

Features

  • Rapidly drop items
  • Random item selection
  • Visual effect

Entertainment

Plays music with note blocks.Source: fun/notebot/ModuleNotebot.kt

Features

  • Load MIDI files
  • Automatic note block placement
  • Tune playing
  • Multi-track support

Supported Formats

  • MIDI files (.mid)
  • Note block studio files

Usage

  1. Load a song file
  2. Module will place note blocks
  3. Plays the tune automatically

Configuration

  • Speed - Playback speed
  • AutoBuild - Auto-place note blocks
  • Loop - Repeat song

Fun Module Combinations

For maximum entertainment, try combining these modules:
Derp + HandDerp + SkinDerp
Spin everywhere while your skin flashes!

Module Showcase

Notebot Example

The Notebot module can play complex musical pieces:
// Located at: fun/notebot/ModuleNotebot.kt
object ModuleNotebot : ClientModule("Notebot", ModuleCategories.FUN) {
    // Loads and plays MIDI files
    // Places note blocks automatically
    // Handles multi-track songs
}

Visual Effects

These modules create visual effects that other players can see:
  • Derp - Others see your head spinning
  • SkinDerp - Others see your skin layers changing
  • Twerk - Others see you sneaking rapidly
  • Vomit - Others see items being thrown

Client-Side Effects

These only affect your view:
  • DankBobbing - Only you see the exaggerated bobbing
  • HandDerp - Only you see the hand movements

Usage Tips

Fun modules are great for:
  • Screenshots and videos
  • Entertaining friends
  • Server events and parties
  • Testing module system
Some servers may have rules against “disruptive” behavior. Use these modules responsibly:
  • Don’t spam in crowded areas
  • Respect server rules
  • Turn off if asked by staff

Module Directory

All fun modules are located in:
src/main/kotlin/net/ccbluex/liquidbounce/features/module/modules/fun/

Creating Custom Fun Modules

Fun modules are great for learning module development:
object ModuleCustomFun : ClientModule("CustomFun", ModuleCategories.FUN) {
    val intensity by float("Intensity", 1f, 0.1f..5f)
    
    @Suppress("unused")
    private val tickHandler = tickHandler {
        // Your fun effect here!
    }
}
See the Module Development guide for more information.

Build docs developers (and LLMs) love