控制台私有传送点

/katpa location（也可写 /katap location）的全部操作只允许服务器控制台执行；即使玩家是 OP，也不能使用 list。传送点归指定玩家私有，按“玩家 UUID → 组 → 名称”保存；与 /home 和公共 /warp 完全独立，不会分享给其他玩家。

/katpa location save <玩家> <组> <名称>
/katpa location list <玩家> [组]
/katpa location tp <玩家> <组> <名称>
/katpa location delete <玩家> <组> <名称>

• save：保存该控制台所在子服在线玩家的当前位置（包括世界、精确坐标、朝向和真实子服名）；同一玩家、组和名称再次保存会覆盖旧点。
• list：按组显示点名、服务器、世界及坐标；可指定组过滤。list 与 delete 可用于离线玩家，但玩家须至少进入过该 KaTpa 数据库关联的任意子服一次，才能按名字查到 UUID；离线名称从共享数据库读取，不依赖当前子服的玩家缓存。
• tp：把该控制台所在子服的在线玩家传送到自己的指定点；本服与跨服均先进行传送吟唱，玩家会看到含组/点名及剩余秒数的 ActionBar、粒子和倒计时音效。移动、受伤或离线会中断吟唱；成功落点后有传送音效及 ActionBar 提示。跨服吟唱结束后走 KaProxy 的落点 ACK 机制，等目标服认证完成才传送到世界/坐标。该控制台传送不收取费用、不检查玩家地标权限。跨服命令返回“已请求”并不代表最终落点已完成。

吟唱可通过 config.yml 中的 modules.location.warmup、warmup-seconds（默认 3 秒）、sounds、particles 独立调整；沿用全局 sounds.countdown、sounds.teleport 和 particles.warmup 效果定义。ActionBar 文案为语言文件的 location-warmup（{group}、{name}、{seconds}）、location-success 和 location-arrived；中断提示沿用其他传送的语言键。配置版本升级为 10 时会备份旧 config.yml 并保留已有设置，包括 modules.rtp.worlds 下自定义世界的覆盖值。已有自定义语言文件如果没有新增文案，插件会使用内置默认文案。

• delete：只删除该玩家的指定组、指定名称。组名/点名为 1–64 字符，不允许空格；查找时忽略大小写，显示保存时的大小写。

数据保存在 KaTpa 当前存储后端的新表 private_location：SQLite 单服独立；MySQL 配置为同一数据库时可跨子服读取。跨服传送还要求 KaProxy 的 modules.back.enabled: true 及两端 KaTpa 使用兼容协议。控制台必须在目标玩家当前所在的子服执行 save 或 tp；不支持从 Lobby 控制台直接操作其他子服的在线玩家。此功能不覆盖 plugins/KaTpa/gui/ 的菜单。