YuTeleport 命令手册
YuTeleport 的主命令为 /yuteleport，默认别名为 /ytp 和 /rtp。/rtp 保留给旧随机传送习惯，管理员和脚本系统建议使用完整命令 /yuteleport。
主命令
| 命令 | 权限 | 执行者 | 说明 |
|---|---|---|---|
/yuteleport | yuteleport.use | 玩家 | 将自己随机传送到当前世界的安全位置。 |
/ytp | yuteleport.use | 玩家 | /yuteleport 的短别名。 |
/rtp | yuteleport.use | 玩家 | 兼容旧 RTP 使用习惯的别名。 |
/yuteleport biome:<模式> | yuteleport.use、yuteleport.biome | 玩家 | 单次随机传送指定生物群系匹配模式。 |
/yuteleport <玩家> [世界] [biome:<模式>] | yuteleport.teleport.others | 管理员或控制台 | 将在线玩家随机传送到当前或指定世界。 |
/yuteleport reload | yuteleport.reload | 玩家或控制台 | 重载配置、语言、Vault/PlayerPoints、PlaceholderAPI 与模块命令。 |
/yuteleport help | 无固定权限 | 玩家或控制台 | 按执行者权限显示帮助。 |
/yuteleport share | yuteleport.share | 玩家 | 分享最近成功传送后的当前位置。 |
/yuteleport join <令牌> | 无固定权限，受分享配置限制 | 玩家 | 点击或输入分享令牌传送到他人分享的坐标。 |
随机传送
text
/rtp
/ytp
/yuteleport
/yuteleport biome:*FOREST*
/yuteleport Steve resource biome:PLAINS随机传送会检查目标玩家权限、模块开关、世界黑白名单、冷却、等待、经济扣费和安全点规则。拥有 yuteleport.bypass.cooldown、yuteleport.bypass.cost、yuteleport.bypass.wait 的玩家可分别绕过冷却、费用和等待。
Warp 命令
| 命令 | 权限 | 说明 |
|---|---|---|
/warp 或 /warp list | yuteleport.warp.use | 查看可见 warp。 |
/warp <名称> | yuteleport.warp.use | 传送到指定 warp。 |
/warp public | yuteleport.warp.use | 查看公开 warp。 |
| `/warp public <名称> [true | false]` | yuteleport.warp.public |
/warp rename <旧名> <新名> | yuteleport.warp.set | 重命名可编辑的 warp。 |
/warp desc <名称> <描述> | yuteleport.warp.set | 修改可编辑 warp 的描述。 |
| `/setwarp <名称> [restricted] [public | private] [描述]` | yuteleport.warp.set |
/delwarp <名称> | yuteleport.warp.delete | 删除自己的 warp；控制台或管理员可删除全局 warp。 |
restricted warp 通过 yuteleport.warps.<名称> 精确授权。创建数量由 teleports.warp.max-warps、yuteleport.warp.limit.<数量>、yuteleport.warp.limit.unlimited 和分组配置共同决定。
Home 命令
| 命令 | 权限 | 说明 |
|---|---|---|
/home | yuteleport.home.use | 传送到默认 home。 |
/home <名称> | yuteleport.home.use | 传送到自己的指定 home。 |
/home <玩家>:<名称> | yuteleport.home.others 或公开 home | 使用在线玩家的 home。 |
/home list [玩家] | yuteleport.home.use，查看他人需 yuteleport.home.others | 查看 home 列表。 |
/home public | yuteleport.home.use | 查看公开 home。 |
| `/home public <名称> [true | false]` | yuteleport.home.public |
/home rename <旧名> <新名> | yuteleport.home.set | 重命名自己的 home。 |
/home desc <名称> <描述> | yuteleport.home.set | 修改 home 描述。 |
/homes [玩家] | yuteleport.home.use，查看他人需 yuteleport.home.others | 查看 home 列表。 |
| `/sethome [名称] [public | private] [描述]` | yuteleport.home.set |
/delhome <名称> | yuteleport.home.delete | 删除自己的 home。 |
/delhome <玩家>:<名称> | yuteleport.home.others | 删除在线玩家的 home。 |
home 数量由 teleports.home.max-homes、yuteleport.home.limit.<数量>、yuteleport.home.limit.unlimited 和分组配置共同决定。
TPA 命令
| 命令 | 权限 | 说明 |
|---|---|---|
/tpa <玩家> | yuteleport.tpa.use | 请求传送到对方。 |
/tpahere <玩家> | yuteleport.tpa.here | 请求对方传送到自己。 |
/tpahere all | yuteleport.tpa.all | 向全服玩家发送 tpahere 请求。 |
/tpaall 或 /tpallhere | yuteleport.tpa.all | 向全服玩家发送 tpahere 请求。 |
/tpaccept [玩家] | yuteleport.tpa.use | 接受指定或最近的 TPA 请求。 |
/tpdeny [玩家] | yuteleport.tpa.use | 拒绝指定或最近的 TPA 请求。 |
/tpacancel | yuteleport.tpa.use | 取消自己发出的请求。 |
/tpaignore | yuteleport.tpa.ignore | 切换是否忽略发给自己的 TPA 请求。 |
TPA 的冷却和扣费归属请求发起者；tpahere 中实际被移动的是接受方。
Back 命令
| 命令 | 权限 | 说明 |
|---|---|---|
/back | yuteleport.back.use | 按配置优先级返回最近可用位置，默认优先死亡点，其次插件传送前位置，再次外部传送前位置。 |
/back death | yuteleport.back.death | 返回最近一次死亡位置。 |
/back list | yuteleport.back.use | 查看可返回历史；没有 yuteleport.back.death 时不会显示死亡记录。 |
/back clear | yuteleport.back.clear | 清空自己的 back 历史。 |
/back <UUID> | yuteleport.back.use | 返回列表中指定历史条目；交互式聊天开启时点击列表项会自动执行。 |
Back 历史由 teleports.back.capture 控制，默认记录插件传送、死亡和外部插件/原生命令传送前的位置。历史可持久化到 plugins/YuTeleport/data/back/，默认保留 5 条，1800 秒后过期。
可配置命令名
warp、home、tpa、back 模块命令可在 config.yml 中调整：
yaml
teleports:
warp:
commands:
warp: [warp, warps]
home:
commands:
home: [home]
tpa:
commands:
tpa: [tpa]
back:
commands:
back: [back]第一个名称是主命令，其余是别名；写成 [] 可禁用对应逻辑命令。