-
Notifications
You must be signed in to change notification settings - Fork 0
2 Features Overview
中文版本 | English version
TeleportCommandsFabric 围绕“服务端传送管理”这一件事展开。它把常见的回死亡点、家、互传、公共传送点、出生点传送和随机传送放在同一套体系里，再通过统一的命令入口和配置方式把这些功能组织起来。对玩家来说，最直接的感受是常用传送命令集中在一起；对管理员来说，维护成本则主要体现在模块开关、配置调整和数据管理都比较集中。
这一页说明了这套模组大致包含什么、不同功能之间是什么关系，以及阅读后面的页面时可以先关注哪些重点。
从功能上看，TeleportCommandsFabric 可以分成三部分。
第一部分是玩家最常接触的传送能力。back 用来处理死亡点返回，home 负责个人家传送点，tpa 负责玩家之间的互传请求，warp 提供服务器共享传送点，worldspawn 用于回到设定好的世界出生点，rtp 则负责随机传送。这些内容构成了模组的主体。
第二部分是管理员使用的控制入口。管理员现在推荐通过 /tpc 统一启用或禁用模块、重新加载配置，并直接修改常用运行参数；/teleportcommands 仍保留为兼容别名。
第三部分是与 Xaero 的联动。它会把服务器已有的 warp 和玩家自己的 home 同步为地图中的航点，方便玩家在使用 Xaero 时更直观地查看和使用这些位置。
如果只先记住整体结构，可以先抓这三点：
- 玩家主要接触的是各类传送命令。
- 管理员主要接触的是模块开关和配置入口。
- Xaero 集成建立在前面这些传送数据之上，用于地图显示和联动。
玩家使用这个模组时，通常不会把各个模块看成完全分开的系统，而是把它们当作一组互相配合的传送工具。日常活动中，home 和 warp 往往承担最稳定的定点传送需求，tpa 适合临时和其他玩家会合，back 用来处理意外死亡后的回收，worldspawn 和 rtp 则更多出现在开荒、回城或脱困等场景里。
这些命令虽然用途不同，但在使用体验上仍然有共通之处。例如服务端可以统一设置传送延迟和冷却时间，因此玩家看到的节奏通常是相近的。遇到命令能输入却暂时无法传送时，也往往可以从同一类原因去排查。
管理员更关心的是系统是否容易维护。这个模组的设计重点之一，就是让不同传送功能尽量沿用同一套管理方式。模块开关集中在 /tpc enable 和 /tpc disable，常用配置可以通过 /tpc config ... 在线修改，配置写回后再配合 reload 就能完成大部分调整。
这意味着管理员在处理问题时，思路通常也比较统一。某个命令不可用，先看对应模块是否启用；命令执行后没有立刻传送，继续看全局 delay 和 cooldown；行为与预期不一致，再进一步检查模块自身配置。这样的结构对小型私服和长期运行的服务器都比较实用。
虽然这些模块名称看起来是并列的，但实际使用时它们承担的角色并不相同。
-
home和warp是最稳定的定点传送能力，适合长期使用。 -
tpa更偏向临时协作，重点在请求、接受和超时处理。 -
back处理的是死亡后的回退场景，触发条件相对特殊。 -
worldspawn提供一个固定、明确的公共回点。 -
rtp用于探索和脱离当前位置，结果具有一定随机性。
理解这一点有助于阅读后面的模块页。你会发现，虽然它们都属于传送功能，但关注点并不相同。有些模块更在意数据管理，有些更在意安全检查，有些则更依赖服务器环境和世界配置。
这个模组的一个重要特点，是把部分影响范围较大的行为放在全局配置里统一处理。最明显的就是传送延迟和冷却时间。只要相关命令走同一套传送流程，这两个设置就会直接影响玩家的实际体验。
这也解释了为什么在查问题时，不应该只盯着单个命令本身。比如某个模块看起来“没有立刻传送”，并不一定是模块失效，也可能只是全局延迟正在生效。相反，如果某条命令完全不可用，就更可能与模块开关或模块自身配置有关。
Xaero 集成建立在现有传送数据的基础上。服务端会把 warp 和 home 整理成航点信息，在启用该模块并满足客户端条件时同步给玩家。这样，玩家在地图中就能更容易找到自己常用的位置，也能更直观地理解服务器里已经存在的公共传送点。
这一部分不会改变原有命令的基本用法。即使没有安装 Xaero，home、warp 等命令也照常工作。安装并启用后，主要变化体现在地图显示和联动体验上。关于服务端开关、同步间隔和行为细节，可以继续查看 5.7 Xaero 集成模块；如果你只想先理解它在整套模组中的位置，这里看到的内容已经足够。
这部分只比较客户端体验。前提是服务端已经安装 TeleportCommandsFabric，且相关模块配置正常。
| 对比项 | 客户端不安装本模组 | 客户端仅安装本模组 | 客户端安装本模组 + Xaero 地图模组 |
|---|---|---|---|
| 服务端传送命令可用性 |
back/home/warp/tpa/worldspawn/rtp 全部可用 |
与左侧一致 | 与左侧一致 |
| 命令触发体验 | 标准原版流程 | 对受信传送命令可走更直接的无确认发送流程 | 与中间一致 |
| 点位可视化 | 主要依赖命令和聊天反馈 | 与左侧一致 | 可在地图查看 home 和 warp 航点 |
| 地图交互能力 | 无额外联动 | 无额外联动 | 可结合 Xaero 地图进行点位定位与交互 |
| 适用场景 | 纯服务端命令体验 | 想保留纯命令玩法，但希望命令操作更顺手 | 更重视地图可视化和多人协作效率 |
结论可以分两层看：第一层是命令可用性，不受客户端安装策略影响；第二层是交互体验，安装客户端本模组后会更顺手，进一步配合 Xaero 则会获得完整的地图联动体验。
如果你刚接触这个模组，建议先继续阅读 3 命令与配置，先把常用命令入口看清楚。若你准备直接调整行为和限制，接下来更适合看 4 配置文件。如果你已经知道自己要处理哪个模块，例如 home 或 tpa，那么直接进入 5 模块说明 会更高效。