Proxied Warp

插件

· 作者 mrcl-at

Proxied Warp 允许玩家通过触发现有的传送插件来跨服务器进行瞬移。

0 本站下载 0 关注 更新于 3 个月前

最新 1.3.0-velocity · 26.2 · Velocity

一键开服(送7天)

Proxied Warp

GitHub - Hangar - Modrinth - SpigotMC - Discord

Proxied Warp 允许玩家通过触发目标服务器上已有的传送插件(例如 Essentials 或类似插件),在 Velocity 网络中的服务器之间进行跨服传送。玩家无需手动切换服务器——Proxied Warp 会自动将其连接到目标服务器,并在该服务器上执行传送指令。

该项目由三个部分组成:

模块 功能
velocity 在后端服务器之间转发传送请求,并在需要时将玩家连接到目标服务器
paper 接收玩家的 /proxiedwarp 指令,并在连接成功后执行实际的传送指令。适用于 Paper 后端服务器。支持 MiniMessage 格式的消息样式
spigot 与 paper 模块功能相同,但适用于 Spigot 后端服务器。消息使用传统的 Minecraft 颜色代码(&)而非 MiniMessage

工作原理

代理服务器与后端服务器之间的通信通过共享的 Plugin Messaging Channel(插件消息通道)完成:proxied_warp:proxied_warp。

工作流程如下:

  1. 玩家执行指令 – 在后端服务器上,玩家调用已注册的指令,指定目标服务器和传送点名称(例如 /proxiedwarp lobby spawn)。
  2. 后端插件发送消息 – 插件(根据服务器类型选择 paper 或 spigot 模块)首先检查输入内容和权限,然后构建消息 <player> <server> <warp>,并通过通道以插件消息的形式发送给代理服务器。
  3. Velocity 插件处理请求:
    • 检查指定的玩家和目标服务器是否存在。
    • 如果玩家已经在目标服务器上,则直接转发消息。
    • 否则,先建立到目标服务器的连接,待服务器切换成功后再转发消息。
  4. 目标服务器执行传送 – 目标服务器上的插件接收转发的消息,检查玩家是否在该服务器上在线,并使用给定的传送点名称执行配置的传送指令。

安装

  1. 将 Velocity 模块 作为 .jar 文件放入 Velocity 代理服务器的 plugins 文件夹中。
  2. 在玩家应能触发或接收传送的每个后端服务器上安装相应的后端模块:在 Paper 服务器上安装 paper 模块,在 Spigot 服务器上安装 spigot 模块。
  3. 重启代理服务器和相关后端服务器。

配置(Paper/Spigot 模块)

首次启动时,相应插件会生成一个包含以下默认值的 config.yml:

paper 模块:

command-prefix: warp
need-permission: false
whitelisted-servers: []
whitelisted-warps: []
aliases:
  spawn: lobby
message:
  usage: '<red>Usage:</red> /proxiedwarp <server> <warp>'
  permission: '<red>You do not have permission to do that!</red>'
  server-not-whitelisted: '<red>This server is not whitelisted!</red>'
  warp-not-whitelisted: '<red>This warp is not whitelisted!</red>'

spigot 模块:

command-prefix: warp
need-permission: false
whitelisted-servers: []
whitelisted-warps: []
aliases:
  spawn: lobby
message:
  usage: '&cUsage:&r /proxiedwarp <server> <warp>'
  permission: '&cYou do not have permission to do that!'
  server-not-whitelisted: '&cThis server is not whitelisted!'
  warp-not-whitelisted: '&cThis warp is not whitelisted!'
键 描述
command-prefix 在目标服务器上执行的命令,用于实际将玩家传送至 warp 点(例如已安装的 warp 插件的命令)。
need-permission 决定玩家是否需要显式权限才能对特定服务器使用 /proxiedwarp(参见 Permissions)。
whitelisted-servers 允许作为目标的服务器列表。如果为空,则允许所有服务器。
whitelisted-warps 允许触发的 warp 列表。如果为空,则允许所有 warp。
aliases 定义 warp 别名的部分,将简单名称映射到目标服务器(例如 spawn: lobby)。
message.usage 命令使用不正确时显示的消息。
message.permission 缺少权限时显示的消息。
message.server-not-whitelisted 服务器未列入白名单时显示的消息。
message.warp-not-whitelisted warp 未列入白名单时显示的消息。

在 paper 模块中,消息支持 MiniMessage 格式(例如 <red>、<bold>)。在 spigot 模块中,消息改用带有 & 作为格式化字符的旧版 Minecraft 颜色代码(例如 &c 表示红色),因为那里不可用 MiniMessage。

命令

后端服务器(Paper 或 Spigot)上提供以下命令:

/proxiedwarp <server> <warp>
/proxiedwarp <alias>
  • <server> – 目标服务器的名称,如 Velocity 配置(velocity.toml)中所注册的那样。
  • <warp> – 目标服务器上 warp 点的名称。
  • <alias> – 在 config.yml 中定义的别名,映射到特定的服务器和 warp。

该命令只能由玩家执行(不能从控制台执行)。

权限

如果在 config.yml 中将 need-permission 设置为 true,玩家需要拥有以下权限之一才能执行 /proxiedwarp <server> <warp>:

权限 效果
proxiedwarp.warp.* 允许传送到所有服务器。
proxiedwarp.warp.<warp> 允许传送到特定 warp(例如 proxiedwarp.warp.spawn)。

如果两者都缺失,玩家将收到在 message.permission 中配置的错误消息,并且请求不会发送到代理。

如果 need-permission 设置为 false(默认值),则不执行权限检查,每个玩家都可以为每个注册的服务器使用该命令。

要求

  • Velocity 代理。
  • 基于 Paper 的后端服务器(带 paper 模块)或基于 Spigot 的后端服务器(带 spigot 模块)。
  • 每个涉及的后端服务器上都有一个可通过命令触发(而非通过 API)且其命令可输入到 command-prefix 中的 warp 插件。
  • Java 版本 25 或更高版本。

已知限制

  • Proxied Warp 本身不检查指定的 warp 是否实际存在——这仅由目标服务器上调用的 warp 插件进行检查。

Proxied Warp 允许玩家在 Velocity 网络内的服务器之间传送,通过在目标服务器上触发现有的 warp 插件(例如 Essentials 或类似插件)来实现。玩家无需手动切换服务器——Proxied Warp 会自动将他们连接到目标服务器,然后在那里执行 warp 命令。

该项目由三部分组成:

模块 任务
velocity 在后端服务器之间转发 warp 请求,并在需要时将玩家连接到目标服务器
paper 接收来自玩家的 /proxiedwarp 命令,并在服务器连接后执行实际的 warp 命令。适用于 Paper 后端服务器。支持消息的 MiniMessage 格式
spigot 与 paper 模块功能相同,但适用于 Spigot 后端服务器。消息使用旧版 Minecraft 颜色代码(&)而不是 MiniMessage

工作原理

代理与后端服务器之间的通信通过共享的 Plugin Messaging Channel 进行:proxied_warp:proxied_warp。

工作流程如下:

  1. 玩家执行命令 – 在后端服务器上,玩家调用已注册的命令,指定目标服务器和传送点名称(例如 /proxiedwarp lobby spawn)。
  2. 后端插件发送消息 – 插件(根据服务器类型选择 paper 或 spigot 模块)首先检查输入内容和权限,然后构建消息 <player> <server> <warp> 并通过通道作为插件消息发送给代理。
  3. Velocity 插件处理请求:
    • 检查指定的玩家和目标服务器是否存在。
    • 如果玩家已经在目标服务器上,则直接转发消息。
    • 否则,先建立与目标服务器的连接,仅在服务器切换成功后才转发消息。
  4. 目标服务器执行传送 – 目标服务器上的插件接收转发的消息,检查玩家是否在该服务器上在线,并使用给定的传送点名称执行配置的传送命令。

安装

  1. 将 Velocity 模块 作为 .jar 文件放入 Velocity 代理的 plugins 文件夹中。
  2. 在允许玩家触发或接收传送的每个后端服务器上安装相应的后端模块:Paper 服务器上安装 paper 模块,Spigot 服务器上安装 spigot 模块。
  3. 重启代理和相关后端服务器。

配置(Paper/Spigot 模块)

首次启动时,相应插件会生成一个包含以下默认值的 config.yml:

paper 模块:

command-prefix: warp
need-permission: false
whitelisted-servers: []
whitelisted-warps: []
aliases:
  spawn: lobby
message:
  usage: '<red>Usage:</red> /proxiedwarp <server> <warp>'
  permission: '<red>You do not have permission to do that!</red>'
  server-not-whitelisted: '<red>This server is not whitelisted!</red>'
  warp-not-whitelisted: '<red>This warp is not whitelisted!</red>'

spigot 模块:

command-prefix: warp
need-permission: false
whitelisted-servers: []
whitelisted-warps: []
aliases:
  spawn: lobby
message:
  usage: '&cUsage:&r /proxiedwarp <server> <warp>'
  permission: '&cYou do not have permission to do that!'
  server-not-whitelisted: '&cThis server is not whitelisted!'
  warp-not-whitelisted: '&cThis warp is not whitelisted!'
键值 描述
command-prefix 在目标服务器上执行的命令,用于实际将玩家传送到传送点(例如,已安装的传送插件的命令)。
need-permission 决定玩家是否需要显式权限才能在特定服务器上执行 /proxiedwarp(参见 Permissions)。
whitelisted-servers 允许用作目标的服务器列表。如果为空,则允许所有服务器。
whitelisted-warps 允许触发的传送点列表。如果为空,则允许所有传送点。
aliases 定义传送点别名的部分,将简单名称映射到目标服务器(例如 spawn: lobby)。
message.usage 当命令使用不正确时显示的消息。
message.permission 当缺少权限时显示的消息。
message.server-not-whitelisted 当服务器未被列入白名单时显示的消息。
message.warp-not-whitelisted 当传送点未被列入白名单时显示的消息。

在 paper 模块 中,消息支持 MiniMessage 格式(例如 <red>、<bold>)。而在 spigot 模块 中,由于 MiniMessage 不可用,消息使用传统的 Minecraft 颜色代码,以 & 作为格式化字符(例如 &c 表示红色)。

命令

以下命令在后端服务器(Paper 或 Spigot)上可用:

/proxiedwarp <server> <warp>
/proxiedwarp <alias>
  • <server> – 目标服务器的名称,已在 Velocity 配置(velocity.toml)中注册。
  • <warp> – 目标服务器上传送点的名称。
  • <alias> – 在 config.yml 中定义的别名,映射到特定的服务器和传送点。

该命令只能由玩家执行(不能从控制台执行)。

权限

如果在 config.yml 中将 need-permission 设置为 true,则玩家需要具备以下任一权限才能执行 /proxiedwarp <server> <warp>:

权限 效果
proxiedwarp.warp.* 允许传送到所有服务器。
proxiedwarp.warp.<warp> 允许传送到特定传送点(例如 proxiedwarp.warp.spawn)。

如果缺少这两项权限,玩家将收到在 message.permission 中配置的错误消息,且请求不会发送到代理。

如果 need-permission 设置为 false(默认值),则不会执行权限检查,每个玩家都可以为所有已注册的服务器使用该命令。

要求

  • 一个 Velocity 代理服务器。
  • 一个基于 Paper 的后端服务器(使用 paper 模块)或一个基于 Spigot 的后端服务器(使用 spigot 模块)。
  • 每个涉及的后端服务器上都有一个可以通过命令触发的传送插件(不能通过 API 触发),且其命令可以填入 command-prefix 中。
  • Java 25 或更高版本。

已知限制

  • Proxied Warp 本身不会检查指定的传送点是否实际存在——这仅由目标服务器上被调用的传送插件进行检查。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源