图彭特

图彭特

用快捷键重新发送聊天和命令,甚至可以将它们编写成脚本:用&&链接、内联数学、变量、循环、条件语句,以及带有真正自动补全的自定义命令。全部在客户端完成,发送的是纯原生命令。

管理

Tupenter

Tupenter 是一个客户端 Fabric 模组,充当命令助手。它允许你通过按键重新发送命令或消息,使用内联数学和脚本,并创建自己的命令和脚本,还支持自动补全!

它的工作原理是将所有自定义脚本和语法转换为纯原版命令,展平后按顺序发送给服务器(如果最终要发送给服务器的话)。(许多纯计算脚本只会在客户端回显或显示消息,不会做其他事情)。服务器看到的只是纯粹的 /setblock 命令,即使模组在背后进行了真正的计算,将其变成彩虹螺旋。

重新发送

模组名字来源于我过去总是不得不使用 T + 上 + 回车组合来重新发送命令,但现在,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 = stacks of 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

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

/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          (whole line)
#repeat 5 (#silent (/give @s stick) && /say hi)  (just part of it)
#norecord /msg friend secret                     (kept out of resend history)
/echo &amy y is &e$client.pos.y$                     (shown only to you, sends nothing; &-codes color it)
#unstage 2                                       (drop the newest 2 resend-history entries)

#silent 隐藏你屏幕上的内容:命令的反馈,以及当 #set 创建或更新变量时 Tupenter 打印的通知。命令仍然正常运行,其他玩家应该看到的内容仍然会到达他们,比如 /setblock 命令的反馈。

创建你自己的命令

/customcommand 以及通过模组菜单和 /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 源码。