
图彭特
用快捷键重新发送聊天和命令,甚至可以将它们编写成脚本:用&&链接、内联数学、变量、循环、条件语句,以及带有真正自动补全的自定义命令。全部在客户端完成,发送的是纯原生命令。
查看大图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 源码。
正在加载版本记录…







正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。