【全版本】TPA - 支持 Folia 的简易传送插件，支持 Bukkit/Spigot/Paper/Folia

WarSkyGod

TPA

特点

• 简单：易于使用和配置
• 可配置：支持自定义配置文件
• 多语言支持：内置多种语言文件
• 可自定义语言文件：支持用户自定义语言文件
  

命令
传送

• /tpa <玩家名称>  
  向玩家发送传送请求
• /tphere <玩家名称>  
  请求玩家传送到你身边
• /tpall [player/warp/spawn] [玩家名称/传送点名称]  
  强制将所有在线玩家传送到目标位置（如果不加参数，默认传送到使用者身边）
• /tplogout <玩家名称>  
  传送到该玩家最后一次下线的位置
• /tpaccept  
  接受传送请求（你可以点击聊天框里的 [接受] 来直接接受）
• /tpdeny  
  拒绝传送请求（你可以点击聊天框里的 [拒绝] 来直接拒绝，点击聊天框中的 [拒绝并拉黑] 将拒绝请求并且拉黑该玩家）
• /denys [add/remove] [玩家名称]  
  列出玩家的黑名单列表
  

传送点

• /warp <传送点>  
  传送到传送点
• /setwarp <传送点>  
  设置传送点
• /delwarp <传送点>  
  删除传送点
  

家

• /home <家>  
  传送到家
• /homes  
  列出你设置的家
• /sethome <家>  
  设置家
• /setdefaulthome <家>  
  设置默认的家
• /delhome <家>  
  删除家
  

主城

• /spawn  
  传送到主城
• /setspawn  
  设置主城
• /delspawn  
  删除主城
  

其他

• /back  
  传送到上一次的位置
• /rtp  
  随机传送
• /tpa version  
  检查插件更新
• /tpa setlang <clear/语言>  
  设置客户端显示语言
• /tpa reload  
  重新加载配置文件
  

权限
管理员

• tpa.admin  
  最高权限，可执行所有操作
• tpa.tpall  
  可使用 /tpall 命令强行将所有在线玩家传送到你的位置
• tpa.tplogout  
  可使用 /tplogout 传送到玩家最后的下线位置
• tpa.reload  
  可使用 /reload 命令重新加载配置文件
• tpa.version  
  拥有这个权限的玩家会收到插件更新通知，可使用 /tpa version 来检查插件更新
• tpa.nodelay  
  拥有这个权限的玩家不会受到命令等待时间的限制
  

传送

• tpa.tpa  
  可使用 /tpa 命令请求传送到指定玩家的位置（默认关闭权限检查）
• tpa.tphere  
  可使用 /tphere 命令请求指定玩家传送到你的位置（默认关闭权限检查）
• tpa.rtp  
  可使用 /rtp 命令随机传送（默认关闭权限检查）
  

黑名单

• tpa.denys  
  可使用 /denys 管理黑名单
  

主城

• tpa.spawn  
  可使用 /spawn 命令传送到主城（默认关闭权限检查）
• tpa.setspawn  
  可使用 /setspawn 命令设置主城
• tpa.delspawn  
  可使用 /delspawn 命令删除主城
  

传送点

• tpa.spawn  
  可使用 /warp 命令传送到传送点（默认关闭权限检查）
• tpa.setwarp  
  可使用 /setwarp 命令设置传送点
• tpa.delwarp  
  可使用 /delwarp 命令删除传送点
  

家

• tpa.home  
  可使用 /home、/homes、/sethome、/setdefaulthome、/delhome（默认关闭权限检查）
  

VIP

• tpa.vip
• tpa.vip+
• tpa.mvp
• tpa.mvp+
• tpa.mvp++  
  可在配置文件中设置拥有该权限的玩家最多可以设置多少个家（-1 为不限制）以及命令间隔时间等
  

其他

• tpa.back  
  可使用 /back 命令传送到上一次的位置（默认关闭权限检查）
  

关于配置迁移问题
3.2.0 版本添加了老版本配置文件自动迁移的功能，无需过多担心。  
但出于安全考虑，迁移后会自动备份旧版本配置文件到 plugins/TPA/backup/旧版本号 目录下。如果迁移失败，请手动尝试迁移配置文件。

更新日志

• v3.2.3修复更新
  
  • 修复 /denys 命令在黑名单为空时提示为 null 的问题
  • 修复 主城 和 随机传送点 显示为 MemorySection[path='spawn', root='YamlConfiguration'] 的问题
  • 修复 低版本服务端 在传送倒计时结束后后台无限报错的问题
  • 修复 低版本服务端 在使用 /tplogout 命令时报错的问题
  • 修复 低版本服务端 在迁移旧配置文件的时候 config.yml 缺失项的问题
  • 修复 3.2.0 版本以上在迁移语言文件时迁移失败导致的语言文件为null的问题（#21)
  • 修复 在使用 /tplogout 和 /denys add 命令时 Tab补全出现在线玩家名重复出现的问题
  • 添加 Github 工作流文件以自动发布 Release
    

• v3.2.2修复更新
  
  • 合并修复 tpa启用,tphere关闭,tpaccept,tpdeny,denys应该仍然为启用 （#19）
  • 修复 /tpa reload 命令无法重载 config.yml 的问题
  • 修复 在低版本服务端加载非ASCII字符时文本出现乱码的问题
    

• v3.2.1
  
  • 优化了语言文件的结构（使用 DeepSeek）
  • 重新翻译了 英语 的语言文件（使用 DeepSeek）
  • 添加了 繁体中文（中国香港特别行政区），繁体中文（中国台湾），俄语，法语，德语，日语，韩语，葡萄牙语，西班牙语，意大利语，挪威语，土耳其语，斯洛文尼亚语，瑞典语，芬兰语，丹麦语，希伯来语，荷兰语，希腊语，匈牙利语，捷克语，波兰语 的语言文件（使用 DeepSeek 翻译，如果有翻译问题，请提交issues，非常感谢）
  • 修改了 /tpa setlang 命令的使用条件，目前可以在任意版本使用，如果玩家未使用命令修改过语言，则跟随客户端语言变动，如果使用命令修改了语言，则保持该语言不变，可使用 /tpa setlang clear 恢复自动语言切换
    

• v3.2.0
  
  • 添加了旧版本插件配置自动迁移的功能
  • 添加了 /rtp 命令，可以随机传送
  • 添加了 /tpa version 命令，可以手动检查插件更新
  • 添加了 命令执行间隔 功能，可以设置玩家在使用后多久才能再次使用命令
  • 添加了 tpa.nodelay 权限，拥有权限的玩家可以无视上面的命令执行间隔
  • 修改了 config.yml 的格式，现在可以设置 命令等待间隔、随机传送禁用哪些世界、随机传送的范围等
  • 修复了 在只有两位的服务端版本加载时抛出NumberFormatException的问题（#12）
  • 修复了 一些问题
  • 合并了 teleportDelay为0时，跳过isMove判断 (#13)
  • 合并了 修复：back命令会传送到离开载具、离开床及食用紫颂果的位置 （#14）
  • 合并了 修复 #13 导致的无法传送（#15）
  • FoliaLib 版本 更新到 1.1.9
  • 移除了 Herobrine
    

• v3.1.3修复更新
  注：本次更新可沿用 3.1.0, 3.1.1, 3.1.2 配置文件，无需重新配置
  
  • 修复/sethome 无视权限一律只能设置 default 个家的问题
  • 解决了一些编译器警告问题
    

• v3.1.2修复更新
  注：本次更新可沿用 3.1.0, 3.1.1 配置文件，无需重新配置
  
  • 修复在传送时突然退出游戏导致请求队列无法清除的bug（#11）
  • 修复因为超时未处理而被拒绝的请求消息颠倒的问题
    

• v3.1.1
  注：本次更新可沿用 3.1.0 配置文件，无需重新配置
  
  • 优化代码逻辑，将错误消息改由直接抛出异常
    

• v3.1.0
  
  • 添加了 denys，homes，tplogout，setdefaulthome，setlang 命令
  • 添加了传送时使用title标题倒计时，以及简易的提示音
  • 为tpall命令添加了参数，可以把所有玩家传送到某个玩家/传送点/主城，不填默认传送到你这里
  • 新添加的denys 不加参数的情况下可以列出所有被拉黑的玩家（可通过点击消息来管理）
  • 为warp命令添加了传送点列表显示（可通过点击消息来管理传送点）
  • 为home命令添加了家的列表显示命令/homes（可通过点击消息来管理家）
  • 为home命令添加了设置默认的家的命令/setdefaulthome
  • 合并了来自 @Apleax 的PR(#10) 关于错误消息输出
    

• v3.0.0重构版本大更新
  
  • 重写了绝大部分的逻辑
  • 添加了 tpall，delwarp，home，sethome，delhome，spawn，setspawn，delspawn, back 命令(#7)
  • 添加了自动检测老版本配置文件自动备份功能
  • 添加了检测插件更新功能
  • 修复了如果有两个或以上请求时互相影响的错误
    

• v2.0.1修复更新
  注：由于本人正在重构插件，所以本次修复没有提交代码，属于临时应急构建产物
  
  • 修复在对没有minecraft.command.tellraw权限的玩家发送请求时对方报出没有权限的问题（#8）
    

• v2.0.0
  注：请更新之前提前备份好配置以及语言文件，删掉让插件重新生成再修改
  
  • 添加了自动根据客户端语言提供不同的翻译，如果没有对应的翻译文本将默认使用 Config.yml 中 lang 的值
    

• v1.3.2修复更新
  
  • 修复了在第一次加载语言文件的时候文本为null的问题（#6）
  • 合并了来自 @Apleax 的修复代码（#5）因为文件已经存在导致的Could not save输出
    

• v1.3.1
  
  • 修复了在设置传送点之后启动服务器报错的问题（#4）
  • 添加了在使用 /warp 和 /setwarp 命令时可以使用Tab键调出已有的传送点名字
  • 更新了 FoliaLib 版本到 1.1.6
  • 删除了部分不再需要的无用代码
  • 更改了部分if逻辑到switch使得代码更加易读
    

• v1.3修复版本
  
  • 修复/back命令在多人使用的时候会窜到其他玩家的上一次的位置 (#3)
    

• v1.3
  
  • /tpareload 命令现在变成 /tpa reload
  • 添加了/back命令（需要tpa.back）权限 (#2)
    

• v1.2
  
  • /restp命令变更为/warp命令
  • /restpset命令变更为/setwarp命令
    

• v1.1
  
  • 使用 FoliaLib 优化了插件逻辑
  • 添加了/tpareload 命令
  • 配置菜单里现在可以修改传送的等待时间
    

• v1.0
  
  • 初始提交
    

感谢
本插件使用了 FoliaLib 来做 Folia 兼容

代码贡献者

• fanlepian1
• Apleax
• LFWQSP2641
• sky-3311
  

Bug 报告者

• fanlepian1
• Apleax
• luckeist
• DuckCattyCotton
• Ry4nnnnn
• sky-3311
  

功能建议者

• Apleax
  

AI 大模型

• DeepSeek