Xiaoli client documentation

Xiaoli beta 1.4.0 for Minecraft 1.21.11.

Getting started

Download Xiaoli from your dashboard for Minecraft 1.21.11.

Requires Java 21, Fabric Loader 0.19.3, and Fabric API 0.141.6+1.21.11.

Supports Windows, Linux, and macOS; macOS supports Intel and Apple Silicon.

Install the downloaded JAR in your Fabric instance's mods folder, launch Minecraft, and enter the license key from your dashboard. Keep the Fabric Loader and Fabric API versions matched to this Minecraft version.

Linux GameMode in 1.5.0

On Minecraft 26.2, Xiaoli can use an installed Feral GameMode library. When detected, the main menu offers Enable next launch or Dismiss. You can also change GameMode in Settings under Preferences. It is off by default.

Install GameMode through your distribution if needed. Xiaoli does not install packages. Prism's GameMode option or its gamemoderun wrapper is another way to enable it; Xiaoli recognizes an existing launcher request. Performance gains depend on your system and GameMode configuration.

Registered devices

The dashboard shows up to two registered devices, each on a different operating system: Windows, Linux or macOS. Use Reset hwid to select one device to remove. You get one reset every 30 days across both slots. The other device stays registered, and the dialog shows when your next reset is available.

Keybinds

Assign and clear module binds

Press Right Shift to open ClickGUI, then middle-click a module to bind it.

.bind module zoom C
.bind mode zoom hold
.bind module zoom CLEAR

Escape clears a module bind while assigning it; hold Tab to view binds. Key labels use their printed symbols, such as +, - and =.

Hold and toggle behavior

Hold bind keeps a module active only while its key is held.

Settings and shared controls

Tables show fresh-config defaults, allowed values and slider steps. Conditional controls appear when their feature or mode is selected. Distances use blocks, speeds use blocks/s or blocks/tick, and ticks use t.

Search and input

Start typing in ClickGUI to focus search when no input field, keybind or popup owns the input. Ctrl+F focuses search explicitly. Enter or Escape leaves the search field; typing again starts a new query.

Search matches module names and IDs first. When no modules match, it searches visible settings across modules. Text fields, numeric editing, dropdown type-ahead and chat retain their own input.

Setting controls

Click a slider value to enter an exact number. Enter applies it; Escape cancels. Range sliders have separate lower and upper values.

Drag a submenu header out of its module and release at the left or right snap hint to dock it. Click its arrow to collapse or expand it; drag it back to return it inline. Docks hide with their module and save with the config.

Modes with independent settings remember their values when switched. Toggles named Enabled stay shared; cosmetic selectors such as box, path and landing styles do not switch surrounding settings.

Colors and opacity

Use the color picker's alpha strip to change opacity. HEX accepts #RRGGBB or #RRGGBBAA; RGB accepts three or four byte values. The module tables use the same HEX format.

In a filled box with a shared color, alpha changes the fill without fading its outline, labels or tracers. Separate outline and tracer colors keep their own alpha; outline-only styles use the selected color's alpha.

Client settings

Open the top-right gear or .settings. Preferences contains language, Allow movement, Blur background, Show keybinds, Animations, Render friends and Chat above menus. Chat above menus displays ordinary chat over ClickGUI and custom menus; it does not open chat input.

Profile shows your account and links to its dashboard settings. Cloud configs is currently unavailable in the client; use the website's Configs page.

Target filters

Choose Players, Hostile and Passive; supported visual modules also offer Local player, which requires Players enabled.

Combat targeting excludes friends. Render friends in client settings controls whether visual target filters include them.

Attack timing and CPS

Auto Clicker separates left-click attack timing from right-click CPS; Kill Aura and Triggerbot use attack cooldown timing.

Rotation controls

Shared rotation settings appear in modules that aim, place or rotate, including Kill Aura, Safe Anchor, Auto Farm, Hit Crystal, Auto Pot, Bow Aimbot, Routes, Clutch and Scaffold.

Defaults vary by module and mode; each module lists its starting rotation settings. Polar uses the shared rotation controls. Selecting a named model does not establish compatibility with a server's anticheat.

Action delays

Delays set the minimum wait between actions.

Macros support 0–250 ms between-tick delays; inventory actions still run on game ticks.

Configs

ClickGUI config manager

Manage configs in ClickGUI → Configs.

Use New, Save and Folder; click a config to load it and use its three-dot menu or right-click for actions. Put downloaded configs in Folder, or open it with .config folder.

Save, load, reset, and delete

Configs save module states, settings, mode-specific values, binds, HUD layout, panel positions and docked submenus.

.config save <name>
.config load <name>
.config reset <name>
.config delete <name>

Repeat a load within 30 seconds to discard changes; use .confirm for resets.

Names allow 1–64 letters, digits, spaces, _ and -, starting with a letter or digit. Names are saved in lowercase; the active config cannot be deleted.

Saving your changes

The default config autosaves; use Save or .save <name> to save a named config. Loading a config with unsaved changes asks whether to save or discard them.

Scripts, routes, proxy profiles, and Auto Login passwords are separate from configs.

Client commands

Commands use the . prefix by default; module names and IDs are case-insensitive and ignore spaces and underscores.

Quote module names containing spaces, such as .toggle "Hit Crystal", or use the listed command ID.

.anticheat

Scans the current multiplayer server for anticheat evidence. Alias: .ac.

.anticheat

Results distinguish observed evidence from an unknown result; they do not guarantee detection.

.bind

Assigns module, config and script keybinds. Scripts use keyboard keys; module binds support Hold or Toggle.

Alias: .b.

.bind list
.bind module <module_id> <key|CLEAR>
.bind config "<config_name>" <key|CLEAR>
.bind script "<script_name>" <key|CLEAR>
.bind mode <module_id> hold
.bind mode <module_id> toggle

.clickgui

Resets ClickGUI panel positions; Right Shift opens ClickGUI.

Alias: .cgui.

.clickgui reset

.clear

Clears visible chat without deleting sent-message history.

.clear

.config

Creates, saves, lists, loads, resets or deletes configs using the config rules. Folder opens the config directory.

Alias: .c.

.config create <config_name>
.config save <config_name>
.config list
.config load <config_name>
.config reset <config_name>
.config delete <config_name>
.config folder

.configs

Lists saved configs.

.configs

.confirm

Confirms a pending config reset within 30 seconds.

.confirm

.dashboard

Opens the account dashboard in your browser.

Alias: .dash.

.dashboard

.delete

Deletes a saved config unless it is currently active.

.delete <config_name>

.destroy

Unloads Xiaoli until Minecraft restarts.

Alias: .suicide.

.destroy

.fakeplayer

Spawns or removes a local practice player.

.fakeplayer <name>
.fakeplayer remove

.route

Records, lists, previews, and replays saved movement routes.

.route
.route start [name]
.route stop
.route list
.route preview
.route play <name|id|number> here
.route play <name|id|number> start

Quote names with spaces when playing; Here shifts the route, while Start walks to its recorded start.

.friend

Adds or removes Minecraft targeting friends.

Alias: .f.

.friend add <player>
.friend remove <player>

.ghostblock

Places a local preview block, copies the held stack locally, or clears previews.

.ghostblock
.ghostblock stack
.ghostblock clear

Hold a block and aim at a placement surface; previews do not create server items.

.hclip

Moves you the specified number of blocks in your current movement direction.

Alias: .h.

.hclip <distance>

.ignore

Toggles messages from a Xiaoli account.

.ignore <username>

.load

Loads a config; repeat within 30 seconds if asked to discard changes.

.load <config_name>

.network

Reports ping, protocol, packet rates, channels, transactions, and hosting data for the connection IP.

Aliases: .net, .hosting.

.network

.plugins

Lists server plugins that the server exposes.

Alias: .pl.

.plugins

.online

Lists online Xiaoli users.

.online

.prefix

Shows or changes the command prefix to a single symbol.

.prefix
.prefix <character>

.reply

Replies to the latest Xiaoli whisper.

Alias: .r.

.reply <message>

.save

Saves and activates a config, overwriting an existing file of that name.

.save <config_name>

.say

Sends literal Minecraft chat, such as .say .example.

.say <message>

.serverinfo

Shows server information, plugins, or network details.

Alias: .si.

.serverinfo
.serverinfo plugins
.serverinfo network

.scripts

Opens the script editor and manages JavaScript presets. Aliases: .script, .spam, .spammer.

.scripts
.scripts create <name>
.scripts list
.scripts run "<name>"
.scripts stop
.scripts eval await client.notify("Hello");

Stop ends active scripts and suspends addons until their parent is toggled or the script is run again.

.settings

Opens client preferences and profile settings. Alias: .setting.

.settings

.toggle

Toggles a module.

Alias: .t.

.toggle <module_id>

.tps

Shows estimated current and average server TPS.

Alias: .tickspersecond.

.tps

.unbind

Removes a module, config or script binding. Alias: .ub.

.unbind module <module_id>
.unbind config <config_name>
.unbind script <script_name>

.username

Copies your Minecraft name to the clipboard.

Alias: .ign.

.username

.vclip

Moves you vertically by the specified number of blocks.

Alias: .v.

.vclip <distance>

.whisper

Sends a private message to a Xiaoli account.

Aliases: .w, .msg.

.whisper <user> <message>

Chat and friends

Whisper to Xiaoli users with .whisper <user> <message> and reply with .reply <message>.

Use .friend add <player> for targeting friends and .ignore <user> to mute Xiaoli messages.

Scripts and block editor

Code and Blocks edit the same JavaScript source. Open .scripts, create a preset, then Save and Run. Set its key in the editor or with .bind script.

Create and run a script

Every script starts with // @xiaoli-js 2. Actions return Promises; await actions whose result or completion you need. Durations are milliseconds.

// @xiaoli-js 2
await client.notify("Starting");
await tasks.wait(500);
await client.notify("Finished");

JavaScript supports functions, classes, arrays, objects, Promises and top-level await. Imports, file access and Java class access are unavailable. No separate JavaScript installation is needed.

Old language and chat presets remain editable for recovery but cannot run. Their cycle, menu and random-prefix flags do not apply to JavaScript.

Code, Blocks and recovery

Switch between Code and Blocks without changing source or comments. Blocks supports statements, expressions, functions, arrays, objects, event callbacks and API calls. Other syntax stays in editable Source blocks; Shift+Enter adds a line.

Drag statements to reorder them and reporters into compatible inputs. Moving blocks across variable scopes is rejected; use Code for intentional scope changes.

Edits autosave after a short pause. Invalid drafts remain recoverable and do not replace the last valid saved preset. Fix the indicated error before Run.

Editor shortcuts

Use the preset drawer to switch scripts. Completion shows parameters; diagnostics selects the affected source. Fullscreen changes the editor window size without changing the script.

Script kinds

An optional second-line // @script comment contains JSON metadata.

An addon uses a real module ID or name:

// @xiaoli-js 2
// @script {"kind":"addon","module":"killaura","priority":50}
events.on("module.attack", event => {
    if (player().health < 6) return {cancelled: true};
});

Addons affect actions from their parent module. Manual actions and other modules' actions are separate. Use an automation's packet.incoming for incoming network packets.

A script module needs an ID beginning with script_, a name, description and category. Categories are combat, movement, world, visual and utility. Settings support boolean, number with min/max/step, string and color defaults.

// @xiaoli-js 2
// @script {"kind":"module","id":"script_health","name":"Health text","description":"Shows health","category":"visual","settings":[{"name":"Size","type":"number","default":12,"min":6,"max":30,"step":1}]}
const self = module("script_health");
events.on("render.hud", () => {
    if (!connection.state().connected) return;
    render.text({text: String(player().health), x: 12, y: 12,
        size: module.setting(self, "Size"), color: "#FFFFFFFF"});
});

Editing a script module preserves matching settings and its bind. Deleting its preset removes the registered module.

Script timing and events

Waits and tasks

tasks.wait(ms) and tasks.until(predicate, timeout) yield while waiting. Both return cancellable Promises. tasks.after(ms, callback) runs once; tasks.every(ms, callback) repeats without overlapping its own unfinished callback. tasks.cancel(id) removes a scheduled task.

// @xiaoli-js 2
const task = tasks.every(1000, async () => {
    if (connection.state().connected) await client.notify("Health: " + player().health);
});
await tasks.wait(5000);
tasks.cancel(task);

Use normal JavaScript conditions, loops, functions and try/catch/finally. Await inside long-running loops. Promise.all combines independent actions; conflicting movement, inventory or interaction actions wait their turn.

Event callbacks

events.on(name, callback, priority) returns a listener ID; events.off(id) removes it. Higher priorities run first. Script metadata priority orders scripts, then preset name; listener priority orders callbacks within a script.

Movement, packet, module decision and render callbacks are synchronous. Do not await, return a Promise or schedule actions inside them. Return only changed fields; the first change to each field wins, and cancellation ends the decision.

// @xiaoli-js 2
events.on("movement.input", event => {
    if (event.forward > 0) return {sprint: true};
});

Event reference

movement.input accepts forward/sideways from -1 to 1 plus jump, sneak and sprint. movement.pre and movement.packet_pre accept velocity, on_ground and cancelled. The post events observe completed work.

module.target uses target_id for Kill Aura candidates and target_index for Scaffold's candidate positions. Attack replacements must be loaded entities within reach; placement edits still require valid block positions, faces and hit points.

Stop and world changes

.scripts stop stops all running scripts; script.stop() stops the current script. Stop releases held input, use actions, rotations, routes, temporary settings, timers and owned packet holds. A stop callback can read state but cannot schedule new work.

World changes cancel pending world actions and waits. Scripts using connection APIs or world/connection listeners can survive with those lifecycle listeners and stop; other listeners must be registered again after joining. Addons stop at a world transition.

Script values and game actions

Values and snapshots

Use JavaScript numbers, strings, booleans, arrays, objects and null. Durations are numeric milliseconds; position(x,y,z), rotation(yaw,pitch), item(id) and slot(space,index) construct API values.

module(name) returns a live module handle. Player, world, inventory and connection queries return snapshots; query again after an awaited action when current state matters.

player() includes position, rotation, health, hunger, on_ground, alive, flying, gliding, swimming, in_water, sprinting, sneaking, climbing, using_item, riding, pose and movement_state. connection.state() is safe outside a world. world.block reads a loaded block; world.entities queries loaded entities; world.target reads the crosshair target.

Module settings

module.state(handle) reads enabled state. module.settings(handle) lists canonical setting paths; module.describe(handle) adds their types, choices and bounds. Masked values are excluded.

Use module.set(handle, path, value) or module.toggle_setting. Canonical paths disambiguate repeated labels. Numeric values use the API's bounds rather than displayed units; for example, Fly speed 1 displays as 20 blocks/s.

Range settings use [minimum, maximum]; modes accept their names. Script color settings use #AARRGGBB. Read module.describe before writing an unfamiliar setting.

module.set_temporary restores the old value when released during cleanup. A later user edit prevents restoration over that edit.

Inventory and crafting

Logical slots are independent of the current screen's numeric slot IDs.

Use inventory.slots() and inventory.screen() to inspect the current contents. inventory.select selects a hotbar slot; click, move, equip and drop use logical slots. Clear anything held on the inventory cursor before a multi-step action.

inventory.sort maps slot names to item values, such as {"hotbar.0": item("minecraft:diamond_sword")}. A null value clears that slot into free inventory space. Required items and space must be available.

Click modes are pickup, quick_move, swap, throw, quick_craft, pickup_all and creative-only clone. Pickup, quick_move, throw and pickup_all accept buttons 0/1; swap uses hotbar 0–8 or offhand 40; clone uses 2. Quick_craft uses Minecraft's drag-stage buttons: 0/1/2, 4/5/6 or 8/9/10.

craft.recipes() lists available recipes; craft.recipe crafts by ID. craft.grid uses four cells for the player grid or nine for a crafting table, in row order. Empty cells use null. Actions still require the matching ingredients and screen.

Movement, rotations and interaction

movement.walk and movement.key hold input for a duration. Directions accept forward, back, left, right, jump, sneak and sprint, combined with spaces or +. movement.jump requests a normal jump; movement.stop releases this script's input. movement.set_velocity changes velocity directly.

look.to/at moves the visible camera. rotation.configure selects the shared model and correction; rotation.to/at holds silent aim, and rotation.release returns it. Independent movement and rotation can run together with Promise.all.

Interaction actions use loaded targets within reach and the correct held item. interaction.break mines a block; interaction.place places the held item against a block face. Menus, missing items or changed targets can prevent an action.

world.entities accepts a 0–128 block range and all, living, players, items or a namespaced entity type. Results are nearest first. Interaction hands use main/off; block faces use up, down, north, south, east or west.

Routes, connections and Baritone

route.start/stop records movement; route.play replays a saved name, ID or list number from here or start. route.wait waits for completion; route.cancel stops owned playback.

connection.connect, disconnect and reconnect use normal Minecraft connections. Reconnect waits once and does not keep retrying. Closing a world cancels its pending actions.

Baritone is optional. Check baritone.available() before use. baritone.command runs a local command without a # prefix; baritone.wait waits for it. Settings use Baritone's native text formats. Stop only cancels Baritone work owned by that script.

Script packets and drawing

Packet handles

packet.create(type, fields) creates an owned packet handle. Types are movement, position, ground, look, slot, swing, keep_alive, pong, velocity, message and raw. packet.describe reads the type, direction and size; packet.modify returns an edited handle.

Known fields remain unchanged unless replaced. Raw packets use base64 bytes containing the Minecraft 1.21.11 play packet ID and payload, plus incoming/outgoing direction. Replacements must keep their direction; only outgoing packets can be sent. For 64-bit IDs beyond JavaScript's safe integer range, use decimal strings.

Handles expire after the last 128 handles or a stop/world change. packet.describe includes raw bytes only up to 48,000 bytes.

Delay and queue

Return {delay_ms: 100} from a packet callback to delay it, {cancelled: true} to cancel, or {packet: handle} to replace it with an owned packet handle.

await packet.queue(direction) holds subsequent packets. await packet.delay(ms, direction) holds them for up to 5,000 ms. packet.flush releases this script's hold; another module or script can continue holding the shared queue. packet.discard discards the releasable held segment.

More than 2,048 queued packets stops the responsible script. Keepalives and required protocol transitions follow the client's queue rules. Disconnect clears queued state.

HUD and world drawing

Draw only inside render.hud or render.world. HUD coordinates are screen coordinates; world drawing uses positions. HUD text supports rubik-regular and JetBrainsMono-Regular.

Colors accept unsigned ARGB numbers or #AARRGGBB. render.color(r,g,b,a) packs byte channels. Scale and clipping last for the callback only.

Each callback allows 512 draw/state operations; text is limited to 2,048 characters. World line widths are 0.25–8 in 0.25 steps. Prepare repeated geometry on tasks and keep render callbacks short.

Execution limits

Scripts have execution-time and instruction limits. Blocking loops and expensive callbacks stop the script; use yielding waits and scheduled tasks. API arrays and objects are limited to 4,096 entries.

Scripts can control movement, inventory and network traffic. Inspect downloaded code before running it.

Script API reference

Arguments are positional. Promise<T> marks an action to await; other calls return immediately. duration means milliseconds, list means a JavaScript array, and object means a plain record. Optional defaults follow =.

Value helpers

Connection API

Baritone API

Route API

Module API

Chat API

Client API

Movement API

Look API

Rotation API

Interaction API

Inventory API

Craft API

World API

Events API

Tasks API

Script API

Packet API

Render API

HUD editor

Drag HUD elements into place and save the layout with your config.

Hold Left Shift while dragging to disable snapping. Arrow keys move the selected element by exactly one screen pixel, without snapping. Right-click an element for its settings.

HUD elements

Default: Watermark, Array list and Scoreboard. Base finder appears while its module has evidence to show.

Optional: Version, Release stream, Server, FPS, CPS, BPS, Ping, Lag alerts, Session, XYZ, Target HUD, Armor, Totem pop counter, Effects, Scaffold indicator, Break progress, Crosshair, Scripts, Keybinds, Keystrokes, Activity, Media, and Notifications.

Lag alerts appear after 1.5 seconds without a server time update; Totem pop counter resets on death or world change.

HUD element controls

Adjust each element's size, blur, outline, rainbow color and available options. HUD panel colors and opacity follow the shared HUD theme and Surface opacity.

Media HUD

Displays the current desktop track, artwork, and playback progress on Windows.

Enable Media in the HUD editor and play audio in an app with Windows media controls.

Classic uses artwork and separate track information. Compact uses one horizontal artist - title line. Both show a progress bar; long text scrolls back and forth. Animations defaults On; Hide inactive defaults Off.

Proxy profiles

Route new connections through SOCKS5 or HTTP CONNECT proxies.

Open Multiplayer → Proxies, add a host and port, then enable the profile before connecting.

Import formats: host:port, host:port:username:password, socks5://host:port, or http://host:port.

Motion Modifier rules

Open Movement → Motion Modifier → Edit motion. Rules save with your config. Add, copy, reorder, disable or remove rules in the list; drag its lower divider to change the space available to the list. The editor window keeps the same size between tabs. Use Fullscreen or Restore when needed.

Triggers and timing

The When tab selects the counter, stage, environment and movement target. Targets include Player, Vehicle, Boat, Horse and Player or vehicle. Vehicle rules require you to control the mount; vehicle-only rules stop when you dismount.

Counters start at 0. First tick and Last tick are inclusive. Tick list accepts 0, 2-4, 7 and overrides those bounds. Every N ticks and Offset filter the selection further. Tick selections allow 0–1199; repeat periods allow up to 1200 ticks.

Repeat can inherit the program period, never repeat, or repeat every N ticks. Once per trigger prevents execution on later ticks until that counter restarts. State counters stop being active when their state ends; event counters remain active until the next occurrence or reset.

Only moving, Jump key held and Wait for damage are shared gates. Disable Only moving for stationary, move-stop or dismount rules. For an action only on a transition, select tick 0 with no repeat or enable Once per trigger. Use Player or Player or vehicle for a dismount action on foot.

Unmet gates, environment or conditions can Reset, Pause or Continue a rule's clock. Menus and world changes do not replay missed transitions.

Motion and physics

Rules run in list order. Before and After surround movement; additional stages surround Jump, Acceleration, Collision, Gravity and Drag. Packet runs before movement-packet construction. Stages only run when that movement path reaches them.

Motion uses blocks/tick. Explicit horizontal speed is limited to 0–10; vertical and world-axis velocity to -10–10. World X/Z apply after horizontal speed and steering. Off preserves the current value.

Strafe Blend interpolates toward the selected direction. Preserve speed turns without reducing magnitude and limits the turn angle. Direction can follow input, camera, server yaw or existing travel.

Physics operations use Set, Add or Multiply. Drag is the fraction of velocity retained, not a percentage to subtract. Physics coefficients are bounded to -10–10; fall distance to 0–100,000 blocks. Tick speed allows 0.05–10× and is shared with other timer users.

Living mounts support their normal travel and jump stages. Boats support gravity, drag, paddle acceleration and velocity edits; use vertical motion rather than the grounded jump action. Separate Elytra or special-effect movement can bypass a physics stage.

Conditions can compare speed, vertical velocity, fall distance, ground distance, movement and collision state, input, item use, hurt time, health, effect levels, block friction, riding state and queued packet count. Combine supports Add, Subtract, Multiply and Divide by another metric. Invalid arithmetic, including division by zero, does not match. Ground distance checks up to 32 blocks; boolean values use 1/0.

Packet fields

Enable Edit movement packet to set position and rotation offsets, Ground and Collision. Keep preserves a field; True or False overrides the reported state. Vehicle packets have no Collision field.

Next packet is useful when a rule changes the value that triggered it, such as resetting fall distance. A cancelled send leaves it armed; a sent or queued packet consumes it. Repeated triggers before that packet coalesce. Edits, menus, corrections, target/world changes and disabling clear pending edits.

Offsets change reported packet fields; they do not move the local entity or force a new packet every tick.

Packet delivery

Select Movement, Input, Interactions or Movement and actions. Movement includes player and vehicle movement; Input includes paddles and sprint/sneak commands; Interactions includes attacks, uses, swings, block actions and slot changes.

A started hold continues between rule triggers until Release, reset or a new policy. Delay and maximum hold allow up to 10 seconds; capacity allows up to 1,024 packets. The oldest packets release when a limit is reached. New matching arrivals stay behind a queue that is draining.

Keepalives, teleport confirmations, resource-pack replies, chat and protocol transitions are not delayed by Motion Modifier. Another module's hold can keep packets queued after Release. Menus, edits and disabling release this module's queue; corrections and world/target changes discard stale movement and actions.

Diagnostics and corrections

Diagnostics shows rule activity, motion, queued holds and conflicting module/script writes. Release drains owned holds; Clear trace clears the history.

On correction, choose Reset, Pause, Cooldown or Disable. Cooldown accepts 1–1200 eligible ticks. Resume clears pause/cooldown and restarts counters. A correction preserves the preceding 32 trace records for inspection.

Modules overview

Enable modules in ClickGUI or with .toggle <module_id>. Disabler is temporarily unavailable in ClickGUI.

Combat modules

Aim Assist

Command ID: aim_assist.

Adjusts aim toward targets within Range and FOV.

Anchor Macro

Command ID: anchor_macro.

Automates anchor placement, charging, and detonation.

Keep anchors and glowstone available, then hold use; disable Safe Anchor first.

Anti Bot

Command ID: antibot.

Excludes detected fake players from combat targeting. Player list, Profile mismatch and Server checks can be enabled separately. Detection delay gives new players time to appear in the server's player list.

Attack Delay

Command ID: attack_delay.

Reduces the delay after a missed attack.

Set Max cooldown to 0 to remove it.

Auto Clicker

Command ID: auto_clicker.

Automates left/right clicks; hold the chosen button while Require pressed is on.

Auto Pot

Command ID: autopot.

Throws beneficial splash potions from your hotbar or offhand. Automatic uses health and effect thresholds; On toggle throws once and disables itself.

Keep the required potions available. Ground only is on by default; menus, item use, Freecam and Scaffold pause throwing.

Auto Shield

Command ID: auto_shield.

Automatically blocks nearby melee threats with a held shield.

Equip a shield in either hand and choose Smart, Swing, or Always.

Auto Totem

Command ID: auto_totem.

Equips totems in your offhand using inventory clicks or an instant swap.

Backtrack

Command ID: backtrack.

Delays target position updates.

Bow Aimbot

Command ID: bow_aimbot.

Aims a drawn bow using projectile and target prediction. Choose targets by Angle or Distance; Range and FOV limit selection. Draw and release the bow yourself.

Criticals

Command ID: criticals.

Attempts critical hits on eligible attacks.

Crystal Macro

Command ID: crystal_macro.

Automates crystal placement and attacks.

Aim manually and hold use with the required items available.

Fake Lag

Command ID: fakelag.

Delays outgoing packets near targets.

Dynamic mode uses the target Range; Constant mode runs timed bursts without a range filter.

Ghost Hand

Command ID: ghost_hand.

Targets players through walls within normal reach.

Enable Interact through walls to target usable blocks too.

Hit Crystal

Command ID: hitcrystal.

Combines melee hits with obsidian/crystal placement; keep crystals, optional obsidian, and a weapon in your hotbar.

Hit Select

Command ID: hit_select.

Times Kill Aura and Triggerbot attacks for natural critical hits. It does not change movement or sprinting; manual attacks remain immediate. It yields to Criticals while that module is enabled.

Kill Aura

Command ID: killaura.

Automatically targets and attacks entities.

Reach

Command ID: reach.

Extends attack reach; Exploit mode teleports toward targets for an attack.

S Tap

Command ID: s_tap.

Applies brief backward input after attacks, subject to Chance.

Safe Anchor

Command ID: safe_anchor.

Automates anchor placement and detonation with required glowstone cover.

Keep anchors and glowstone available, aim at a valid surface, and hold use; disable Anchor Macro first.

Confirm Cover waits for the protective block confirmation; Sneak Mode chooses the sneak method, and Same Tick Switch permits switching within the action tick.

Shield Breaker

Command ID: shield_breaker.

Switches to a hotbar axe to break shields.

Sound FX

Command ID: soundfx.

Plays the selected local hit sound.

Triggerbot

Command ID: triggerbot.

Attacks eligible crosshair targets.

Velocity

Command ID: velocity.

Adjusts received knockback using Normal, Grim or Vulcan.

In Vulcan, Vertical Strength changes subsequent gravity: 0% is 10×, 50% is 5.5×, and 100% is normal gravity. It does not scale the incoming vertical knockback. Disable an equivalent Motion Modifier rule to avoid applying it twice.

W Tap

Command ID: w_tap.

Resets sprint input after attacks.

Movement modules

Chorus Delay

Command ID: chorus_delay.

Defers chorus-fruit teleportation for up to Max Delay in milliseconds.

Click TP

Command ID: clicktp.

Right-click a target block to teleport onto it; the preview marks the selected destination.

Fast Stop

Command ID: fast_stop.

Scales horizontal velocity after movement input ends.

Fly

Command ID: flight.

Controls airborne movement.

Inventory Move

Command ID: inventory_move.

Allows movement while inventory screens are open.

Keep Sprint

Command ID: keep_sprint.

Maintains sprinting.

Motion Modifier

Command ID: motion_modifier.

Applies ordered movement, physics and packet rules to your player or controlled vehicle. Open Edit motion to build rules and inspect Diagnostics. Opening the editor does not enable the module.

See Motion Modifier rules for triggers, timing, conditions and packet controls.

No Clip

Command ID: noclip.

Lets you fly through blocks.

Use movement keys, jump to ascend, and sneak to descend.

No Slow

Command ID: no_slow.

Reduces item-use slowdown with Vanilla or Universal. Allow sprinting controls sprinting while using an item.

Parkour

Command ID: parkour.

Triggers jumping at the configured distance from a block edge.

Safe Walk

Command ID: safe_walk.

Stops or sneaks near ledges. Edge distance controls how close you approach; Minimum fall distance allows smaller drops.

Speed

Command ID: speed.

Increases movement speed using Vanilla or Strafe mode.

Spider

Command ID: spider.

Applies upward velocity during wall collision.

Strafe

Command ID: strafe.

Adjusts horizontal movement under selected ground and air conditions.

Target Strafe

Command ID: target_strafe.

Orbits or follows behind Kill Aura's target.

Utility modules

Anti AFK

Command ID: anti_afk.

Performs an action after you stop moving or looking around.

Anti Exploit

Command ID: anti_exploit.

Filters malformed items and excessive particles, entities or block data. Hide Fabric negotiation suppresses Fabric handshake data; Consistent brand keeps brand reporting consistent. Allow blocked servers permits connections to addresses on Minecraft's server blocklist and defaults Off.

Anti Hunger

Command ID: anti_hunger.

Reduces movement-related hunger loss using ground/sprint reporting.

Anti Void

Command ID: anti_void.

Attempts to recover your position after falling into the void.

Auto Armor

Command ID: auto_armor.

Equips available armor upgrades.

Auto Chest

Command ID: auto_chest.

Transfers iron, gold, diamonds and emeralds in chests. Use Deposit key and Withdraw key to assign the actions; defaults are = and -.

Auto Disconnect

Command ID: auto_disconnect.

Disconnects on low health or nearby unfamiliar players; reconnect manually after it triggers.

Auto Login

Command ID: auto_login.

Responds to server login prompts using your saved password. Only on server restricts it to the configured address; turn it off to allow other servers. Auto register also responds to registration prompts.

Passwords remain separate from shared configs. Reconnect after three failed attempts.

Auto Tool

Command ID: auto_tool.

Selects the best available hotbar tool for the block being mined.

Blink

Command ID: blink.

Holds network packets until released.

Disable to release queued packets, or configure Pulse for timed releases.

Chat QOL

Command ID: chat_qol.

Adds right-click chat copying and duplicate-message folding.

Chest Stealer

Command ID: chest_stealer.

Quick-moves items from chests into your inventory.

Enable Smart to filter useful items and upgrades.

Discord RPC

Command ID: discord_rpc.

Publishes game activity through Discord Rich Presence, with optional server-detail suppression.

Fast Use

Command ID: fast_use.

Removes the local placement cooldown while Placements is on. Enable EXP Bottles to remove the use delay for experience bottles.

Inventory Manager

Command ID: inventory_manager.

Sorts enabled item categories into configured hotbar slots. Each slot control selects its destination and item choice; disable categories you want to manage yourself.

IRC

Command ID: irc.

Shows Xiaoli player indicators.

Use .whisper and .reply for direct messages.

Middle Click

Command ID: middle_click.

Middle-click a player to toggle friendship, or use a pearl/rocket from your hotbar or offhand.

Smart uses a rocket while gliding and a pearl otherwise.

No Fall

Command ID: no_fall.

Changes fall reporting to attempt to prevent fall damage.

No Rotate

Command ID: no_rotate.

Preserves camera orientation after server rotation changes.

Proxy

Command ID: proxy.

Routes new connections through a proxy.

Configure it under Multiplayer → Proxy profiles.

Scripts

Command ID: scripts.

Runs your last-used JavaScript automation. Open .scripts to edit Code or Blocks; disable the module to stop it. See Scripts and block editor.

Self Freeze

Command ID: self_freeze.

Holds your position by delaying incoming or outgoing packets.

Disable to release queued actions.

Spoofer

Command ID: spoofer.

Overrides supported client-brand messages and corresponding Discord activity branding.

X Carry

Command ID: xcarry.

Keeps items in crafting slots after closing the inventory.

Visual modules

Ambience

Command ID: ambience.

Changes local time, sky and fog. Each sky style keeps its own controls; turn off Use client accent to choose its colors.

Fog changes the visible atmosphere without reducing chunk or entity render distance. Start distance is limited to 128 blocks.

Anti Resource Pack

Command ID: anti_resource_pack.

Blocks automatic server resource-pack application.

Attack Effects

Command ID: attack_effects.

Adds attack particles for selected targets.

Block ESP

Command ID: blockesp.

Highlights selected blocks in loaded chunks. Open Blocks to search and select several types; each entry can use the global ESP/tracer color or its own colors.

Filter Veins limits connected groups by Vein Size. Shape selects Outline, Fill or Filled Box. Color opacity changes the fill in Filled Box; the outline stays visible.

Cape

Command ID: cape.

Selects your active cape from those owned by your account. Type lists your available capes; N/A appears when none are available.

Chams

Command ID: chams.

Changes entity materials and optionally shows them through walls.

Choose Original, Color, or Textured; enable Gradient or Liquid Marble for effects.

China Hat

Command ID: china_hat.

Renders a conical hat.

Click GUI

Command ID: click_gui.

Opens the module and config menu. Press Right Shift, then type to search when no field or popup owns the input. Ctrl+F focuses search explicitly.

Scale changes ClickGUI size independently of Minecraft's GUI scale. Editor text scale controls custom menu text. The top-right gear opens client settings.

Death Effects

Command ID: death_effects.

Draws effects for selected entities you kill and for your own death when Local player is included.

Death Waypoints

Command ID: death_waypoints.

Saves death locations and draws markers; use List deaths or Clear this world in its settings.

ESP

Command ID: esp.

Draws entity boxes and health bars.

Freecam

Command ID: freecam.

Moves the camera independently while your player stays in place. Speed controls camera travel; Lock player head keeps the player's head from following the free camera.

Full Bright

Command ID: full_bright.

Overrides client lighting without modifying stored world light levels.

HUD

Command ID: hud.

Controls the HUD layout, client theme and shared surface opacity. Use the HUD editor for element-specific size, blur, outline and color options.

Theme defaults to Xiaoli. Custom exposes Primary color and Secondary color. Surface opacity defaults to 60%, with a 25–90% range.

Item ESP

Command ID: item_esp.

Highlights dropped items using their rendered model bounds. Choose the shared ESP box styles and enable Nametags to show item names and stack counts.

Item Physics

Command ID: item_physics.

Makes dropped items tumble, bounce, and settle.

Jump Circle

Command ID: jump_circle.

Shows a ripple when you land after a jump or fall.

Logoff Spots

Command ID: logoff_spots.

Marks players' last-seen positions after logout.

Name Tags

Command ID: nametags.

Renders selected entity information and status indicators.

No Render

Command ID: no_render.

Hides selected visual effects and overlays.

Projectile Prediction

Command ID: projectile_prediction.

Draws predicted paths and landing markers for selected projectile types, including a held-item preview when enabled. Path style and Landing style change the drawing without switching the other settings. Anti-aliasing is always enabled.

Rain Particles

Command ID: rain_particles.

Renders decorative falling particles independently of world weather.

Routes

Command ID: routes.

Records movement and replays saved routes; use Start recording, Stop and save, and Saved routes, or route commands.

Replay from Here shifts the full route to your position; Start walks to the recorded starting point.

Up to 25 routes can be saved; recording requires a grounded start and stops on invalid movement or world changes.

Shulker Preview

Command ID: shulker_preview.

Hover a shulker box to inspect its contents; turn on Hold Shift to show the preview only while Shift is held.

Hold Shift defaults Off.

Skin Changer

Command ID: skin_changer.

Shows a named player's skin on your local player. Enter a Minecraft username; clear Username to restore your own skin. Other players keep seeing your account's skin.

Streamer Mode

Command ID: streamer_mode.

Replaces supported local server and username displays.

Tracers

Command ID: tracers.

Draws colored lines to selected entity hitboxes.

Tunnel ESP

Command ID: tunnelesp.

Highlights enclosed tunnels, diagonal passages, stairs and shafts in loaded chunks. Width and Height set passage dimensions.

Enable each type above its settings group. Tunnels use Minimum length; diagonals and stairs use Minimum steps; shafts use Minimum depth. Disabled types hide their settings.

Scanning contains the Y range, cave-air filter, required wall thickness, scan budget and section limit. Appearance controls shape, line width, through-wall rendering and tracers.

View Model

Command ID: view_model.

Changes first-person animations, held-item position, rotation and scale. Choose Modern, Minimal or Recoil; Amount, Animation speed and Equip amount adjust the animation.

Hand effects offers Smoke, Sparks, Normal and Ghost. Ghost follows hand and item movement with fading textured silhouettes. Use Trail duration, Trail softness, Effect strength, Outline and optional Glow to adjust it.

Held items controls scale, offsets and rotations. Apply to both hands extends those transforms to the offhand.

Visual FX

Command ID: visualfx.

Controls blur, bloom, accent lighting and ClickGUI effects. Liquid Marble is under Fun; Footprints adds fading round marks while moving on the ground.

Liquid Marble

Adds an animated marble effect to entities or the screen. Enable it in Chams or Visual FX → Fun; disable Theme color to choose an Accent.

Xray

Command ID: xray.

Highlights selected ores through walls in loaded chunks. Open Ores to select types and assign individual colors; Filter Veins limits connected groups by size.

Only block data received from the server can be shown. Server-hidden ore data remains unavailable.

Zoom

Command ID: zoom.

Narrows your field of view for a closer look.

Use a Hold bind for temporary zoom.

World modules

Auto Farm

Command ID: auto_farm.

Harvests mature crops within reach and replants them.

Keep matching seeds or crops in your hotbar and stand within reach of the farm.

Base Finder

Command ID: base_finder.

Finds underground storage and activity clues in loaded terrain. Storage detections are visible bases; growth, excavation, redstone and entity evidence are leads to investigate.

Set Scan range, Base maximum Y and Minimum storage. Minimum confidence filters leads; Require recent activity requires activity evidence alongside storage.

Next lead changes the focused target. Mark found records a visited base; Raided / skip target retires it. Show found bases displays retired markers again. Clear session leads clears the current search leads.

Evidence HUD, the focused tracer, search areas, storage outlines and world labels can be controlled separately. Activity clues do not confirm a base or its contents; unseen server data cannot be searched.

Clutch

Command ID: clutch.

Predicts falls and places blocks within reach to catch you. Keep placeable blocks available. Walls only requires a side placement; turn it off to allow other valid supports. Silent aim controls placement rotation and return.

Fake Player

Command ID: fake_player.

Spawns an invulnerable local practice player using a Minecraft username's skin.

Skin username defaults to Steve; use .fakeplayer <name> to spawn one and .fakeplayer remove to remove it.

Fast Break

Command ID: fast_break.

Adjusts mining progress and cooldown.

Ghost Block

Command ID: ghostblock.

Places preview blocks visible only to you.

Hold a block and use it, or use .ghostblock; disable to clear previews.

Phase

Command ID: phase.

Lets you walk through walls while retaining the floor beneath you.

Scaffold

Command ID: scaffold.

Automatically places blocks beneath you. Mode and Technique each keep separate settings; first use starts from that combination's defaults, and returning restores your edits.

Choose Grim, Vulcan, Intave, Vanilla, Legit or Custom, then Normal, FastBridge, Expand, GodBridge, Breezy or Telly. Block supply selects hotbar or full-inventory refills; Block blacklist excludes unwanted blocks.

Keep Y controls placement height. SafeWalk controls edge handling; Tower handles upward building. Telly uses its own jump and placement sequence and hides controls that do not apply.

Placement prediction adjusts edge planning. Silent aim controls rotation, aim point and return; Static angle retains a bridging angle. Movement controls sprint, eagle, ledge recovery and technique-specific behavior. Packets controls swing visibility and extra placement attempts; Visuals controls the placement marker.

Defaults below are for Grim / Normal. Other combinations have their own defaults.

Timer

Command ID: timer.

Applies a client tick-speed multiplier independently of server TPS.

Troubleshooting

Config loading

Repeat the load command within 30 seconds to discard unsaved changes, or choose Save or Discard in the config manager. .confirm applies to resets. Invalid config data does not partially replace the active settings.

A script will not start

Start with // @xiaoli-js 2 and fix the editor's reported error. Old #!xiaoli 1 and chat presets must be rewritten as JavaScript. Check metadata and module IDs for addons or script modules.

A script action stops

Close menus, check reach and required items, and clear anything held on the inventory cursor. Use await for actions and yielding waits in loops. Decision/render callbacks must remain synchronous and short.

Auto Farm misses a crop

Keep seeds in the hotbar, release attack/use, close menus and disable Ghost Block.

Auto Login does not respond

Check Password and Only on server. When filtering is enabled, match the saved server address and port. Reconnect after three failed attempts.

Media shows no track

Start playback in an app with Windows media controls, then enable Media in the HUD editor. Media integration is Windows-only.

A macro is slower than its delay

Check aim, required items and server response time; Safe Anchor also needs valid cover.

Motion Modifier does not run a rule

Check the global gates, selected target, counter, stage and conditions. Vehicle-only targets require a controlled vehicle. Use tick 0 for a transition action, and turn off Only moving when it should run while stationary. Diagnostics shows activity and conflicts.

ESP or Xray shows nothing

Check the enabled target/block types, range, style and color alpha. Block scans require loaded chunks and block data supplied by the server. Anti-xray-hidden ores cannot be recovered from absent data.

License or session errors

Check your dashboard license and network connection. If the client says the build is unavailable, download a supported build. Restart Minecraft when the error asks for a restart, then sign in again.