VelocityCommandForward

插件

· 作者 ItsTauTvyDas

将后端命令转发到代理!

0 本站下载 0 关注 更新于 4 天前

最新 1.2.0 · 26.3 · Paper

一键开服(送7天)

VelocityCommandForward

将命令从后端转发到代理!

✨ 功能

  • 自定义命令。
  • 自定义消息。
  • 可自定义静默发送的命令(不发送消息或控制台日志)。
  • 玩家和控制台均可执行代理命令(向代理发送数据包,以玩家或控制台身份执行)。
  • 可选加密。命令使用共享的 secret.key 进行加密和验证,防止伪造或重放。

📥 如何安装?/ 安装 / 设置

非常简单,下载 Velocity 和 Paper 插件并将其上传到相应的服务器(代理/后端)。

  1. 关闭你的代理(Velocity)和后端(Paper)服务器。
  2. 下载对应版本的 Velocity 和 Paper 插件。
  3. 将两个插件文件(针对你的服务器版本)放入 plugins 文件夹中。
  4. 启动服务器。
  5. 如果使用加密,请执行以下步骤。
    1. 从代理服务器的 plugins/velocity-command-forward/secret.key 复制到每个后端服务器的 plugins/VelocityCommandForward/ 目录中。
    2. 在每个后端服务器上运行 /proxyexec reload(或重启服务器)。

💡 注意事项

  • 加密由代理服务器单独控制,后端服务器会自动跟随配置。
  • 要禁用加密,请在代理配置中设置 use-crypto-protection: false 或将 secret.key 留空。
  • 服务器时间必须保持在彼此 30 秒以内,否则加密的命令将被拒绝。

❓ 此插件的用例是什么?

  • 我的用例比较小众:我有一个 Discord 命令可以运行 Minecraft 命令(如果玩家在线),但问题是 Discord 机器人运行在后端服务器上,因此我决定制作一个插件来运行代理命令,例如 /skin。
  • 另一个常见用例是当你在 Velocity 上安装 TAB 插件时,需要从后端服务器向代理服务器发送命令,例如 /btab scoreboard 以切换 TAB 记分板。虽然手动执行没问题,但如果你使用其他插件中的自定义物品绑定该命令,命令可能会执行失败。在这种情况下,仅依赖本插件的命令即可解决 TAB 命令无法工作的问题。

🕹️ 命令用法

命令名称可在后端插件配置中更改:

custom-command: proxyexec
命令 描述 权限
/proxyexec reload 用于重新加载插件配置。更改 custom-command 需要重启服务器。 velocitycommandforward.admin (op)
/proxyexec <command> 将命令转发到代理。示例:/proxyexec tab reload 将在代理上执行 /tab reload。 velocitycommandforward.send

在示例中我将命令改为了 proxy,我没有将其设为默认值,因为我担心其他插件可能已经使用了这个命令。

PixPin_2025-08-11_01-42-47

在控制台中执行

如果你在控制台中执行命令,你将不会得到任何输出,结果会显示在代理服务器的日志中。 必须至少有一名在线玩家才能向代理发送命令数据包(这是后端和代理之间插件消息通道的工作原理)。

后端服务器。

PixPin_2025-08-11_01-43-40

代理服务器。

PixPin_2025-08-11_01-44-22

📄 默认配置

后端 (Paper)

更改 custom-command 需要重启服务器。

# VelocityCommandForward

# 用于将命令转发到代理的命令。
# 你需要重启服务器才能使更改生效。
custom-command: proxyexec

# 在这里你可以指定根命令,这些命令不会发送日志和消息。
filtered-commands:
  - example_command

# {command} = 发送者发送的命令
# {sender} = 发送命令的玩家
# 如果设置为 '',则不发送消息。
messages:
  reload: '&a插件消息和过滤器已重新加载!'
  command-sent-as-player: '&2命令以玩家身份发送到代理 &7=> &a/{command}'
  command-sent-as-console: '&2命令以控制台身份发送到代理 &7=> &a/{command}'
  no-online-player: '&c必须至少有 1 名在线玩家才能执行代理控制台命令!'
  console-log: '[{sender}] 正在向代理发送命令数据包 => /{command}'
  velocity-log: '[{sender}] 收到代理命令数据包 => /{command}'
  secret-missing: '&c无法转发命令,代理要求加密。请检查服务器控制台!'

代理 (Velocity)

# 使用 secret.key(首次启动时创建)加密转发的命令。
# 将 secret.key 复制到每个后端服务器的 plugins/VelocityCommandForward/ 目录中。
use-crypto-protection: false

✅ 要求

  • Velocity 插件基于 Java 17 构建,Paper 插件基于 Java 21。
  • 兼容 1.20.6 及以上版本。由于插件使用 Brigadier(1.20.6 中添加)来构建命令,运行较低版本的服务器将会遇到错误。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源