Stipuleroo

English | 中文

Stipuleroo is a multi-purpose client-side mod for Minecraft Bedrock Edition. It can be used on any server. Some features may not work on servers that run anti-cheat plugins.

Features

Every feature has a command toggle, and every feature can also be bound to a hotkey in the config file config.json (all hotkeys are empty by default = unbound).

Default state on world entry:

Naming convention: hotkeys are always xxxKey, the "default state on world entry" is always xxxDefault. The config file is grouped by feature — hotkey, default switch and parameters of one feature all sit in the same block.

Free Camera (Out-of-Body) /fc

Toggle free camera mode by typing /fc or pressing your hotkey:

• Implemented on top of the Debug Camera
• While free-flying, your body stays frozen in place — it will not move or break blocks
• Automatically disabled on death or when leaving the world

Auto Tool /at

Toggle auto tool by typing /at or pressing your hotkey:

• Automatically switches to the fastest tool in your hotbar when mining blocks
• Automatically switches to the highest-damage weapon when attacking entities (accounts for the Sharpness enchantment)
• Automatically disabled when leaving the world; whether it is on by default in the next world is controlled by autoToolDefault

Auto Bridge /ab

Toggle auto bridge by typing /ab or pressing your hotkey:

• When enabled, automatically places blocks beneath and in front of you
• Automatically disabled when leaving the world

Night Vision + De-Fog /rv

Toggle night vision + de-fog by typing /rv or pressing your hotkey:

• Permanent night vision effect — no potions needed
• Also clears underwater fog, the water overlay and lava fog
• Automatically disabled when leaving the world; whether it is on by default in the next world is controlled by nightVisionDefault

Auto Mouse /am

/am opens a menu of the modes; each mode can also have its own hotkey. Turning one on turns the previous one off, and picking the current one again turns it off.

If the menu cannot be shown on a remote server, the numeric commands below are listed in chat instead; they do exactly the same thing:

Switching always prints exactly one chat line:

• Repeating left click (attack)
• Repeating right click
• Holding left click (mining)
• Click intervals are configurable in the config file (0.05–1000 seconds)
• Pauses automatically while any UI (inventory / chat / form) is open, and releases the mouse button immediately
• Automatically disabled when leaving the world or on death
• The click interval and the right-button hold time are configurable

Auto Elytra Swap /ae

Type /ae or press your hotkey (autoElytraKey) to toggle:

• Pressing jump in mid-air → automatically equips an elytra from your inventory and then tries to start gliding
• Your original chestplate is restored once you land
• While gliding, if the current elytra is nearly broken (remaining durability ≤ autoElytraDurability) and a better one is in your inventory → it swaps mid-glide and resumes gliding
• Automatically disabled when leaving the world; whether it is on by default in the next world is controlled by autoElytraDefault

Auto Restock /ar

Type /ar or press your hotkey (autoRestockKey) to toggle:

• When the item in your hand is used up, an identical item is automatically moved into your hand
• Automatically disabled when leaving the world; whether it is on by default in the next world is controlled by autoRestockDefault

Mining Cooldown Remover /fm

Type /fm or press your hotkey (fastMineKey) to toggle:

• Instant-break blocks become one block per game tick (20 blocks/second, 72K/hour) instead of being held back by the vanilla "one block per 2 gt"
• Blocks that are not instantly breakable: the extra mining cooldown after each break is removed
• This feature currently cannot be used on remote servers
• Automatically disabled when leaving the world; whether it is on by default in the next world is controlled by fastMineDefault

Configuration

On first load the mod generates mods/Stipuleroo/config/config.json. The file is grouped by feature (one block per feature: hotkey, default switch and parameters together):

// Stipuleroo 配置（支持 // 注释；改完约 2 秒自动生效，无聊天栏提示，不用重启游戏）
// 键名：A~Z 0~9 F1~F12 Space Tab Enter Shift Ctrl Alt（可加 L/R 前缀）；留空 "" = 不绑定
// 命名：Key = 快捷键（改完约 2 秒即生效）；Default = 每次进入世界时的默认开关（局内用命令/快捷键切换）
// 没有 Default 的功能（/fc 灵魂出窍、/ab 自动搭路、/am 自动鼠标操作）每次进世界一律关闭
{
    // ==================== 通用 ====================
    "debugLog": false,                          // 输出诊断日志到 logs/latest.log（反馈问题时打开）

    // ==================== 灵魂出窍 /fc —— 每次进世界一律关闭 ====================
    "freecamKey": "",                           // 快捷键

    // ==================== 自动搭路 /ab —— 每次进世界一律关闭 ====================
    "autoBridgeKey": "",                        // 快捷键

    // ==================== 自动鼠标操作 /am —— 每次进世界一律关闭（三种模式互斥） ====================
    "autoMouseLeftClickKey": "",                // 快捷键：连续左键点击（攻击）
    "autoMouseRightClickKey": "",               // 快捷键：连续右键点击（放置/使用）
    "autoMouseHoldLeftKey": "",                 // 快捷键：持续左键长按（挖掘）
    "autoMouseLeftClickInterval": 0.20,         // 左键点击间隔（秒，0.05~1000）
    "autoMouseRightClickInterval": 0.20,        // 右键点击间隔（秒，0.05~1000）
    "autoMouseRightClickHold": 0.10,            // 右键按住时长（秒，0.01~60；自动夹到 ≤ 间隔-0.01s；弓/食物等请自行调大两者）

    // ==================== 自动工具 /at ====================
    "autoToolKey": "",                          // 快捷键
    "autoToolDefault": false,                   // 进入世界时的默认开关

    // ==================== 伪潜行 /fs（无效果） ====================
    "fakeSneakKey": "",                         // 快捷键
    "fakeSneakDefault": false,                  // 进入世界时的默认开关

    // ==================== 夜视去雾 /rv ====================
    "nightVisionKey": "",                       // 快捷键
    "nightVisionDefault": false,                // 进入世界时的默认开关

    // ==================== 鞘翅自动切换 /ae ====================
    "autoElytraKey": "",                        // 快捷键
    "autoElytraDefault": false,                 // 进入世界时的默认开关
    "autoElytraDurability": 10,                 // 剩余耐久 ≤ 此值就换新（0~1000；0 = 胸甲不是鞘翅就换）

    // ==================== 自动补货 /ar ====================
    "autoRestockKey": "",                       // 快捷键
    "autoRestockDefault": false,                 // 进入世界时的默认开关
    "autoRestockSettleMs": 120,                 // 用掉物品后等多少毫秒再补货（0~2000；0=立刻补；一般不用改）

    // ==================== 移除挖掘冷却 /fm ====================
    "fastMineKey": "",                          // 快捷键
    "fastMineDefault": false                    // 进入世界时的默认开关
}

Supported key names: A–Z, 0–9, F1–F12, Space, Tab, Enter, Shift, Ctrl, Alt and their left/right variants (LShift/RShift, LCtrl/RCtrl, LAlt/RAlt).

The config file supports // comments and is hot-reloaded in game: save it (in a world or not) and the changes apply in about 2 seconds — no re-entering the world, no game restart. A broken file is ignored (the previous config stays active).

Notes:

• xxxDefault only decides the initial state of the next world entry: changing it in game does not change the state you are in (use the command/hotkey for that), but the new value is live about 2 seconds later, so leaving and re-entering a world applies it — no game restart needed.
• Hotkeys (xxxKey) apply just as fast (no game restart needed): the key of every key press is matched against the current config.
• If config.json is missing required fields, a warning is written to the log — delete the old file and let the mod regenerate it.

Installation

1. Install the LeviLauncher launcher
2. Install a LeviLamina client matching your game version through LeviLauncher
3. Download the release zip whose game version matches yours from the Releases page and import it into LeviLauncher
4. Launch the game and type the commands in chat to enable features
5. On first launch, a config file is generated at mods/Stipuleroo/config/config.json — configure your hotkeys there

Building from source

Requirements: xmake, and a clang-cl (LLVM) matching the target client — from game version 26.20 on, the client and LeviLamina are built with clang/LLVM, so the mod must be compiled with clang-cl too. Building with MSVC produces a different entt component type hash and silently breaks every ECS-based feature.

.\build.ps1                            # release build (puts LLVM's bin on PATH, then configures + builds)
.\build.ps1 -Mode debug -Clean         # debug build from scratch
.\deploy.ps1 -Version 1.26.51.01       # copy the build output into a LeviLauncher version

The LeviLamina version the mod is currently built against lives in xmake.lua and tooth.json (change both when moving to a new game version). Output: bin/Stipuleroo/{manifest.json, Stipuleroo.dll}.

License

GPL-3.0 © FeixiangTMC