TeleHop

插件

· 作者 epildev

适用于 Paper + Velocity 网络的跨服务器传送套件。包含家园、传送点、TPA、RTP、/back 和 /spawn 功能,所有数据均通过 MySQL 在服务器间同步。提供模块化配置、多语言支持以及可自定义的传送特效。

0 本站下载 0 关注 更新于 1 周前

最新 2.2.0 · 26.2 · Paper

一键开服(送7天)

🌐 TeleHop

适用于 Paper 和 Velocity Minecraft 网络的跨服务器传送套件。

TeleHop 专为多服务器 Minecraft 网络构建。它通过 Velocity 连接 Paper 后端服务器,并在整个网络中保持传送数据同步。

玩家可以在服务器间使用家园、传送点、玩家自定义传送点、TPA、随机传送(RTP)、/back、/spawn 以及最后位置传送功能。

TeleHop 将共享数据存储在 MySQL 中,因此家园、传送点、玩家自定义传送点、TPA 请求、玩家追踪以及登出位置在所有服务器上均保持同步。

GitHub · Documentation · Setup · Commands · Permissions · Configuration · Support


✨ TeleHop 的功能

TeleHop 为你的 Velocity 网络提供了一套完整的传送系统。

  • 跨服务器 /spawn
  • 跨服务器 TPA
  • 跨服务器家园
  • 跨服务器传送点
  • 跨服务器玩家自定义传送点
  • 跨服务器 /back
  • 跨服务器管理员传送
  • 命名家园
  • 最后登出位置传送
  • 随机传送 GUI
  • 随机重生系统
  • 基于 MySQL 的存储
  • 支持可选的 Redis TLS(用于多代理网络)
  • 模块化配置文件
  • 多语言支持
  • LuckPerms 支持
  • 基于权限的限制
  • 管理员管理工具

📦 Version 2.2.0

TeleHop 2.2.0 为传送预热提供了更清晰、更安静的呈现方式:屏幕中央显示一个每秒更新一次的大型绿色倒计时。

变更内容

  • 在启用传送预热时,屏幕中央显示绿色的标题倒计时。
  • 聊天栏或动作栏不再重复显示倒计时数字。
  • 传送完成或移动取消预热时,标题会清除。
  • 现有的 show-countdown 设置控制标题的显示。
  • 所有六种内置语言的 countdown-title 翻译已新增。

保留的现有功能

  • Redis TLS 支持证书和主机名验证,包括自定义 PEM CA 证书。
  • RTP 菜单中实时显示带颜色编码的目标延迟估计值。
  • 选择目标后,RTP 菜单立即关闭。
  • RTP 冷却时间从选择目标时开始计算,而不是从打开菜单时开始。
  • Pending-RTP 保护机制防止因重复点击或命令导致预热叠加。
  • 现有的家园、传送点、玩家自定义传送点、传送请求及跨服务器路由功能保持不变。

升级至 2.2.0

  • 备份现有的 JAR 文件和配置,然后安装匹配的 Paper 和 Velocity 2.2.0 版本。
  • 保留现有的配置、存储和数据库记录。从 2.1.0 升级到 2.2.0 无需进行数据库迁移或协议更改。
  • 在现有的语言文件(包括 languages/en.yml)中添加以下顶层键:
countdown-title: "<green><bold>Teleporting in <seconds></bold></green>"
  • 缺失的内置语言键不会自动合并。回退机制会使用你磁盘上的英文文件,因此该文件也必须包含新的键。
  • 现有的延迟时间和豁免权限保持不变。零秒延迟或拥有 delay-bypass 权限仍会跳过倒计时。
  • 逐个重启已更新的服务器。在多代理网络中,在每个代理重启期间请保留另一个代理可用。

🚀 传送功能

网络出生点

/spawn 将玩家发送至配置的 Hub 服务器。

Spawn 支持针对多代理网络的地域感知路由。

示例:

  • EU 玩家可路由至 lobby-eu
  • US 玩家可路由至 lobby-usa

随机传送

/rtp 打开一个 GUI,供玩家选择区域和维度。

随后 TeleHop 会在配置的半径内寻找安全的落点。

RTP 支持:

  • 区域选择
  • 维度选择
  • 带有实时颜色编码值的目的地延迟显示
  • 选择目标后应用冷却时间
  • 带有中央标题倒计时和 Pending-RTP 保护的预热
  • 移动取消
  • 异步安全位置搜索
  • 安全着陆检查
  • GUI 返回按钮

TPA

TeleHop 支持跨服务器传送请求。

命令:

  • /tpa <player>
  • /tpahere <player>
  • /tpaaccept
  • /tpadeny
  • /tpacancel
  • /tpatoggle

TPA 支持:

  • 跨服务器请求
  • 可点击的接受和拒绝按钮
  • 超时机制
  • 冷却时间
  • 预热
  • 移动取消
  • 基于会话的 TPA 开关
  • 当目标禁用了请求时,向发送者发送通知

Back

命令:

  • /back
  • /back death

功能:

  • 返回传送前的最后位置
  • 返回最后的死亡位置
  • 跨服务器生效
  • 基于会话的位置追踪

🏠 命名家园

TeleHop 现在使用命名家园替代数字槽位。

玩家可以按名称创建、删除和传送至家园。

命令

  • /home
  • /home <name>
  • /sethome <name>
  • /delhome <name>

功能

  • 每位玩家最多 10 个家园
  • 基于权限的家园数量限制
  • 跨服务器家园传送
  • 家园名称不区分大小写
  • 名称支持字母、数字和空格
  • 家园名称最大长度为 32 个字符
  • 5 行家园 GUI
  • 可配置的床颜色
  • 空床可设置家园
  • 被占用的床传送至家园
  • 鼠标中键(Shift-click)可删除家园
  • 锁定槽位显示升级提示
  • GUI 中包含服务器和世界标签
  • 禁止设置家园的服务器列表
  • 玩家仍可从未允许的服务器传送至已有的家园

📍 最后位置

TeleHop 将每位玩家的最后登出位置保存至 MySQL。

玩家可以在服务器间返回其最后保存的登出位置。

命令

  • /lastlocation
  • /lastloc
  • /backlast
  • /ll

功能

  • 退出时保存位置
  • 重启后持久化保存
  • 跨服务器生效
  • 将玩家发送至正确的后端服务器
  • 管理员可查看、传送到或清除保存的最后位置

TeleHop 支持管理员传送点和玩家传送点。

管理员传送点

命令:

  • /warp <name>
  • /setwarp <name>
  • /delwarp <name>
  • /warps

功能:

  • 全局网络传送点
  • 跨所有服务器共享
  • 存储于 MySQL
  • 支持按传送点设置权限
  • 跨服务器传送

权限示例:

telehop.warp.shop

玩家传送点

命令:

  • /pwarp set <name>
  • /pwarp del <name>
  • /pwarp list
  • /pwarp <name>
  • /pwarp <player> <name>
  • /pwarp public <name>
  • /pwarp admin del <player> <name>

别名:

  • /playerwarp
  • /pwarps

功能:

  • 个人玩家传送点
  • 可切换公开或私有状态
  • 跨服务器传送
  • 按玩家组限制数量
  • 管理员删除命令
  • 基于 MySQL 的存储

💀 随机重生

TeleHop 可以在玩家死亡后,将其重生在一个安全随机的位置。

功能:

  • 异步搜索安全位置
  • 基于 Paper HeightMap 查找
  • 可配置的世界
  • 可配置的半径
  • 尊重床和重生锚点
  • 支持跳过枢纽服务器
  • 通过配置文件控制每个服务器的行为
  • 通过 config/respawn.yml 进行控制

🛠 管理员命令

TeleHop 包含用于跨服务器传送、传送点管理、家园管理、最后位置工具、玩家数据检查以及插件控制的管理员命令。

管理员命令受权限保护,并且对没有访问权限的玩家隐藏于 Tab 补全中。

TeleHop 管理

命令 描述 权限
/telehop 显示 TeleHop 帮助 所有人
/telehop help 显示分类的命令帮助 所有人
/telehop version 显示已安装的 TeleHop 版本 所有人
/telehop ver 版本的别名 所有人
/telehop reload 重新加载配置、消息和传送点缓存 telehop.admin
/telehop perms 列出所有权限节点 telehop.admin
/telehop permissions 权限的别名 telehop.admin

管理员传送

命令 描述 权限
/tp <player> 跨服务器将你传送到一名玩家处 telehop.tp
/tp <player1> <player2> 跨服务器将一名玩家传送到另一名玩家处 telehop.tp
/tp <x> <y> <z> 将你传送到当前世界中的坐标 telehop.tp
/tp <player> <x> <y> <z> 将一名玩家传送到指定坐标 telehop.tp
/tphere <player> 跨服务器将一名玩家拉取到你所在的位置 telehop.tphere

传送点管理

命令 描述 权限
/setwarp <name> 创建或更新全局管理员传送点 telehop.admin
/delwarp <name> 删除全局管理员传送点 telehop.admin
/listwarps 列出所有服务器上所有玩家的传送点 telehop.admin
/listwarps <player> 列出特定玩家的传送点及其详情 telehop.admin
/forcedelwarp <name> 强制删除管理员传送点 telehop.admin
/forcedelwarp <player> <name> 强制删除特定玩家的传送点 telehop.admin
/pwarp admin del <player> <name> 删除任何玩家的私人传送点 telehop.admin

家园管理

命令 描述 权限
/forcedelhome <player> 列出玩家的家园并带有可点击的删除按钮 telehop.admin
/forcesethome <player> <name> 在你当前的位置为另一名玩家设置一个命名的家园 telehop.admin
/listhomes <player> 列出玩家的家园并带有可点击的传送和删除按钮 telehop.admin

最后位置管理

命令 描述 权限
/forcelastloc <player> 查看玩家的最后登出位置,包括服务器、世界和坐标 telehop.admin
/forcelastloc <player> tp 传送到玩家保存的最后登出位置 telehop.admin
/forcelastloc <player> clear 清除玩家保存的最后登出位置 telehop.admin

别名:

别名 命令
/forcell /forcelastloc

玩家信息

命令 描述 权限
/playerinfo <player> 显示玩家的 TeleHop 数据,包括家园、传送点、最后位置和当前所在服务器 telehop.admin

别名:

别名 命令
/pinfo /playerinfo

🔐 权限

在游戏中使用 /telehop perms 查看完整的权限列表。

玩家权限

权限 命令
telehop.spawn /spawn
telehop.rtp /rtp
telehop.tpa /tpa
telehop.tpahere /tpahere
telehop.tpa.accept /tpaaccept
telehop.tpa.deny /tpadeny
telehop.tpa.cancel /tpacancel
telehop.tpa.toggle /tpatoggle
telehop.warp /warp, /warps
telehop.pwarp /pwarp
telehop.homes /home
telehop.sethome /sethome
telehop.delhome /delhome
telehop.lastlocation /lastlocation
telehop.back /back
telehop.back.death /back death

家园数量权限

权限 效果
telehop.homes.1 1 个家园
telehop.homes.2 2 个家园
telehop.homes.3 3 个家园
telehop.homes.4 4 个家园
telehop.homes.5 5 个家园
telehop.homes.6 6 个家园
telehop.homes.7 7 个家园
telehop.homes.8 8 个家园
telehop.homes.9 9 个家园
telehop.homes.10 10 个家园

TeleHop 使用最高匹配的家园权限。

玩家传送点数量权限

权限 效果
telehop.warps.1 1 个玩家传送点
telehop.warps.3 3 个玩家传送点
telehop.warps.10 10 个玩家传送点
telehop.warps.100 100 个玩家传送点
telehop.warps.unlimited 无限玩家传送点

TeleHop 使用最高匹配的玩家传送点权限。

单个传送点访问权限

权限 效果
telehop.warp.<name> 访问特定的管理员传送点

示例:

telehop.warp.shop

绕过权限

权限 效果
telehop.rtp.bypasscooldown 跳过 RTP 冷却
telehop.rtp.bypassdelay 跳过 RTP 预热
telehop.tpa.bypasscooldown 跳过 TPA 冷却

管理员权限

权限 效果
telehop.admin 主要管理工具、传送点管理、家园管理、最后位置工具、玩家信息、重载及权限列表
telehop.tp 管理员 /tp 命令
telehop.tphere 管理员 /tphere 命令
telehop.back 使用 /back
telehop.back.death 使用 /back death
telehop.warps.unlimited 无限玩家传送点

LuckPerms 示例

# 默认等级
lp group default permission set telehop.warps.3 true
lp group default permission set telehop.homes.2 true
lp group default permission set telehop.lastlocation true

# VIP 等级
lp group vip permission set telehop.warps.10 true
lp group vip permission set telehop.homes.5 true

# MVP 等级
lp group mvp permission set telehop.warps.unlimited true
lp group mvp permission set telehop.homes.10 true

# 工作人员等级
lp group staff permission set telehop.admin true
lp group staff permission set telehop.tp true
lp group staff permission set telehop.tphere true
lp group staff permission set telehop.back true
lp group staff permission set telehop.back.death true
lp group staff permission set telehop.warps.unlimited true
lp group staff permission set telehop.homes.10 true

⚡ 亮点

  • 专为 Velocity 网络构建
  • 支持 Paper 后端服务器
  • 支持 Paper 1.21.x 和 26.1.x
  • 运行时版本适配器
  • 基于 MySQL 的共享存储
  • 支持 MariaDB
  • 可选 Redis 支持以用于多代理网络
  • 区域感知的枢纽路由
  • 命名家园
  • 玩家传送点
  • 管理员传送点
  • 跨服务器 TPA
  • 跨服务器 /back
  • 持久化的最后登出位置
  • 随机重生
  • RTP GUI
  • 模块化配置
  • 自动配置迁移
  • 自动数据库迁移
  • 传送特效
  • 多语言支持
  • LuckPerms 支持
  • 全网络标签页补全
  • 基于权限的管理员建议
  • 游戏内帮助
  • 游戏内权限列表

🧩 多服务器支持

TeleHop 专为 Velocity 网络设计。

Paper 负责执行传送操作。

Velocity 负责路由和玩家追踪。

MySQL 存储共享的网络数据。

当启用多代理模式时,Redis 可以同步多个 Velocity 代理。TeleHop 支持与 Redis 的 TLS 连接,包括证书和主机名验证。

这实现了:

  • 跨服务器 TPA
  • 跨服务器家园
  • 跨服务器传送点
  • 跨服务器管理员传送
  • 跨服务器 /back
  • 跨服务器最后位置传送
  • 共享玩家追踪
  • 共享玩家传送点数据
  • 共享 TPA 请求
  • 多代理玩家列表
  • 区域感知的出生点路由

需要同时安装 Velocity 插件和 Paper 插件。


📥 要求

软件 版本
Paper 1.21.x 或 26.1.x
Velocity 3.3+
Java Paper 1.21.x 需 21+,Paper 26.1.x 需 25+
MySQL 8.0+
MariaDB 10.5+
LuckPerms 5.4+(可选)
Redis 可选,用于多代理模式

⚙️ 设置

  1. 创建 MySQL 数据库和用户。
  2. 将 telehop-velocity-2.2.0.jar 放入你的 Velocity 插件文件夹。
  3. 将 telehop-paper-2.2.0.jar 放入每个 Paper 服务器的插件文件夹。
  4. 启动 Velocity 和 Paper 服务器以生成配置文件。
  5. 停止服务器。
  6. 在 plugins/TeleHop/config/database.yml 中配置 MySQL 凭据。
  7. 在 plugins/TeleHop/config/general.yml 中设置每个 Paper 服务器的 server-name。
  8. 设置大厅服务器。
  9. 首先启动 Velocity。
  10. 启动所有后端 Paper 服务器。

数据库表将在首次启动时自动创建。


🔄 更新

从 1.0.0 或 1.0.2 更新

  • 替换旧的 Paper 和 Velocity JAR 文件。
  • 正常启动网络。
  • 家园将从基于槽位的家园自动迁移至命名家园。
  • 新配置文件会自动添加。
  • 现有配置文件不会被覆盖。
  • 旧的 config.yml 会在需要时迁移到分离的配置文件布局中。
  • 旧的 config.yml 会被重命名为 config.yml.old。
  • 如果权限组需要多个家园,请添加新的家园权限。

从 2.1.0 更新

  • 备份并将 Paper 和 Velocity JAR 替换为对应的 2.2.0 构建版本。
  • 向现有的语言文件中添加 countdown-title,包括英文,如上所示。
  • 保留配置、存储和数据库。无需进行架构迁移。
  • 保留现有的预热持续时间、show-countdown 设置和绕过权限,或根据你的网络需求进行调整。

从 2.0.0 更新

  • 同时更新 Paper 和 Velocity JAR 文件。
  • 如果你使用自定义配置文件,请在 config/rtp.yml 中添加 rtp.gui.ping 部分。
  • 向现有的语言文件(包括英文)中添加 rtp-in-progress 和 countdown-title。
  • 无需进行数据库迁移。

家园迁移

旧家园会在启动期间转换为命名家园。

示例:

  • 槽位 1 变为 Home 1
  • 槽位 2 变为 Home 2
  • 槽位 3 变为 Home 3

无需手动更改 SQL。


📁 Paper 配置布局

plugins/TeleHop/
  config/
    general.yml
    database.yml
    features.yml
    teleport.yml
    tpa.yml
    rtp.yml
    home.yml
    respawn.yml
    WIKI.md
  storage.yml
  languages/
    en.yml
    nl.yml
    de.yml
    es.yml
    zh.yml
    pl.yml

配置文件

文件 用途
general.yml 服务器名称、大厅服务器、服务器列表、语言、消息传递和区域
database.yml MySQL 连接设置
features.yml 功能开关
teleport.yml 每种传送类型的粒子效果和音效
tpa.yml 超时、冷却时间、预热和移动取消
rtp.yml 随机传送区域、维度、冷却时间、预热、GUI 和延迟检测
home.yml 家园、GUI 行数、床颜色、屏蔽服务器和标签
respawn.yml 随机重生行为
WIKI.md 生成的配置参考
storage.yml 运行时数据,例如出生点位置
languages/ 语言文件

大多数设置可以通过 /telehop reload 实时重载。

MySQL 连接设置需要完全重启服务器。


🌐 Velocity 配置

Velocity 使用 config.properties。

主要设置包括:

  • MySQL 主机
  • MySQL 端口
  • MySQL 数据库
  • MySQL 用户名
  • MySQL 密码
  • MySQL 连接池大小
  • 消息去重窗口
  • 请求超时
  • 大厅服务器
  • 后端服务器列表
  • 代理 ID
  • 多代理切换
  • Redis 主机
  • Redis 端口
  • Redis 密码
  • Redis 频道前缀
  • Redis TLS 切换
  • Redis 证书和主机名验证
  • 可选的 Redis CA 证书路径

🗄 数据库表

TeleHop 会自动创建和更新数据库表。

表 用途
players 跟踪每个玩家当前所在的服务器
warps 存储管理员传送点
player_warps 存储玩家传送点
tpa_requests 存储活跃的 TPA 请求
homes 存储命名的玩家家园
last_locations 存储持久化的登出位置

💬 语言

TeleHop 内置了 6 种语言。

  • English(英语)
  • Dutch(荷兰语)
  • German(德语)
  • Spanish(西班牙语)
  • Chinese(中文)
  • Polish(波兰语)

当所选语言中缺少消息键时,TeleHop 会检查磁盘上的英文文件。新增的捆绑键不会自动合并到现有文件中,因此在更新时,请将新键添加到英文文件以及任何自定义翻译中。

消息支持 MiniMessage 格式化和占位符。


🧪 从源代码构建

mvn clean package

构建输出:

paper/target/telehop-paper-2.2.0.jar
velocity/target/telehop-velocity-2.2.0.jar

需要 Java 21+ 和 Maven 3.8+。

Paper 26.1.x 适配器模块通过 Maven toolchains 使用 Java 25 进行编译。


⚠ 兼容性

支持:

  • Paper
  • Velocity
  • MySQL
  • MariaDB
  • LuckPerms
  • Redis(用于多代理模式)

不支持:

  • BungeeCord
  • 混合服务器架构
  • 仅限单服务器的配置(不支持 Velocity)

👤 作者与公司

由 Epildev 开发。

公司:Epildevconnect Ltd 公司注册号:17247566 注册地:英格兰和威尔士 官网: GitHub: Discord:Epildev


📄 许可证

TeleHop 采用 MIT 许可证并附加额外条款。

必须对 Epildevconnect Ltd 进行署名。

完整详情请参阅 GitHub 上的许可证文件。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源