GuidesBasic usage

The menu

Press - (the - key) or type /bitchos. The bind is swallowed before the game sees it, so Lunar's own menu cannot open on the same key.

The menu is one panel with a category sidebar on the left: Hypixel, Bedwars, Legit+, Render, Utility, Scripts, GUI. The header has an advanced toggle that reveals the tuning settings most people never need. The footer reminds you of the controls.

The menu remembers the selected tab, which drawers are open and the advanced flag between openings. Every change saves at once.

Controls

control	how it works
module row	left-click toggles it, right-click opens its settings drawer
toggle	click to flip
dropdown	left-click cycles forward, right-click cycles back
slider	click and drag
key	left-click, then press a key to bind; right-click clears; Esc cancels
text	click to edit in place; Ctrl+V pastes, Ctrl+A clears, Enter accepts, Esc cancels; right-click clears the value
checkbox list	click to open the list, tick what you want

The mouse wheel scrolls. Esc or the menu key closes the menu and saves.

Secret settings such as API keys render masked, showing only the last four characters, so a screenshot of the menu does not leak them.

Keybinds

• Menu: Interface → MenuKey, default -. Also /bitchos bind <key> with an LWJGL key name (MINUS, RSHIFT, RCONTROL, INSERT, HOME, F6, P…); none clears it, after which only /bitchos opens the menu.
• HUD editor: HUD → EditKey, unbound by default. Also /bitchos hud.
• FreeLook: FreeLook → Key, default Alt (left).
• Scripts can declare their own key settings; those appear on the script's row.

Older configs

Before v0.21 the default menu key was Right Shift, which is also Lunar's own mod-menu bind. Configs created back then keep whatever they had. Rebind with /bitchos bind MINUS if the two clash.

Commands

Everything lives under one prefix so nothing can shadow a Hypixel command:

/bitchos <subcommand>       also .bitchos and /bc

The ones you will use most:

command
/bitchos	open the menu
/bitchos help	the full list, with your current bind
/bitchos list	every module and whether it is on
/bitchos toggle <module>	switch one without the menu
/bitchos settings <module>	every setting, its value and its range
/bitchos set <module> <setting> <value>	change one from chat
/bitchos hud	the HUD editor

Two commands live outside the prefix because they replace something you already type: /pl stats (stats for your whole party) and /status <player>. The commands page has everything, including the diagnostics.

Where your files are

Everything bitchos writes lives in ~/.bitchos/ (%USERPROFILE%\.bitchos on Windows):

file	what
config.json	every module's state and settings, written atomically
hud.json	HUD positions, kept apart from the config so a reset does not scatter the HUD
license.key	your key
tags.json	your player tags
history.json	bitchos wrapped match history
scripts/, extensions/	your scripts and compiled extensions
capes/	downloaded capes, plus any 64×32 PNG you add
agent.log, install.log, launch-arg.txt	Lunar loader diagnostics and the JVM argument as text

Create an empty file named no-autoupdate in that folder to turn self-updating off.