跳到正文
返回搜索

Stipuleroo

作者 FeixiangTMC

Minecraft 基岩版客户端多功能辅助模组

  • 387 次下载
  • 6 个星标
  • 更新于
client · 0.0.6

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 里的缺少需要的字段会有日志警告,删掉旧文件让模组重新生成即可。

安装

  1. 安装 LeviLauncher 启动器
  2. 在 LeviLauncher 中安装与你的游戏版本匹配的 LeviLamina 客户端
  3. 从 Releases 页面 下载游戏版本与你一致的 zip,并导入 LeviLauncher
  4. 启动游戏,在聊天栏输入命令以启用功能
  5. 初次启动后会生成配置文件 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

安装 Stipuleroo

运行端
  • 客户端
平台
  • win-x64

在客户端上,请通过以下方式安装: LeviLauncher

从 GitHub 下载