萨穆的命令

萨穆的命令

为Minecraft添加的几个小功能。

游戏机制

Samū 的命令(模组 ID:rfx-cmd)

一个面向 Minecraft 1.20.x 的小型模组,添加了若干小型玩法功能。该模组为 Fabric 制作,并需要 Fabric API。

该模组同时具有客户端与服务端功能,但其运作方式是:若服务端安装了该模组,客户端无需安装;反之亦然。该模组主要添加了一些命令,在服务端最为有用,但客户端也添加了一些小巧的功能(尤其是在服务端也安装了该模组的情况下)。

服务端功能

此处列出的所有命令与游戏规则都会自动与所有客户端共享,因此无论玩家是否安装了该模组,都能使用这些功能。

家

该模组添加了广为人知的 /home 和 /sethome 命令。你有一个主家,可以通过不带额外名称调用基础命令来使用它。你可以通过带上特定名称调用命令来添加更多具名家。

  • /home(别名 /h)传送至你最后一次调用 /sethome 的位置
  • /sethome(别名 /sh)将你的家设置到当前位置
  • /delhome 删除你的家
  • /gethome(别名 /gh)获取你的家的坐标,或当游戏规则 reducedDebugInfo 设置为 true 时仅获取你是否拥有该家
  • /homes 列出你的家,若游戏规则允许还会列出坐标
  • /clearhomes 移除你所有具名家,主家除外
  • /clearhomes true 移除你所有的家,包括主家

家可以通过游戏规则进行控制:

  • /gamerule allowHomeTp true|false(默认 true)启用或禁用所有家命令。当为 false 时,只有管理员可以访问家命令。此游戏规则对在单人世界中启用了作弊的玩家同样无效。
  • /gamerule maxHomes <nr>(默认 0)设置玩家可拥有的家的最大数量,无论是具名家还是主家。值 0 表示禁用限制。如果玩家拥有的家超过该数量,则必须先移除家才能设置更多家。如果玩家恰好拥有该数量的家,则只能覆盖已有的家。此命令仅影响 /sethome,拥有超过此游戏规则所允许数量的家的玩家仍然可以传送到其中任意一个。管理员和启用了作弊的玩家可以设置更多家。

家可从任意距离跨维度生效。在下界设置的家允许主世界中的玩家瞬间传送到下界中的该家。

一个有用的功能:家名称可以在聊天中被点击,并根据打印时该家是否存在来建议 /home 或 /sethome 命令。

出生点传送

该模组添加了一个简单的命令,让玩家可以传送到主世界的世界出生点。

  • /spawn(别名 /s)

此行为可以通过游戏规则启用或禁用:

  • /gamerule allowSpawnTp true|false(默认 true)启用或禁用 /spawn 命令。

传送请求

该模组添加了广为人知的 /tpa 系统,用于向玩家发送传送请求。它通过一组命令进行控制:

  • /tpa <player> 向 <player> 发送传送请求。若对方接受,你将被传送到对方处。
  • /tpc <player> 向 <player> 发送传送召唤。若对方接受,对方将被传送到你处。
  • /tpaccept 接受最后收到的传送请求
  • /tpaccept <player> 接受来自 <player> 的传送请求
  • /tpaccept * 接受所有传送请求与召唤,请谨慎使用,因为如果你收到了大量请求与召唤,这可能会造成相当大的混乱
  • /tpdeny 拒绝最后收到的传送请求
  • /tpdeny <player> 拒绝来自 <player> 的传送请求
  • /tpdeny * 拒绝所有传送请求

你可以使用黑名单和白名单来控制谁可以向你发送请求。白名单默认禁用但可以启用。若白名单启用,则除非对方在白名单中,否则任何人都无法向你发送请求。黑名单中的玩家即使也在白名单中,也永远无法向你发送请求。若白名单禁用,则除黑名单中的玩家外,所有人都可以请求。

  • /tpblacklist add <player>(别名 /tpbl add <player>)将玩家添加到你的传送黑名单
  • /tpblacklist remove <player>(别名 /tpbl remove <player>)将玩家从你的传送黑名单中移除
  • /tpwhitelist add <player>(别名 /tpwl add <player>)将玩家添加到你的传送白名单
  • /tpwhitelist remove <player>(别名 /tpwl remove <player>)将玩家从你的传送白名单中移除
  • /tpwhitelist enable(别名 /tpwl enable)启用你的白名单,除非对方在白名单中,否则阻止所有人
  • /tpwhitelist disable(别名 /tpwl disable)禁用你的白名单,除非对方在黑名单中,否则不阻止任何人
  • /tpwhitelist toggle(别名 /tpwl toggle)切换你的白名单,若已禁用则启用,若已启用则禁用

传送请求可以通过若干游戏规则进行控制:

  • /gamerule allowTpa true|false(默认 true)为所有人启用或禁用所有传送请求命令,即使对管理员和启用了作弊的玩家也是如此(毕竟他们有常规的 /tp 命令,否则玩家无法接受请求)。
  • /gamerule tpaRequestTimeout 1..3600(默认 300)以秒为单位定义传送请求过期前的时间。请求必须在此时间范围内被接受,否则将被静默拒绝(不向发起者或目标发送任何消息)。
  • /gamerule tpaRequestSameTeam true|false(默认 false)设置传送请求是否只能发送给同一队伍中的玩家。这也会将不在队伍中的玩家视为处于同一个“不在队伍中”的队伍,因此他们仍可以相互发送请求。若禁用,则所有人都可以向所有人发送请求。
  • /gamerule tpaMode tpa|tpc|both(默认 both)设置玩家相互传送的方向。若设置为 tpa,玩家只能将自己传送到他人处(即他们可以使用 /tpa)。若设置为 tpc,玩家只能将他人传送到自己处(即他们可以使用 /tpc)。若设置为 both,玩家可以两者皆可(即他们可以使用 /tpa 和 /tpc)。

个人笔记

玩家可以为自己编写小笔记,笔记按世界存储(在服务端一侧)。笔记以多行形式存储,玩家可以自由编辑、移动、删除和添加。

  • /notes add <note>(别名 /note <note>)添加一条带有给定文本的新笔记
  • /notes edit <ln> <note> 编辑第 <ln> 行的笔记,将文本替换为给定文本
  • /notes remove all 移除所有笔记
  • /notes remove <ln> 移除一条特定笔记
  • /notes remove <from> <to> 移除一个范围内的笔记
  • /notes move <from> <to> 将一条笔记从一行移动到另一行
  • /notes last(别名 /note)显示最后一行编号处的笔记
  • /notes last <nr> 显示最后 <nr> 行编号处的笔记
  • /notes get all(别名 /notes)列出所有笔记
  • /notes get <ln> 列出某条特定笔记
  • /notes get <from> <to> 列出一个范围内的笔记

若游戏规则 reducedDebugInfo 设置为 false,笔记允许插入一些简单的数据点,例如你的坐标或你的维度。每一个都会将特定信息插入到其在笔记中所放置的位置。它们旨在让你更容易地将调试屏幕中的一些信息插入到笔记中。

  • {xyz}(别名 {pos}、{coords})插入你在世界中的坐标
  • {xz} 插入你在世界中的 X 和 Z 坐标
  • {x} 插入你在世界中的 X 坐标
  • {y} 插入你在世界中的 Y 坐标
  • {z} 插入你在世界中的 Z 坐标
  • {dimension}(别名 {dim})插入你所在维度的维度 ID

由于笔记存储在服务端一侧的玩家数据中,因此存在一个游戏规则用于限制每个玩家的笔记数量,以限制每个玩家的内存使用。笔记有一个硬编码的长度限制为 1024 个字符,但每个玩家的笔记数量是可配置的。

  • /gamerule maxNotes 1..4096(默认 1024)设置玩家可以拥有的笔记的最大数量。更改它不会立即移除玩家的笔记。

一个有用的功能:聊天中打印的笔记行可以被点击,以将笔记行复制到剪贴板。

兴趣点

除了家命令之外,该模组还提供了兴趣点,其类似于在所有玩家之间共享的家。除非另有配置,否则只有管理员可以设置它们。默认情况下所有玩家都可以传送到它们。所有针对单个兴趣点的命令都可以有一个可选的名称参数,用于设置具名兴趣点。主兴趣点没有名称,必须通过不提供名称来引用。

  • /poi 传送到由 /setpoi 设置的兴趣点
  • /setpoi 将兴趣点设置到当前位置
  • /delpoi 删除一个兴趣点
  • /getpoi 获取兴趣点的坐标,或当游戏规则 reducedDebugInfo 设置为 true 时仅获取该兴趣点是否存在
  • /pois 列出所有兴趣点,若游戏规则允许还会列出其坐标
  • /clearpois 移除所有具名兴趣点,保留主兴趣点
  • /clearpois true 移除所有兴趣点,包括主兴趣点

兴趣点可以通过游戏规则进行控制:

  • /gamerule allowPoi true|false(默认 true)启用或禁用所有兴趣点命令。当为 false 时,只有管理员可以访问兴趣点命令。此游戏规则对在单人世界中启用了作弊的玩家同样无效。
  • /gamerule allCanSetPoi true|false(默认 false)启用或禁用兴趣点修改命令。当为 false 时,只有管理员可以更改、添加和移除兴趣点。当为 true 时,所有玩家都可以编辑兴趣点。
  • /gamerule hidePoiInfo true|false(默认 false)启用或禁用兴趣点查询命令。当为 false 时,只有管理员可以访问兴趣点查询命令(/pois、/getpoi)。这不会禁用 /poi 传送命令。

兴趣点与家一样,可从任意距离跨维度生效。在下界设置的兴趣点允许主世界中的玩家瞬间传送到下界中的该兴趣点。

上次死亡

该模组有一个功能,可以将玩家传送到他们上次死亡的位置。这可以通过两种方式实现:

  • 使用 /death
  • 通过使用追溯指针点击(这需要玩家获得这样的指针)

一个游戏规则可以控制此能力:

  • /gamerule deathTp off|command|compass|both(默认 compass)设置玩家如何传送到他们上次死亡的位置。

    • 当为 off 时,该功能被禁用。
    • 当为 command 时,该功能只能通过命令访问,玩家无需追溯指针。
    • 当为 compass 时,该功能只能通过追溯指针访问。
    • 当为 both 时,该功能可通过命令和追溯指针两者访问,因此玩家不一定要有追溯指针,但仍然可以使用它。

    对于管理员,此游戏规则无效:他们可以无限使用命令和追溯指针。

宠物与拴绳生物

现在你有了花哨的传送命令,但你有一只猫或狗,而它会留在你传送走的地方。哦不!但别担心,因为宠物可以随你传送,被拴绳的生物也可以。默认情况下,被拴绳的生物可以跨维度传送,而宠物只能在同维度内传送。这可以通过游戏规则进行配置:

  • /gamerule teleportPets off|dimension|interdimensional(默认 dimension)设置宠物如何随玩家传送。
  • /gamerule teleportLeashedMobs off|dimension|interdimensional(默认 interdimensional)设置被拴绳的生物如何随玩家传送。

两个游戏规则遵循相同的原则:

  • off 完全禁用该功能。
  • dimension 仅允许在同一维度内传送动物,不能传送到不同维度。
  • interdimensional 允许将动物传送到其他维度。

客户端功能

目前,客户端功能并不多。

家按键

你可以绑定按键来设置并传送到你的主家。

计划功能

  • 家管理器:一个显示你的家并可供你管理它们的可视化界面。
  • 磁石传送:允许玩家使用磁石指针点击,传送到与其关联的磁石。

许可证

Copyright (C) 2023 Runefox

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.