README0.0.6
Stipuleroo
English | 中文
托叶工具,Minecraft 基岩版客户端多功能模组。纯客户端模组:可进入服务器使用。 部分功能可能无法在拥有反作弊插件的服务器里运行。
功能
所有功能都有命令开关,也都可以在配置文件 config.json 里绑定快捷键(默认全部为空 = 不绑定)。
进入游戏时的默认状态:
| 功能 | 进世界默认 |
|---|---|
/fc 灵魂出窍、/ab 自动搭路、/am 自动鼠标操作 | 一律关闭 |
/at 自动工具、/fs 伪潜行、/rv 夜视去雾、/ae 鞘翅自动切换、/ar 自动补货、/fm 移除挖掘冷却 | 由配置里的 xxxDefault 决定 |
配置项命名约定:快捷键一律叫 xxxKey,进世界默认开关一律叫 xxxDefault;配置文件里按功能分块,每个功能的快捷键、默认开关、参数都在同一节里。
灵魂出窍 /fc
输入 /fc 或按快捷键切换灵魂出窍模式:
| 提示 | 含义 |
|---|---|
灵魂出窍模式已启用。 | 已开启,自由飞行 |
灵魂出窍模式已禁用。 | 已关闭,回到身体 |
- 基于 Debug Camera 实现
- 自由飞行时玩家本体冻结在原地,不会移动/破坏方块
- 死亡、退出世界时自动关闭
自动工具 /at
输入 /at 或按快捷键切换自动工具模式:
| 提示 | 含义 |
|---|---|
自动工具切换已启用。 | 已开启 |
自动工具切换已禁用。 | 已关闭 |
- 挖掘方块时自动切换到快捷栏中挖掘速度最快的工具
- 攻击实体时自动切换到伤害最高的武器(计算锋利附魔加成)
- 退出世界时自动关闭;下次进入世界是否默认开启,由配置文件的
autoToolDefault决定
自动搭路 /ab
输入 /ab 或按快捷键切换自动搭路:
| 提示 | 含义 |
|---|---|
自动搭路已启用。 | 已开启 |
自动搭路已禁用。 | 已关闭 |
- 开启后自动在脚下和前方放置方块
- 退出世界时自动关闭
夜视去雾 /rv
输入 /rv 或按快捷键切换夜视去雾:
| 提示 | 含义 |
|---|---|
夜视去雾已启用。 | 已开启 |
夜视去雾已禁用。 | 已关闭 |
- 永久夜视效果,无需药水
- 水下雾、水幕、岩浆雾等视野遮挡一并清除
- 退出世界时自动关闭;下次进入世界是否默认开启,由配置文件的
nightVisionDefault决定
自动鼠标操作 /am
/am 会弹出模式菜单;三种模式各自也可以绑定快捷键。开启一个会自动关掉上一个,再选一次当前项即关闭。
在远程服务器菜单弹不出来时,会在聊天栏列出下面的数字命令,效果完全一样:
| 命令 | 含义 |
|---|---|
/am | 弹出菜单(能弹则弹,不能弹则列出数字命令) |
/am 1 | 连续左键点击(攻击) |
/am 2 | 连续右键点击(放置/使用) |
/am 3 | 持续左键长按(挖掘) |
/am 0 | 关闭 |
切换后聊天栏只提示一行:
| 提示 | 含义 |
|---|---|
自动鼠标操作: 连续左键点击(攻击) | 按间隔攻击准星目标 |
自动鼠标操作: 连续右键点击(放置/使用) | 按间隔放置方块 / 使用物品 |
自动鼠标操作: 持续左键长按(挖掘) | 持续挖掘准星方块 |
自动鼠标操作: 已关闭 | 已关闭 |
- 连续左键点击(攻击)
- 连续右键点击
- 持续左键长按(挖掘)
- 点击间隔可在配置文件中调整(0.05 ~ 1000 秒)
- 打开任何界面(背包 / 聊天 / 表单)时自动暂停,并立刻松开鼠标按键
- 退出世界、死亡时自动关闭
- 可在配置文件中设置点击间隔和右键按下时长
鞘翅自动切换 /ae
输入 /ae 或按快捷键(autoElytraKey)切换:
| 提示 | 含义 |
|---|---|
鞘翅自动切换已启用。 | 已开启 |
鞘翅自动切换已禁用。 | 已关闭 |
- 空中按跳跃→ 自动换上背包里的鞘翅,并接着自动尝试起飞滑翔
- 落地后自动换回原来的胸甲
- 滑翔中当前鞘翅快坏了(剩余耐久 ≤
autoElytraDurability)且背包里有更好的鞘翅 → 中途自动换新并恢复滑翔 - 退出世界时自动关闭;下次进入世界是否默认开启,由配置文件的
autoElytraDefault决定
自动补货 /ar
输入 /ar 或按快捷键(autoRestockKey)切换:
| 提示 | 含义 |
|---|---|
自动补货已启用。 | 已开启 |
自动补货已禁用。 | 已关闭 |
- 手上的物品被耗尽后,自动把同款物品补货到手上
- 退出世界时自动关闭;下次进入世界是否默认开启,由配置文件的
autoRestockDefault决定
移除挖掘冷却 /fm
输入 /fm 或按快捷键(fastMineKey)切换:
| 提示 | 含义 |
|---|---|
移除挖掘冷却已启用。 | 已开启 |
移除挖掘冷却已禁用。 | 已关闭 |
- 秒破方块改为每游戏刻 1 块(20 块/秒,72K/小时),不再被原版的"每 2gt 1 块"拖住
- 非秒破方块:去掉每破坏一块后额外的挖掘冷却
- 此功能目前不能进入远程服务器使用
- 退出世界时自动关闭;下次进入世界是否默认开启,由配置文件的
fastMineDefault决定
配置
模组首次加载后会在 mods/Stipuleroo/config/config.json 生成配置文件。
文件按功能分块(每个功能一节,快捷键 / 默认开关 / 参数都在一起):
// 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 // 进入世界时的默认开关
}
| 配置项 | 对应功能 | 默认值 |
|---|---|---|
debugLog | 是否把诊断日志写进 logs/latest.log(反馈问题时打开) | 正式版 false |
freecamKey | 灵魂出窍 /fc(进世界恒关) | 空(无快捷键) |
autoBridgeKey | 自动搭路 /ab(进世界恒关) | 空 |
autoMouseLeftClickKey | 自动鼠标 /am:连续左键点击(进世界恒关) | 空 |
autoMouseRightClickKey | 自动鼠标 /am:连续右键点击 | 空 |
autoMouseHoldLeftKey | 自动鼠标 /am:持续左键长按(挖掘) | 空 |
autoMouseLeftClickInterval | 左键点击间隔(秒,0.05 ~ 1000) | 0.20 |
autoMouseRightClickInterval | 右键点击间隔(秒,0.05 ~ 1000) | 0.20 |
autoMouseRightClickHold | 右键"按住"时长(秒,0.01 ~ 60);会被自动夹到 ≤ 间隔-0.01 秒,弓/食物等需要按住更久的物品请把间隔一起调大 | 0.10 |
autoToolKey / autoToolDefault | 自动工具 /at 的快捷键 / 默认开关 | 空 / false |
fakeSneakKey / fakeSneakDefault | 伪潜行 /fs —— 无实际效果 | 空 / false |
nightVisionKey / nightVisionDefault | 夜视去雾 /rv 的快捷键 / 默认开关 | 空 / false |
autoElytraKey / autoElytraDefault | 鞘翅智能自动切换 /ae 的快捷键 / 默认开关(每次进入世界时按此值生效,局内用 /ae 或快捷键临时切换) | 空 / false |
autoElytraDurability | 鞘翅剩余耐久 ≤ 此值就换新(0 ~ 1000);设 0 = 胸甲不是鞘翅就换 | 10 |
autoRestockKey / autoRestockDefault | 自动补货 /ar 的快捷键 / 默认开关(每次进入世界时按此值生效,局内用 /ar 或快捷键临时切换) | 空 / false |
autoRestockSettleMs | 用掉物品后等多少毫秒再补货(0 ~ 2000);调大更保险、调小更跟手,0 = 立刻补 | 120 |
fastMineKey / fastMineDefault | 移除挖掘冷却 /fm 的快捷键 / 默认开关(每次进入世界时按此值生效,局内用 /fm 或快捷键临时切换) | 空 / false |
支持的键名:AZ、09、F1~F12、Space、Tab、Enter、Shift、Ctrl、Alt 及左右变体(LShift/RShift、LCtrl/RCtrl、LAlt/RAlt)。
配置文件支持 // 注释,并且支持局内热重载:在游戏里(进没进世界都行)改完保存,约 2 秒后自动生效,不用重进世界,也不用重启游戏。文件写坏时忽略本次修改(保留原配置)。
注意:
xxxDefault只决定每次进入世界的初始状态:局内改它不会当场改变当前世界里的开关(要改当前状态用命令/快捷键),但改完约 2 秒就生效了,退出重进世界(不用重启游戏)即按新值生效。- 快捷键(
xxxKey)同样约 2 秒生效,不需要重启游戏:热键是每次按键现读配置判定。 - 配置文件
config.json里的缺少需要的字段会有日志警告,删掉旧文件让模组重新生成即可。
安装
- 安装 LeviLauncher 启动器
- 在 LeviLauncher 中安装与你的游戏版本匹配的 LeviLamina 客户端
- 从 Releases 页面 下载游戏版本与你一致的 zip,并导入 LeviLauncher
- 启动游戏,在聊天栏输入命令以启用功能
- 初次启动后会生成配置文件
mods/Stipuleroo/config/config.json,在里面配置你的快捷键
从源码构建
需要 xmake,以及与目标客户端匹配的 clang-cl(LLVM):从游戏 26.20 起,客户端与 LeviLamina 都由 clang/LLVM 构建,模组也必须用 clang-cl 编译 —— 用 MSVC 会得到不同的 entt 组件类型哈希,导致所有基于 ECS 的功能静默失效。
.\build.ps1 # release 构建(自动把 LLVM 的 bin 加进 PATH,然后配置 + 编译)
.\build.ps1 -Mode debug -Clean # debug 构建(先清理)
.\deploy.ps1 -Version 1.26.51.01 # 把产物拷进 LeviLauncher 的对应版本
模组当前适配的 LeviLamina 版本写在 xmake.lua 与 tooth.json 里(换游戏版本时两处一起改)。产物:bin/Stipuleroo/{manifest.json, Stipuleroo.dll}。
许可证
GPL-3.0 © FeixiangTMC