Tupenter

模组

· 作者 Ekra8154

通过按键绑定重新发送聊天和命令,甚至对其进行脚本编写:使用 && 进行链式调用、行内数学表达式、变量、循环、条件判断,以及带有真实自动补全功能的自定义命令。所有操作均在客户端完成,发送的是原版标准命令。

0 本站下载 0 关注 更新于 3 周前

最新 26.3.X-v1.4.1 · 26.3 · Fabric

一键开服(送7天)

Tupenter

Tupenter 是一款客户端侧的 Fabric 模组,充当命令助手。它允许你通过按键绑定重新发送命令或消息,使用内联数学表达式和脚本,并创建带有自动补全功能的自定义命令和脚本。

它的运作方式是将所有自定义脚本和语法转换为纯原版命令,展平后按顺序发送给服务器(如果确实需要发送给服务器的话)。(许多纯计算脚本仅会在客户端回显或显示消息,而不会执行其他操作)。服务器看到的仅仅是纯粹的 /setblock 命令,即使该模组正在实际进行计算以将其渲染为彩虹螺旋。

重新发送

模组名称源于我过去总是需要使用 T + up + Enter 组合来重新发送命令,但现在,Tupenter 会记录你发送的内容,并在按键绑定(默认为 R)时重放它们:

  • 按住模式用于快速连续发送,或切换模式用于免提操作。
  • 批量处理最后 N 条消息,支持两种顺序,并具备单条消息延迟、批次延迟、预设消息列表以及命令反馈抑制功能。
  • 该模组在模组菜单中高度可定制,几乎涵盖了该模组的所有功能,均可通过开关和设置进行调整。

脚本编写

有关完整参考文档(包括每个指令、函数、参数类型和变量),请参阅 GitHub 源码中的 SCRIPTING.md,或者在游戏中运行 /tupenter reference 将其复制到剪贴板。*

该模组主要采用三种类型的语法:

语法 含义
$...$ 表达式:可以直接与原版语法内联使用。它们会被求值,并在发送前进行替换。
#word 指令:给 Tupenter 的指示。是条件判断、循环和历史修改的基础。永远不会发送给服务器。
(...) 分组:在指令之后,括号内包含条件或一组语句,例如 #if (...) (...)。在表达式内部,它们像代码一样工作,用于函数调用如 list(...) 和 blockset(...),以及数学运算如 $(2 + 3) * 4$。在普通命令文本中,它们是普通字符。

链式命令

最简单且我最常用的内联脚本功能是通过 && 链接命令。每个命令都拥有独立的 Brigadier 自动补全和语法高亮。由于它在发送到服务器之前就已解析,因此兼容 WorldEdit 等模组。

/time set day && /weather clear && /say ready

//undo 2 && //replacenear 30 oak_planks spruce_planks && //replacenear 30 oak_stairs ^spruce_stairs

注释

## 后跟一个空格表示开始一条永不运行的备注。它在下一个 && 或行尾结束,因此即使是单行命令也能在其语句之间携带注释:

## bottom left && /activate 1 2 3 && ## the other one && /activate 2 3 4

内联计算

表达式允许简单和复杂的数学运算直接存在于普通的原版命令中。

/give @s stick $32 + 5$
/give @s diamond $3s$                        (s = 64个为一组的堆叠数量)
/summon $pick("zombie", "skeleton")$
/tp @s ~ ~$client.pos.y > 60 ? 10 : 0$ ~

数学运算是精确的,1/3 保持为三分之一,不存在浮点数漂移。

列表有两种形式:逗号会对每个项目求值,而管道符则按输入的原样获取项目,因此方块和物品名称无需引号。

list(1, 2 + 3)
list(oak_log | birch_log | spruce_log)

/calc <expression> 会在本地打印任何结果而不发送任何内容,这在你使用表达式之前进行检查时非常有用。

读取世界

超过九十种实时变量,如位置、生命值、生物群系、光照等级、手持物品、准星指向的对象、天气、你注视的生物及其 NBT 数据。

/echo standing on $block(client.blockpos.x, client.blockpos.y - 1, client.blockpos.z)$
#if (client.target.hit == "block") (/tp @s $client.target.blockpos$)

许多未内置的变量仍然可以通过 NBT 路径直接访问:

/echo elytra damage: $entity("self", "nbt.equipment.chest.components.minecraft:damage", 0)$

/echo $client.target.nbt.Health$

使用 /tupenter dump 浏览 NBT 树并找到你想要的路径。

变量、循环、条件判断

Tupenter 允许创建单次发送范围的变量(#local)、会话持久化变量(#set)、跨会话保存的变量(使用 /tupenter var save \<var\>),以及 #setdefault,它仅在变量尚不存在时创建变量。

#set spawn = "100 64 -200"
#local roll = rand(1, 10) && /give @s stick $roll$ && /say I got $roll$!
#local c:blockpos = blockpos(-10, 20, 85) && /tp $c$
#repeat 5 (/say tick $i$)
#for $x$ in 1..10 step 2 (/summon zombie ~$x$ ~ ~)
#foreach $mob$ in list(zombie | skeleton | creeper) (/summon $mob$ ~ ~ ~)
#foreach $b$ in blockset(#minecraft:wool) (/give @s $b$)
#if (client.health < 6) (/effect give @s regeneration 5 1)
#setdefault runs = 0 && #set runs += 1 && /say run number $runs$

注册表标签通过实时连接解析,在 blockset(...) 内部输入 # 会自动补全服务器上可用的标签。

等待

使用 #wait <time> 以刻、秒、分钟或 Minecraft 天为单位在 Tupenter 动作之间创建延迟。默认情况下,它计算游戏时间,因此在 /tick sprint 期间会加速,当游戏冻结或暂停时停止。脚本采用惰性求值,意味着在 #wait 之后读取的值反映的是当时的世界状态,而不是按下 Enter 时的状态。

等待并不会阻止未来的命令并发运行。默认情况下,Tupenter 允许同时运行 8 个脚本。/tupenter running 显示所有活动命令和脚本及其 PID,而 /tupenter abort <pid> 允许你终止它们。

/say ready && #wait 3s && /say GO
#wait 5m realtime && /echohud &ecows are ready to be fed!
/echo you're at y=$client.pos.y$ && #wait 3s && /echo now you're at y=$client.pos.y$

静音、隐私、本地输出

#silent /time set day && /weather clear          (整行)
#repeat 5 (#silent (/give @s stick) && /say hi)  (仅部分)
#norecord /msg friend secret                     (保留在重发历史记录之外)
/echo &amy y is &e$client.pos.y$                     (仅对你可见,不发送任何内容;&-代码用于着色)
#unstage 2                                       (移除最新的 2 条重发历史记录条目)

#silent 会在你的屏幕上隐藏内容:包括命令的反馈信息,以及当 #set 创建或更新变量时 Tupenter 打印的通知。这些命令仍会正常运行,其他玩家能看到的内容(例如 /setblock 命令的反馈)也会正常发送给其他玩家。

制作你自己的命令

通过 Mod Menu 和 /tupenter menu 可访问的“自定义命令”选项卡,你可以使用原版命令和 Tupenter 语法创建自己的命令。它们可以轻松编辑或删除,并且会自动更新到 Mojang 的 Brigadier 自动补全中,这意味着它们永远不会过时。

/customcommand add waves <count:int> <mob:entity> = #repeat $count$ (/summon $mob$ ~ ~ ~)
/waves 5 zombie

以下是预装的 /blink 的定义。(add 会拒绝已存在的名称,因此请为你的版本指定一个新名称,或使用 /customcommand update 更改现有命令。)

/customcommand add blink <maxdistance:int=100> "teleport to where you're looking" = #silent #local hit = raycast(maxdistance) && #if (hit == "miss") (/tp @s ^ ^ ^$maxdistance$) #else (/tp @s $hit$)

/blink 是一个真正的命令,具备真实的自动补全、类型化参数和可选参数。预装的 /portalcalc 也是另一个例子:

/customcommand add portalcalc <p:blockpos=~ ~ ~> <dim:to_overworld,to_nether=$client.dimension == "minecraft:the_nether" ? "to_overworld" : "to_nether"$> = /echo $dim$: $floor(dim == "to_nether" ? p.x / 8 : p.x * 8)$ $p.y$ $floor(dim == "to_nether" ? p.z / 8 : p.z * 8)$

不带参数的 /portalcalc 会告诉你匹配的传送门在另一维度中的位置,并自动判断从你站立的位置进行转换的方向。这个命令完全不向服务器发送任何内容。/echo 是 Tupenter 在客户端向发送者单独发送消息而不对其他人可见的方式。

还有自定义函数,用于在 $...$ 内部重复使用的值。函数计算一个值且从不发送任何内容,这正是自定义命令的作用所在:

/customfunction add midpoint <a:vec3> <b:vec3> = scale(vadd(a, b), 0.5)
/tp @s $midpoint(client.pos, spawn)$

每刻运行的脚本

Mod Menu → Tupenter → Scripts 包含单行脚本,在主开关开启时,每个游戏刻都会运行。每行被激活的脚本都被包裹在一个循环中,因此它是一个长期运行的脚本,而不是每个游戏刻都重新解析一次:#set 的值会在不同游戏刻之间保持持久,#wait 也能自然工作。

脚本是按世界启用的,因此你在创造模式世界中编写的脚本不会在你的生存服务器触发,而你从未配置过的世界则不会运行任何脚本。/tupenter scripts 显示你当前位置有哪些脚本处于启用状态,而 /tupenter abort all 是紧急停止开关:它会停止所有脚本并关闭主开关。

由于脚本是一个循环,事件是一刻标志位,你需要对其进行测试:

#if (client.just_died) (/echo died at $client.blockpos$)
#if (client.keypress.g) (/togglenightvision)

使用脚本的警告:未加保护的命令在每个游戏刻脚本中每秒会触发 20 次,这在多人服务器上会导致聊天刷屏。请使用 #if 进行保护,如上面的示例所示。

预提供的命令和脚本

下载模组后,它将自带一组自定义命令和脚本列表。这些是我认为有用或有趣的命令,展示了该模组的许多功能方面。它们可以轻松删除或移除,且脚本默认处于禁用状态。

命令,可直接使用:

命令 功能
/blink [maxdistance] 传送到你注视的地方,遇到墙壁时会停止
/ironkit 一套完整的铁制装备
/portalcalc [pos] [dim] 转换下界与主世界之间的坐标
/tickfreeze 切换 /tick freeze
/launch <entity> [speed] [no_gravity] 将你注视方向的实体发射出去

脚本,全部禁用,直到你手动开启:

脚本 功能
rainbowTunnel 按下 ] 并飞行,螺旋状的羊毛隧道会跟随你的运动,并由萤石照明
itemDespawnTimer 标记你死亡的位置,并倒计时物品的五分钟消失时间,每当该区块未被模拟时暂停
creeperAlert 当苦力怕进入 8 格范围内时发出一次警告,并附带距离信息
elytraWarning 在你鞘翅耐久耗尽前发出的耐久度预警
restockReminder 村民在黎明时刷新货物

生活质量改进

  • 聊天栏语法高亮:每个 && 段根据其类型着色; 命令会根据其各自的解析结果对每个参数进行着色
  • 链式感知自动补全:/time set day && /weather cl⇥ 会补全第二个命令
  • 可选中文本:点击并拖动选中消息,Ctrl+C 复制
  • /unroll:试运行任意一行,查看它实际会发送什么,而不真正发送
  • /tupenter vars 列出你的变量,/tupenter var save|delete <name> 管理已保存的变量
  • /tupenter menu 从聊天打开设置屏幕;添加 customcommands 或 scripts 可跳转到相应选项卡
  • 每个功能在 Mod Menu 中都有开/关开关

文档

  • /tupenter help: 游戏中的每个命令、指令、函数和变量都自带文档,并包含可运行的示例
  • /tupenter reference: 将完整参考手册复制到剪贴板
  • SCRIPTING.md: GitHub 上的相同参考手册:模型、每条指令、每个函数、每种参数类型、每个变量以及注意事项

文档由代码所使用的同一注册表生成,因此在我更新模组时不会出现过时的问题。

许可证

采用 MIT 许可证,详情请参阅 GitHub 源代码。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源