13 Admin Operations

13 管理员日常操作

中文版本 | English version

这一页把管理员最常用的操作集中放在一起。完整命令列表请看 3 命令与配置。

查看状态

/tpc status

用于查看模块状态，并通过页面中的按钮快速启用或禁用模块。

其中“联动”一行只展示服务端能够确认的运行能力：标准版会显示“客户端地图同步 可用”；只有 BlueMap 本体确实在服务端加载时，才会显示“BlueMap 已加载”。服务端无法判断每个客户端是否安装 Xaero 或 JourneyMap，因此不会分别报告这两个客户端地图模组的加载状态。

查看帮助

/tpc help
/tpc help admin
/tpc help config
/tpc help config teleporting

/tpc help 会显示管理员帮助入口。需要查看某一类配置命令时，可以进入对应 config 主题。

启用或禁用模块

/tpc enable <module>
/tpc disable <module>

常见模块名：

• back
• home
• tpa
• warp
• worldspawn
• rtp
• wild
• integration

修改常用配置

常用示例：

/tpc config teleporting delay 3
/tpc config teleporting cooldown 10
/tpc config teleporting preload true
/tpc config teleporting defaultSafetyCheck true
/tpc config home max 20
/tpc config home sharedMax 1
/tpc config home sharedBroadcastCooldown 60
/tpc config tpa expireTime 120
/tpc config rtp minRadius 4
/tpc config rtp maxRadius 64
/tpc config wild minRadius 512
/tpc config wild maxRadius 4096
/tpc config integration syncIntervalSeconds 10

通过 /tpc config ... 修改的值会写回配置文件。手动编辑配置文件后，才需要执行 /tpc reload。

重载配置

/tpc reload

用于手动修改配置文件后重新加载。平时通过 /tpc config ... 修改时，通常不需要额外执行 reload。

临时开启调试日志

/tpc debug true

排查完成后关闭：

/tpc debug false

额外调试日志默认关闭。不要长期保持开启，除非正在定位问题。

Warp 内容管理

/setwarp <name>
/updatewarp <name>
/renamewarp <name> <newName>
/delwarp <name>
/gwarpmap <name> <true|false>

这些命令用于维护公共 warp 和全局地图可见性。个人地图可见性由玩家自己的 /mapwarp 控制。

常见处理流程

命令不可用：

1. 执行 /tpc status。
2. 确认对应模块是否启用。
3. 确认执行者权限。

传送没有立刻发生：

1. 检查 teleporting.delay。
2. 检查 teleporting.cooldown。
3. 确认玩家是否正在等待已有 pending。

地图航点不刷新：

1. 确认 integration 模块已启用（配置文件中对应 xaero.enabled=true）。
2. 检查 syncIntervalSeconds。
3. 检查 /maphome、/mapwarp、/gwarpmap 可见性状态。