{"url":"https://levimc.org/mods/github.com/FeixiangTMC/Stipuleroo/","id":"github.com/FeixiangTMC/Stipuleroo","name":"Stipuleroo","description":"Minecraft 基岩版客户端多功能辅助模组","owner":"FeixiangTMC","logo":"https://levimc.org/mods/icons/413c5768c320818a-288.webp","repository":"https://github.com/FeixiangTMC/Stipuleroo","issues":"https://github.com/FeixiangTMC/Stipuleroo/issues","releases":"https://github.com/FeixiangTMC/Stipuleroo/releases","stars":6,"downloads":387,"updated":"2026-09-26T02:18:07Z","published":"2026-07-01T11:03:33Z","created":"2026-07-01T11:02:59Z","license":"GPL-3.0","side":["client"],"platform":["win-x64"],"gameVersions":["1.26.51","1.26.40","1.26.10","1.21.124"],"tags":["platform:levilamina","type:mod","type:client"],"latest":{"variant":"client","version":"0.0.6","install":"lip install github.com/FeixiangTMC/Stipuleroo#client@0.0.6"},"readmes":[{"file":"README.md","lang":"en","text":"# Stipuleroo\n\nEnglish | [中文](README.zh.md)\n\n**Stipuleroo** is a multi-purpose **client-side** mod for Minecraft Bedrock Edition. It can be used on any server.\nSome features may not work on servers that run anti-cheat plugins.\n\n## Features\n\nEvery 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).\n\n**Default state on world entry**:\n\n| Feature | Default on world entry |\n|---|---|\n| `/fc` Free Camera, `/ab` Auto Bridge, `/am` Auto Mouse | **always off** |\n| `/at` Auto Tool, `/fs` Fake Sneak, `/rv` Night Vision, `/ae` Auto Elytra Swap, `/ar` Auto Restock, `/fm` Mining Cooldown Remover | decided by that feature's `xxxDefault` setting |\n\nNaming 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.\n\n### Free Camera (Out-of-Body) `/fc`\n\nToggle free camera mode by typing `/fc` or pressing your hotkey:\n\n| Message | Meaning |\n|---|---|\n| `灵魂出窍模式已启用。` | Enabled — free flight |\n| `灵魂出窍模式已禁用。` | Disabled — back in your body |\n\n- Implemented on top of the Debug Camera\n- While free-flying, your body stays frozen in place — it will not move or break blocks\n- Automatically disabled on death or when leaving the world\n\n### Auto Tool `/at`\n\nToggle auto tool by typing `/at` or pressing your hotkey:\n\n| Message | Meaning |\n|---|---|\n| `自动工具切换已启用。` | Enabled |\n| `自动工具切换已禁用。` | Disabled |\n\n- Automatically switches to the fastest tool in your hotbar when mining blocks\n- Automatically switches to the highest-damage weapon when attacking entities (accounts for the Sharpness enchantment)\n- Automatically disabled when leaving the world; whether it is on by default in the next world is controlled by `autoToolDefault`\n\n### Auto Bridge `/ab`\n\nToggle auto bridge by typing `/ab` or pressing your hotkey:\n\n| Message | Meaning |\n|---|---|\n| `自动搭路已启用。` | Enabled |\n| `自动搭路已禁用。` | Disabled |\n\n- When enabled, automatically places blocks beneath and in front of you\n- Automatically disabled when leaving the world\n\n### Night Vision + De-Fog `/rv`\n\nToggle night vision + de-fog by typing `/rv` or pressing your hotkey:\n\n| Message | Meaning |\n|---|---|\n| `夜视去雾已启用。` | Enabled |\n| `夜视去雾已禁用。` | Disabled |\n\n- Permanent night vision effect — no potions needed\n- Also clears underwater fog, the water overlay and lava fog\n- Automatically disabled when leaving the world; whether it is on by default in the next world is controlled by `nightVisionDefault`\n\n### Auto Mouse `/am`\n\n`/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.\n\nIf the menu cannot be shown on a remote server, the numeric commands below are listed in chat instead; they do exactly the same thing:\n\n| Command | Meaning |\n|---|---|\n| `/am` | Open the menu (falls back to listing the numeric commands) |\n| `/am 1` | Repeating left click (attack) |\n| `/am 2` | Repeating right click (place / use) |\n| `/am 3` | Holding left click (mining) |\n| `/am 0` | Off |\n\nSwitching always prints exactly one chat line:\n\n| Message | Meaning |\n|---|---|\n| `自动鼠标操作: 连续左键点击（攻击）` | Attacks whatever is under the crosshair at the configured interval |\n| `自动鼠标操作: 连续右键点击（放置/使用）` | Places blocks / uses the held item at the configured interval |\n| `自动鼠标操作: 持续左键长按（挖掘）` | Keeps mining whatever is under the crosshair |\n| `自动鼠标操作: 已关闭` | Off |\n\n- **Repeating left click (attack)**\n- **Repeating right click**\n- **Holding left click (mining)**\n- Click intervals are configurable in the config file (`0.05`–`1000` seconds)\n- Pauses automatically while any UI (inventory / chat / form) is open, and releases the mouse button immediately\n- Automatically disabled when leaving the world or on death\n- The click interval and the right-button hold time are configurable\n\n### Auto Elytra Swap `/ae`\n\nType `/ae` or press your hotkey (`autoElytraKey`) to toggle:\n\n| Message | Meaning |\n|---|---|\n| `鞘翅自动切换已启用。` | Enabled |\n| `鞘翅自动切换已禁用。` | Disabled |\n\n- Pressing jump in mid-air → automatically equips an elytra from your inventory and then tries to start gliding\n- Your original chestplate is restored once you land\n- 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\n- Automatically disabled when leaving the world; whether it is on by default in the next world is controlled by `autoElytraDefault`\n\n### Auto Restock `/ar`\n\nType `/ar` or press your hotkey (`autoRestockKey`) to toggle:\n\n| Message | Meaning |\n|---|---|\n| `自动补货已启用。` | Enabled |\n| `自动补货已禁用。` | Disabled |\n\n- **When the item in your hand is used up, an identical item is automatically moved into your hand**\n- Automatically disabled when leaving the world; whether it is on by default in the next world is controlled by `autoRestockDefault`\n\n### Mining Cooldown Remover `/fm`\n\nType `/fm` or press your hotkey (`fastMineKey`) to toggle:\n\n| Message | Meaning |\n|---|---|\n| `移除挖掘冷却已启用。` | Enabled |\n| `移除挖掘冷却已禁用。` | Disabled |\n\n- 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\"\n- Blocks that are not instantly breakable: the extra mining cooldown after each break is removed\n- This feature currently cannot be used on remote servers\n- Automatically disabled when leaving the world; whether it is on by default in the next world is controlled by `fastMineDefault`\n\n## Configuration\n\nOn first load the mod generates `mods/Stipuleroo/config/config.json`.\nThe file is **grouped by feature** (one block per feature: hotkey, default switch and parameters together):\n\n```jsonc\n// Stipuleroo 配置（支持 // 注释；改完约 2 秒自动生效，无聊天栏提示，不用重启游戏）\n// 键名：A~Z 0~9 F1~F12 Space Tab Enter Shift Ctrl Alt（可加 L/R 前缀）；留空 \"\" = 不绑定\n// 命名：Key = 快捷键（改完约 2 秒即生效）；Default = 每次进入世界时的默认开关（局内用命令/快捷键切换）\n// 没有 Default 的功能（/fc 灵魂出窍、/ab 自动搭路、/am 自动鼠标操作）每次进世界一律关闭\n{\n    // ==================== 通用 ====================\n    \"debugLog\": false,                          // 输出诊断日志到 logs/latest.log（反馈问题时打开）\n\n    // ==================== 灵魂出窍 /fc —— 每次进世界一律关闭 ====================\n    \"freecamKey\": \"\",                           // 快捷键\n\n    // ==================== 自动搭路 /ab —— 每次进世界一律关闭 ====================\n    \"autoBridgeKey\": \"\",                        // 快捷键\n\n    // ==================== 自动鼠标操作 /am —— 每次进世界一律关闭（三种模式互斥） ====================\n    \"autoMouseLeftClickKey\": \"\",                // 快捷键：连续左键点击（攻击）\n    \"autoMouseRightClickKey\": \"\",               // 快捷键：连续右键点击（放置/使用）\n    \"autoMouseHoldLeftKey\": \"\",                 // 快捷键：持续左键长按（挖掘）\n    \"autoMouseLeftClickInterval\": 0.20,         // 左键点击间隔（秒，0.05~1000）\n    \"autoMouseRightClickInterval\": 0.20,        // 右键点击间隔（秒，0.05~1000）\n    \"autoMouseRightClickHold\": 0.10,            // 右键按住时长（秒，0.01~60；自动夹到 ≤ 间隔-0.01s；弓/食物等请自行调大两者）\n\n    // ==================== 自动工具 /at ====================\n    \"autoToolKey\": \"\",                          // 快捷键\n    \"autoToolDefault\": false,                   // 进入世界时的默认开关\n\n    // ==================== 伪潜行 /fs（无效果） ====================\n    \"fakeSneakKey\": \"\",                         // 快捷键\n    \"fakeSneakDefault\": false,                  // 进入世界时的默认开关\n\n    // ==================== 夜视去雾 /rv ====================\n    \"nightVisionKey\": \"\",                       // 快捷键\n    \"nightVisionDefault\": false,                // 进入世界时的默认开关\n\n    // ==================== 鞘翅自动切换 /ae ====================\n    \"autoElytraKey\": \"\",                        // 快捷键\n    \"autoElytraDefault\": false,                 // 进入世界时的默认开关\n    \"autoElytraDurability\": 10,                 // 剩余耐久 ≤ 此值就换新（0~1000；0 = 胸甲不是鞘翅就换）\n\n    // ==================== 自动补货 /ar ====================\n    \"autoRestockKey\": \"\",                       // 快捷键\n    \"autoRestockDefault\": false,                 // 进入世界时的默认开关\n    \"autoRestockSettleMs\": 120,                 // 用掉物品后等多少毫秒再补货（0~2000；0=立刻补；一般不用改）\n\n    // ==================== 移除挖掘冷却 /fm ====================\n    \"fastMineKey\": \"\",                          // 快捷键\n    \"fastMineDefault\": false                    // 进入世界时的默认开关\n}\n```\n\n| Setting | Feature | Default |\n|---|---|---|\n| `debugLog` | Write diagnostic logs to `logs/latest.log` (turn it on when reporting an issue) | `false` in release builds |\n| `freecamKey` | Free Camera `/fc` (always off on world entry) | empty (no hotkey) |\n| `autoBridgeKey` | Auto Bridge `/ab` (always off on world entry) | empty |\n| `autoMouseLeftClickKey` | Auto Mouse `/am`: repeating left click (always off on world entry) | empty |\n| `autoMouseRightClickKey` | Auto Mouse `/am`: repeating right click | empty |\n| `autoMouseHoldLeftKey` | Auto Mouse `/am`: holding left click (mining) | empty |\n| `autoMouseLeftClickInterval` | Interval of repeating left click, in seconds (`0.05`–`1000`) | `0.20` |\n| `autoMouseRightClickInterval` | Interval of repeating right click, in seconds (`0.05`–`1000`) | `0.20` |\n| `autoMouseRightClickHold` | How long the right button is held, in seconds (`0.01`–`60`); clamped to ≤ interval−0.01 s — raise the interval too for bows/food that need a longer hold | `0.10` |\n| `autoToolKey` / `autoToolDefault` | Auto Tool `/at`: hotkey / default switch | empty / `false` |\n| `fakeSneakKey` / `fakeSneakDefault` | Fake Sneak `/fs` — **no effect** | empty / `false` |\n| `nightVisionKey` / `nightVisionDefault` | Night Vision + De-Fog `/rv`: hotkey / default switch | empty / `false` |\n| `autoElytraKey` / `autoElytraDefault` | Auto Elytra Swap `/ae`: hotkey / **default switch** (applied on every world entry; use `/ae` or the hotkey in game) | empty / `false` |\n| `autoElytraDurability` | Swap to a new elytra when the remaining durability is ≤ this value (`0`–`1000`); `0` = swap whenever the chest slot is not an elytra | `10` |\n| `autoRestockKey` / `autoRestockDefault` | Auto Restock `/ar`: hotkey / **default switch** (applied on every world entry; use `/ar` or the hotkey in game) | empty / `false` |\n| `autoRestockSettleMs` | How many milliseconds to wait after an item is used up before restocking (`0`–`2000`); higher is safer, lower is snappier, `0` = restock immediately | `120` |\n| `fastMineKey` / `fastMineDefault` | Mining Cooldown Remover `/fm`: hotkey / **default switch** (applied on every world entry; use `/fm` or the hotkey in game) | empty / `false` |\n\nSupported 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`).\n\nThe 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).\n\nNotes:\n\n- `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**.\n- Hotkeys (`xxxKey`) apply just as fast (**no game restart needed**): the key of every key press is matched against the current config.\n- If `config.json` is missing required fields, a warning is written to the log — **delete the old file and let the mod regenerate it**.\n\n## Installation\n\n1. Install the [LeviLauncher](https://github.com/LiteLDev/LeviLauncher) launcher\n2. Install a **LeviLamina client** matching your game version through LeviLauncher\n3. Download the release zip whose **game version matches yours** from the [Releases page](https://github.com/FeixiangTMC/Stipuleroo/releases) and import it into LeviLauncher\n4. Launch the game and type the commands in chat to enable features\n5. On first launch, a config file is generated at `mods/Stipuleroo/config/config.json` — configure your hotkeys there\n\n## Building from source\n\nRequirements: [xmake](https://xmake.io), 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.\n\n```powershell\n.\\build.ps1                            # release build (puts LLVM's bin on PATH, then configures + builds)\n.\\build.ps1 -Mode debug -Clean         # debug build from scratch\n.\\deploy.ps1 -Version 1.26.51.01       # copy the build output into a LeviLauncher version\n```\n\nThe 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}`.\n\n## License\n\nGPL-3.0 © FeixiangTMC\n"},{"file":"README.zh.md","lang":"zh-Hans","text":"# Stipuleroo\n\n[English](README.md) | 中文\n\n托叶工具，Minecraft 基岩版客户端多功能模组。**纯客户端模组**：可进入服务器使用。\n部分功能可能无法在拥有反作弊插件的服务器里运行。\n\n## 功能\n\n所有功能都有**命令**开关，也都可以在配置文件 `config.json` 里绑定快捷键（默认全部为空 = 不绑定）。\n\n**进入游戏时的默认状态**：\n\n| 功能 | 进世界默认 |\n|---|---|\n| `/fc` 灵魂出窍、`/ab` 自动搭路、`/am` 自动鼠标操作 | **一律关闭**|\n| `/at` 自动工具、`/fs` 伪潜行、`/rv` 夜视去雾、`/ae` 鞘翅自动切换、`/ar` 自动补货、`/fm` 移除挖掘冷却 | 由配置里的 `xxxDefault` 决定 |\n\n配置项命名约定：快捷键一律叫 `xxxKey`，进世界默认开关一律叫 `xxxDefault`；配置文件里**按功能分块**，每个功能的快捷键、默认开关、参数都在同一节里。\n\n### 灵魂出窍 `/fc`\n\n输入 `/fc` 或按快捷键切换灵魂出窍模式：\n\n| 提示 | 含义 |\n|---|---|\n| `灵魂出窍模式已启用。` | 已开启，自由飞行 |\n| `灵魂出窍模式已禁用。` | 已关闭，回到身体 |\n\n- 基于 Debug Camera 实现\n- 自由飞行时玩家本体冻结在原地，不会移动/破坏方块\n- 死亡、退出世界时自动关闭\n\n### 自动工具 `/at`\n\n输入 `/at` 或按快捷键切换自动工具模式：\n\n| 提示 | 含义 |\n|---|---|\n| `自动工具切换已启用。` | 已开启 |\n| `自动工具切换已禁用。` | 已关闭 |\n\n- 挖掘方块时自动切换到快捷栏中挖掘速度最快的工具\n- 攻击实体时自动切换到伤害最高的武器（计算锋利附魔加成）\n- 退出世界时自动关闭；下次进入世界是否默认开启，由配置文件的 `autoToolDefault` 决定\n\n### 自动搭路 `/ab`\n\n输入 `/ab` 或按快捷键切换自动搭路：\n\n| 提示 | 含义 |\n|---|---|\n| `自动搭路已启用。` | 已开启 |\n| `自动搭路已禁用。` | 已关闭 |\n\n- 开启后自动在脚下和前方放置方块\n- 退出世界时自动关闭\n\n### 夜视去雾 `/rv`\n\n输入 `/rv` 或按快捷键切换夜视去雾：\n\n| 提示 | 含义 |\n|---|---|\n| `夜视去雾已启用。` | 已开启 |\n| `夜视去雾已禁用。` | 已关闭 |\n\n- 永久夜视效果，无需药水\n- 水下雾、水幕、岩浆雾等视野遮挡一并清除\n- 退出世界时自动关闭；下次进入世界是否默认开启，由配置文件的 `nightVisionDefault` 决定\n\n### 自动鼠标操作 `/am`\n\n`/am` 会弹出模式菜单；三种模式各自也可以绑定快捷键。开启一个会自动关掉上一个，再选一次当前项即关闭。\n\n在远程服务器菜单弹不出来时，会在聊天栏列出下面的数字命令，效果完全一样：\n\n| 命令 | 含义 |\n|---|---|\n| `/am` | 弹出菜单（能弹则弹，不能弹则列出数字命令） |\n| `/am 1` | 连续左键点击（攻击） |\n| `/am 2` | 连续右键点击（放置/使用） |\n| `/am 3` | 持续左键长按（挖掘） |\n| `/am 0` | 关闭 |\n\n切换后聊天栏只提示一行：\n\n| 提示 | 含义 |\n|---|---|\n| `自动鼠标操作: 连续左键点击（攻击）` | 按间隔攻击准星目标 |\n| `自动鼠标操作: 连续右键点击（放置/使用）` | 按间隔放置方块 / 使用物品 |\n| `自动鼠标操作: 持续左键长按（挖掘）` | 持续挖掘准星方块 |\n| `自动鼠标操作: 已关闭` | 已关闭 |\n\n- **连续左键点击（攻击）**\n- **连续右键点击**\n- **持续左键长按（挖掘）**\n- 点击间隔可在配置文件中调整（0.05 ~ 1000 秒）\n- 打开任何界面（背包 / 聊天 / 表单）时自动暂停，并立刻松开鼠标按键\n- 退出世界、死亡时自动关闭\n- 可在配置文件中设置点击间隔和右键按下时长\n\n### 鞘翅自动切换 `/ae`\n\n输入 `/ae` 或按快捷键（`autoElytraKey`）切换：\n\n| 提示 | 含义 |\n|---|---|\n| `鞘翅自动切换已启用。` | 已开启 |\n| `鞘翅自动切换已禁用。` | 已关闭 |\n\n- 空中按跳跃→ 自动换上背包里的鞘翅，并接着自动尝试起飞滑翔\n- 落地后自动换回原来的胸甲\n- 滑翔中当前鞘翅快坏了（剩余耐久 ≤ `autoElytraDurability`）且背包里有更好的鞘翅 → 中途自动换新并恢复滑翔\n- 退出世界时自动关闭；下次进入世界是否默认开启，由配置文件的 `autoElytraDefault` 决定\n\n### 自动补货 `/ar`\n\n输入 `/ar` 或按快捷键（`autoRestockKey`）切换：\n\n| 提示 | 含义 |\n|---|---|\n| `自动补货已启用。` | 已开启 |\n| `自动补货已禁用。` | 已关闭 |\n\n- **手上的物品被耗尽后，自动把同款物品补货到手上**\n- 退出世界时自动关闭；下次进入世界是否默认开启，由配置文件的 `autoRestockDefault` 决定\n\n### 移除挖掘冷却 `/fm`\n\n输入 `/fm` 或按快捷键（`fastMineKey`）切换：\n\n| 提示 | 含义 |\n|---|---|\n| `移除挖掘冷却已启用。` | 已开启 |\n| `移除挖掘冷却已禁用。` | 已关闭 |\n\n- 秒破方块改为**每游戏刻 1 块**（20 块/秒，72K/小时），不再被原版的\"每 2gt 1 块\"拖住\n- 非秒破方块：去掉每破坏一块后额外的挖掘冷却\n- 此功能目前不能进入远程服务器使用\n- 退出世界时自动关闭；下次进入世界是否默认开启，由配置文件的 `fastMineDefault` 决定\n\n## 配置\n\n模组首次加载后会在 `mods/Stipuleroo/config/config.json` 生成配置文件。\n文件**按功能分块**（每个功能一节，快捷键 / 默认开关 / 参数都在一起）：\n\n```jsonc\n// Stipuleroo 配置（支持 // 注释；改完约 2 秒自动生效，无聊天栏提示，不用重启游戏）\n// 键名：A~Z 0~9 F1~F12 Space Tab Enter Shift Ctrl Alt（可加 L/R 前缀）；留空 \"\" = 不绑定\n// 命名：Key = 快捷键（改完约 2 秒即生效）；Default = 每次进入世界时的默认开关（局内用命令/快捷键切换）\n// 没有 Default 的功能（/fc 灵魂出窍、/ab 自动搭路、/am 自动鼠标操作）每次进世界一律关闭\n{\n    // ==================== 通用 ====================\n    \"debugLog\": false,                          // 输出诊断日志到 logs/latest.log（反馈问题时打开）\n\n    // ==================== 灵魂出窍 /fc —— 每次进世界一律关闭 ====================\n    \"freecamKey\": \"\",                           // 快捷键\n\n    // ==================== 自动搭路 /ab —— 每次进世界一律关闭 ====================\n    \"autoBridgeKey\": \"\",                        // 快捷键\n\n    // ==================== 自动鼠标操作 /am —— 每次进世界一律关闭（三种模式互斥） ====================\n    \"autoMouseLeftClickKey\": \"\",                // 快捷键：连续左键点击（攻击）\n    \"autoMouseRightClickKey\": \"\",               // 快捷键：连续右键点击（放置/使用）\n    \"autoMouseHoldLeftKey\": \"\",                 // 快捷键：持续左键长按（挖掘）\n    \"autoMouseLeftClickInterval\": 0.20,         // 左键点击间隔（秒，0.05~1000）\n    \"autoMouseRightClickInterval\": 0.20,        // 右键点击间隔（秒，0.05~1000）\n    \"autoMouseRightClickHold\": 0.10,            // 右键按住时长（秒，0.01~60；自动夹到 ≤ 间隔-0.01s；弓/食物等请自行调大两者）\n\n    // ==================== 自动工具 /at ====================\n    \"autoToolKey\": \"\",                          // 快捷键\n    \"autoToolDefault\": false,                   // 进入世界时的默认开关\n\n    // ==================== 伪潜行 /fs（无效果） ====================\n    \"fakeSneakKey\": \"\",                         // 快捷键\n    \"fakeSneakDefault\": false,                  // 进入世界时的默认开关\n\n    // ==================== 夜视去雾 /rv ====================\n    \"nightVisionKey\": \"\",                       // 快捷键\n    \"nightVisionDefault\": false,                // 进入世界时的默认开关\n\n    // ==================== 鞘翅自动切换 /ae ====================\n    \"autoElytraKey\": \"\",                        // 快捷键\n    \"autoElytraDefault\": false,                 // 进入世界时的默认开关\n    \"autoElytraDurability\": 10,                 // 剩余耐久 ≤ 此值就换新（0~1000；0 = 胸甲不是鞘翅就换）\n\n    // ==================== 自动补货 /ar ====================\n    \"autoRestockKey\": \"\",                       // 快捷键\n    \"autoRestockDefault\": false,                 // 进入世界时的默认开关\n    \"autoRestockSettleMs\": 120,                 // 用掉物品后等多少毫秒再补货（0~2000；0=立刻补；一般不用改）\n\n    // ==================== 移除挖掘冷却 /fm ====================\n    \"fastMineKey\": \"\",                          // 快捷键\n    \"fastMineDefault\": false                    // 进入世界时的默认开关\n}\n```\n\n| 配置项 | 对应功能 | 默认值 |\n|---|---|---|\n| `debugLog` | 是否把诊断日志写进 `logs/latest.log`（反馈问题时打开） | 正式版 `false` |\n| `freecamKey` | 灵魂出窍 `/fc`（进世界恒关） | 空（无快捷键） |\n| `autoBridgeKey` | 自动搭路 `/ab`（进世界恒关） | 空 |\n| `autoMouseLeftClickKey` | 自动鼠标 `/am`：连续左键点击（进世界恒关） | 空 |\n| `autoMouseRightClickKey` | 自动鼠标 `/am`：连续右键点击 | 空 |\n| `autoMouseHoldLeftKey` | 自动鼠标 `/am`：持续左键长按（挖掘） | 空 |\n| `autoMouseLeftClickInterval` | 左键点击间隔（秒，0.05 ~ 1000） | `0.20` |\n| `autoMouseRightClickInterval` | 右键点击间隔（秒，0.05 ~ 1000） | `0.20` |\n| `autoMouseRightClickHold` | 右键\"按住\"时长（秒，0.01 ~ 60）；会被自动夹到 ≤ 间隔-0.01 秒，弓/食物等需要按住更久的物品请把间隔一起调大 | `0.10` |\n| `autoToolKey` / `autoToolDefault` | 自动工具 `/at` 的快捷键 / 默认开关 | 空 / `false` |\n| `fakeSneakKey` / `fakeSneakDefault` | 伪潜行 `/fs` —— **无实际效果** | 空 / `false` |\n| `nightVisionKey` / `nightVisionDefault` | 夜视去雾 `/rv` 的快捷键 / 默认开关 | 空 / `false` |\n| `autoElytraKey` / `autoElytraDefault` | 鞘翅智能自动切换 `/ae` 的快捷键 / **默认开关**（每次进入世界时按此值生效，局内用 `/ae` 或快捷键临时切换） | 空 / `false` |\n| `autoElytraDurability` | 鞘翅剩余耐久 ≤ 此值就换新（0 ~ 1000）；设 `0` = 胸甲不是鞘翅就换 | `10` |\n| `autoRestockKey` / `autoRestockDefault` | 自动补货 `/ar` 的快捷键 / **默认开关**（每次进入世界时按此值生效，局内用 `/ar` 或快捷键临时切换） | 空 / `false` |\n| `autoRestockSettleMs` | 用掉物品后等多少毫秒再补货（`0` ~ `2000`）；调大更保险、调小更跟手，`0` = 立刻补 | `120` |\n| `fastMineKey` / `fastMineDefault` | 移除挖掘冷却 `/fm` 的快捷键 / **默认开关**（每次进入世界时按此值生效，局内用 `/fm` 或快捷键临时切换） | 空 / `false` |\n\n支持的键名：`A`~`Z`、`0`~`9`、`F1`~`F12`、`Space`、`Tab`、`Enter`、`Shift`、`Ctrl`、`Alt` 及左右变体（`LShift`/`RShift`、`LCtrl`/`RCtrl`、`LAlt`/`RAlt`）。\n\n配置文件支持 `//` 注释，并且**支持局内热重载**：在游戏里（进没进世界都行）改完保存，约 2 秒后自动生效，**不用重进世界，也不用重启游戏**。文件写坏时忽略本次修改（保留原配置）。\n\n注意：\n\n- `xxxDefault` 只决定**每次进入世界**的初始状态：局内改它不会当场改变当前世界里的开关（要改当前状态用命令/快捷键），但改完约 2 秒就生效了，**退出重进世界（不用重启游戏）即按新值生效**。\n- 快捷键（`xxxKey`）同样约 2 秒生效，**不需要重启游戏**：热键是每次按键现读配置判定。\n- 配置文件 `config.json` 里的缺少需要的字段会有日志警告，**删掉旧文件让模组重新生成**即可。\n\n## 安装\n\n1. 安装 [LeviLauncher](https://github.com/LiteLDev/LeviLauncher) 启动器\n2. 在 LeviLauncher 中安装与你的游戏版本匹配的 **LeviLamina 客户端**\n3. 从 [Releases 页面](https://github.com/FeixiangTMC/Stipuleroo/releases) 下载**游戏版本与你一致**的 zip，并导入 LeviLauncher\n4. 启动游戏，在聊天栏输入命令以启用功能\n5. 初次启动后会生成配置文件 `mods/Stipuleroo/config/config.json`，在里面配置你的快捷键\n\n## 从源码构建\n\n需要 [xmake](https://xmake.io)，以及与目标客户端匹配的 **clang-cl**（LLVM）：从游戏 26.20 起，客户端与 LeviLamina 都由 clang/LLVM 构建，模组也**必须**用 `clang-cl` 编译 —— 用 MSVC 会得到不同的 `entt` 组件类型哈希，导致所有基于 ECS 的功能静默失效。\n\n```powershell\n.\\build.ps1                            # release 构建（自动把 LLVM 的 bin 加进 PATH，然后配置 + 编译）\n.\\build.ps1 -Mode debug -Clean         # debug 构建（先清理）\n.\\deploy.ps1 -Version 1.26.51.01       # 把产物拷进 LeviLauncher 的对应版本\n```\n\n模组当前适配的 LeviLamina 版本写在 `xmake.lua` 与 `tooth.json` 里（换游戏版本时两处一起改）。产物：`bin/Stipuleroo/{manifest.json, Stipuleroo.dll}`。\n\n## 许可证\n\nGPL-3.0 © FeixiangTMC\n"}],"gallery":[],"versions":[{"version":"0.0.6","prerelease":false,"released":"2026-09-26T02:18:07Z","releaseUrl":"https://github.com/FeixiangTMC/Stipuleroo/releases/tag/v0.0.6","manifestUrl":"https://github.com/FeixiangTMC/Stipuleroo/blob/v0.0.6/tooth.json","info":{"name":"Stipuleroo","description":"Minecraft 基岩版客户端多功能辅助模组","tags":["platform:levilamina","type:mod","type:client"]},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"26.51.*"}}]}},{"version":"0.0.5","prerelease":false,"released":"2026-09-14T17:07:37Z","releaseUrl":"https://github.com/FeixiangTMC/Stipuleroo/releases/tag/v0.0.5","manifestUrl":"https://github.com/FeixiangTMC/Stipuleroo/blob/v0.0.5/tooth.json","info":{"name":"Stipuleroo","description":"Minecraft 基岩版客户端多功能辅助模组","tags":["platform:levilamina","type:mod","type:client"]},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"26.40.*"}}]}},{"version":"0.0.4","prerelease":false,"released":"2026-09-10T16:29:32Z","releaseUrl":"https://github.com/FeixiangTMC/Stipuleroo/releases/tag/v0.0.4","manifestUrl":"https://github.com/FeixiangTMC/Stipuleroo/blob/v0.0.4/tooth.json","info":{"name":"Stipuleroo","description":"Minecraft 基岩版客户端多功能辅助模组","tags":["platform:levilamina","type:mod","type:client"]},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"26.40.*"}}]}},{"version":"0.0.3","prerelease":false,"released":"2026-08-10T15:24:04Z","releaseUrl":"https://github.com/FeixiangTMC/Stipuleroo/releases/tag/v0.0.3","manifestUrl":"https://github.com/FeixiangTMC/Stipuleroo/blob/v0.0.3/tooth.json","info":{"name":"Stipuleroo","description":"Minecraft 基岩版客户端多功能辅助模组","tags":["platform:levilamina","type:mod","type:client"]},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"26.10.*"}}]}},{"version":"0.0.2","prerelease":false,"released":"2026-07-04T10:07:52Z","releaseUrl":"https://github.com/FeixiangTMC/Stipuleroo/releases/tag/v0.0.2","manifestUrl":"https://github.com/FeixiangTMC/Stipuleroo/blob/v0.0.2/tooth.json","info":{"name":"Stipuleroo","description":"Minecraft 基岩版客户端多功能辅助模组","tags":["platform:levilamina","type:mod","type:client"]},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"26.10.*"}}]}},{"version":"0.0.1","prerelease":false,"released":"2026-07-01T11:03:33Z","releaseUrl":"https://github.com/FeixiangTMC/Stipuleroo/releases/tag/v0.0.1","manifestUrl":"https://github.com/FeixiangTMC/Stipuleroo/blob/v0.0.1/tooth.json","info":{"name":"Stipuleroo","description":"Minecraft 基岩版客户端功能模组 - 灵魂出窍旁观模式 & 自动切换工具","tags":["platform:levilamina","type:mod","type:client"]},"variants":{"client":[{"side":"client","platform":"win-x64","deps":{"github.com/LiteLDev/LeviLamina#client":"1.8.*"}}]}}],"dependencies":{"github.com/liteldev/levilamina":{"id":"github.com/LiteLDev/LeviLamina","name":"LeviLamina","owner":"LiteLDev","url":"https://levimc.org/mods/github.com/LiteLDev/LeviLamina/"}},"requiredBy":[]}