传送命令 Fabric (TPC)

传送命令 Fabric (TPC)

异步服务端传送指令模组，支持多种传送功能和灵活配置。

游戏机制

Teleport Commands Fabric

面向 Fabric 服务器的异步服务端优先传送工具包。

无需安装庞大的服务器插件栈，即可为玩家提供 Home、Warp、TPA、Back、短距离与长距离随机传送、共享位置以及地图集成功能。所有核心命令均可在原版客户端上使用；在客户端安装 Standard 构建可带来更丰富的地图交互体验。

Wiki · 源码 · 问题反馈 · Discord

⚠️ 重要升级警告

如果你使用的是 TeleportCommandsFabric 2.0 至 2.2，请保持 warp.deleteInvalid = false 以避免数据丢失。在这些版本中启用该项可能会在服务器启动时错误地删除所有 Warp 数据。

在启用无效 Warp 清理之前，请升级到当前版本，并在任何重大更新前备份服务器数据。

选择你的构建

构建 包含内容 推荐用于
Standard 所有传送功能，外加内置的 Xaero、JourneyMap 和 BlueMap 集成 大多数服务器和玩家
Core 相同的核心命令和存储行为，但不含内置的地图集成代码 仅需命令的服务器或不需要地图集成的环境

不确定该下载哪个文件？选择 Standard。 当对应的地图模组不存在时，内置集成会保持非激活状态。

如需客户端路径点同步，请在服务器和客户端上都安装 Standard 构建。Core 服务器仍提供所有传送命令，但不会向 Standard 客户端发送路径点数据。

快速安装

  1. 在服务器的 mods 文件夹中安装 Fabric API 和你选择的 TeleportCommandsFabric 构建。
  2. 启动服务器并运行 /tpc help 或 /tpc status。
  3. 可选：在使用 Xaero 或 JourneyMap 集成的客户端上安装 Standard 构建。

命令、可点击的聊天控件、TPA 操作或列表页面均无需客户端安装。

功能简介

功能 玩家可以做什么
Homes 保存永久或临时的个人位置，选择默认 Home，恢复朝向，并通过 /homes 管理一切
Warps 前往由管理员管理的服务器目的地，支持个人和全局地图可见性控制
TPA 发送 /tpa 和 /tpahere 请求，在聊天中接受或拒绝，并定义每位玩家或全局的信任规则
Back 返回最近的死亡位置或上一次 TPC 传送前的位置，支持 /back preview
RTP 在可配置的附近半径内寻找安全的随机目的地
Wild 通过独立的远距离地表传送探索更远区域，专为大范围搜索半径设计
World Spawn 通过相同的受控传送流程返回配置的世界出生点
Shared Homes 发布 Home、在聊天中订阅，并通过 /sharedhomes 浏览已订阅的位置

常用玩家命令：

/home       /homes      /warp       /warps
/tpa        /tpahere    /back       /rtp        /wild
/worldspawn /tpcancel   /sharehome  /sharedhome  /sharedhomes

Wiki 包含完整的语法、权限、配置以及各模块的具体行为说明。

可点击的 Home 和 Warp 页面

/homes 和 /warps 是紧凑的聊天界面，而非纯文本堆叠：

  • 每页四个位置的分页导航；
  • 按首字母或维度筛选；
  • 按名称或创建顺序排序；
  • 可点击的传送和地图可见性控件；
  • 用于更新、重命名、设置默认 Home、共享和删除的专用管理页面；
  • 删除 Home 或 Warp 前的确认提示。

从管理操作返回时，当前页面、筛选和排序状态会被保留。所有控件均可在原版客户端上使用。

共享 Home

玩家可以发布永久 Home，而无需将位置数据复制到另一个档案中：

/sharehome <name>
/sharedhomes
/sharedhome <name>

其他在线玩家会收到一个聊天操作，允许他们订阅。已订阅的 Home 拥有自己的分页页面、个人地图可见性、传送操作和取消订阅控件。

原玩家保留所有权。重命名或更新 Home 会同步更新订阅者；撤回或删除它会移除订阅。发布和订阅属于会话状态，服务器重启时会重置，而原始 Home 仍会正常存储。

管理员可以通过 /tpc config home 配置发布限制和广播冷却时间。

RTP 和 Wild

两种随机传送模式满足不同的服务器需求：

  • /rtp 在可配置的附近半径内搜索，用于日常随机移动。
  • /wild 搜索远处的地表位置以供探索，默认范围为 512 至 4096 格。

Wild 以有限批次准备候选区块，通过自身的安全路径验证地表目的地，并在搜索完成或取消时释放加载资源。通过 /tpc config wild 配置其半径，或使用 /tpcancel 取消正在进行的搜索。

RTP 和 Wild 使用各自的目的地选择和安全逻辑。它们不依赖 Home、Warp、Back 和 World Spawn 所使用的目标预加载和默认安全检查设置。

地图集成

Standard 构建内置对以下内容的支持：

集成 支持内容
Xaero's Minimap / World Map 个人 Home、服务器 Warp、已订阅的 Shared Home、路径点可见性以及 TPC 传送路由
JourneyMap 为 Home、Warp 和 Shared Home 分别设置 TPC 路径点组，外加传送路由和匹配的死亡位置处理
BlueMap 在 BlueMap 网页地图上显示公开的服务器 Warp 标记

Xaero 和 JourneyMap 同步需要在服务器和客户端上都安装 Standard 构建，并搭配相应的地图模组。BlueMap 集成在服务器上运行；玩家通过服务器的 BlueMap 网站查看其标记。

在运行时禁用所有内置地图集成：

/tpc disable integration

无论是否安装了受支持的地图模组，核心传送命令始终可用。

服务器控制

已知目标传送支持可配置的延迟、冷却、区块预加载、安全搜索、旋转恢复、效果以及前一位置记录。管理员可以在服务器运行时管理常用设置：

/tpc status
/tpc enable <module>
/tpc disable <module>
/tpc config <module> ...
/tpc reload
/tpc debug <true|false>

目标预加载和默认目标安全检查默认处于禁用状态。它们可以通过 /tpc config teleporting 启用；目标安全搜索仅在目标预加载启用时运行。RTP 和 Wild 保持各自独立的加载和安全行为。

需要命令示例或配置详情？请从快速入门开始，或浏览完整的 Wiki。