Velocity-rcon

插件

· 作者 LiquidTeam

向 [Velocity] 添加一个 RCON(远程控制台)服务器,使用标准的 [RCON 协议]。通过任何标准 RCON 客户端连接并远程运行代理命令。

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

最新 1.0.0 · 26.2 · Velocity

一键开服(送7天)

英文

Velocity RCON

为 Velocity 代理添加一个 RCON(远程控制台)服务器,使用标准的 RCON 协议。通过任何标准 RCON 客户端(如 mcrcon、py3rcon……)连接并远程运行代理命令——这些命令将以 控制台级权限 执行。

适用于 Velocity 3.3.x、3.4.0、3.5.1 和 4.0.0。

功能特性

  • 标准 RCON 协议(小端数据包,兼容 mcrcon),包括与原版兼容的登录握手
  • 命令通过 Velocity 的 CommandManager 运行,具备 控制台级权限
  • 源 IP 白名单(支持精确 IP + IPv4 CIDR)
  • 连接限制与空闲超时
  • /vrcon 管理命令:重载配置、查看状态、启动 / 停止
  • 自动生成默认配置文件
  • 单个源码库通过 Maven profiles 构建出针对 3.3.x / 3.x / 4.0.0 的版本

版本支持

同一份源代码生成三个 jar 包。它们在功能上完全一致——RCON 协议处理、命令和配置完全相同。区别仅在于 它们运行的 Velocity 代理版本 以及 所需的 Java 版本:

Jar 文件 Velocity 代理 Java 构建命令
velocity-rcon.jar 4.0.0 25+ mvn clean package
velocity-rcon-3.x.jar 3.4.0 / 3.5.1 17+ mvn clean package -P velocity3
velocity-rcon-3.3.x.jar 3.3.x (3.3.0-SNAPSHOT) 17+ mvn clean package -P velocity33

关键点说明:

  • 兼容性:请选择与你的代理 Velocity 版本匹配的 jar 包。切勿在 3.x 代理上运行 4.0.0 的 jar 包,也不要在 4.0.0 代理上运行 3.x 的 jar 包——每个 jar 都是针对特定的 API 世代编译并与其兼容的。
  • 唯一的实质区别是 Java 要求。4.0.0 的 jar 包需要 Java 25+(Velocity 4.0.0 本身基于 Java 25 构建);而 3.x 的 jar 包可在 Java 17+ 上运行。
  • 3.3.x 从未由 Velocity 团队正式发布——它仅以 3.3.0-SNAPSHOT 形式存在。其 API 与 3.4.0/3.5.1 完全相同,因此 3.3.x 构建版可在此快照上运行。velocity33 profile 依赖于该快照制品,未来可能从仓库中清理。
  • 功能、配置、/vrcon 命令以及 RCON 协议行为在 所有三个 jar 包中均保持一致。

依赖要求

组件 版本
Velocity 3.3.x (SNAPSHOT)、3.4.0、3.5.1 或 4.0.0
Java 17+;4.0.0 需要 Java 25+(构建 JDK ≥ 25,例如 JDK 26)

安装步骤

  1. 将 velocity-rcon.jar(对于 3.x 版本请使用 velocity-rcon-3.x.jar)放入代理的 plugins/ 文件夹中。
  2. 重启代理。默认配置文件将在 plugins/velocity-rcon/config.yml 处创建。
  3. 编辑配置文件后重启,或运行 /vrcon reload 进行热重载。

配置 (plugins/velocity-rcon/config.yml)

enabled: true          # 是否启用 RCON 服务器
host: "0.0.0.0"        # 绑定地址
port: 25575            # 监听端口
password: "change_me"  # RCON 密码(必填)
allowed-ips: []        # 来源 IP 白名单;为空表示允许所有
max-clients: 3         # 最大并发连接数
response-delay-ms: 100 # 额外等待时间(毫秒),用于收集异步命令输出

使用方法

通过控制台管理(或使用 velocityrcon.admin 权限):

/vrcon reload   # 重载配置并重启 RCON 服务器
/vrcon status   # 显示运行状态、端口、连接数
/vrcon start    # 启动 RCON 服务器
/vrcon stop     # 停止 RCON 服务器

使用 mcrcon 连接:

mcrcon --host 127.0.0.1 --port 25575 --password change_me "list"
mcrcon --host 127.0.0.1 --port 25575 --password change_me   # 交互式控制台

安全注意事项

  • 切勿将 RCON 端口暴露给公共互联网——密码以明文传输,且命令拥有控制台级别的权限。
  • 绑定到 127.0.0.1,并通过 SSH 隧道进行远程管理。如果必须暴露,请设置 allowed-ips 并使用防火墙。
  • 更改默认密码。

从源码构建

# Velocity 4.0.0(默认)
mvn clean package
# Velocity 3.x 版本(3.4.0 / 3.5.1)
mvn clean package -P velocity3
# Velocity 3.3.x(3.3.0-SNAPSHOT)
mvn clean package -P velocity33

需要 JDK ≥ 25(例如 JDK 26)才能构建。输出文件为: target/velocity-rcon.jar、target/velocity-rcon-3.x.jar 或 target/velocity-rcon-3.3.x.jar (一次只能构建一个——它们会覆盖 target/ 目录)。

作者

LiquidTeam, YuHongChen — GitHub 仓库


中文

Velocity RCON

为 Velocity 代理端提供标准 RCON(远程控制台) 功能,基于 RCON 协议。配合任意标准 RCON 客户端(如 mcrcon、py3rcon 等)即可远程执行代理端命令,命令拥有控制台级权限。

支持 Velocity 3.3.x、3.4.0、3.5.1、4.0.0。

功能特性

  • 标准 RCON 协议(小端序数据包、兼容 mcrcon),包含与原版 Minecraft 兼容的登录握手
  • 命令通过 Velocity 的 CommandManager 执行,权限等同于代理端控制台
  • 来源 IP 白名单(精确 IP + IPv4 CIDR)
  • 连接数上限、空闲超时
  • /vrcon 管理命令:重载配置、查看状态、启停服务
  • 自动生成默认配置文件
  • 一份源码通过 Maven profile 同时支持 3.3.x / 3.x / 4.0.0 构建

版本支持

同一份源码可产出三个 jar,功能完全相同——RCON 协议处理、命令与配置完全一致,区别仅在所适配的 Velocity 代理端版本与所需的 Java 版本:

jar 适配 Velocity Java 构建命令
velocity-rcon.jar 4.0.0 25+ mvn clean package
velocity-rcon-3.x.jar 3.4.0 / 3.5.1 17+ mvn clean package -P velocity3
velocity-rcon-3.3.x.jar 3.3.x(3.3.0-SNAPSHOT) 17+ mvn clean package -P velocity33

要点:

  • 支持范围:根据代理端的 Velocity 版本选择对应的 jar。不要将 4.0.0 的 jar 放入 3.x 代理端,也不要把 3.x 的 jar 放入 4.0.0 代理端——每个 jar 都是针对对应一代 API 编译的。
  • 真正的区别仅在于 Java 版本要求:4.0.0 jar 需要 Java 25+(Velocity 4.0.0 本身即为 Java 25 构建);3.x jar 运行在 Java 17+。
  • 3.3.x 从未由 Velocity 官方正式发布,仅有 3.3.0-SNAPSHOT 快照版本;其 API 与 3.4.0/3.5.1 相同,因此 3.3.x 构建可用于该快照。velocity33 profile 依赖快照构件,日后仓库清理快照后可能失效。
  • 功能、配置、/vrcon 命令以及 RCON 协议行为在三个 jar 中完全一致。

环境要求

组件 版本
Velocity 3.3.x(SNAPSHOT)、3.4.0、3.5.1 或 4.0.0
Java 17+;4.0.0 需要 Java 25+(构建 JDK ≥ 25,如 JDK 26)

安装

  1. 将 velocity-rcon.jar(3.x 用 velocity-rcon-3.x.jar)放入代理端 plugins/ 目录。
  2. 重启代理端,自动生成默认配置 plugins/velocity-rcon/config.yml。
  3. 编辑配置后重启,或在代理端执行 /vrcon reload 热重载。

配置(plugins/velocity-rcon/config.yml)

enabled: true          # 是否启用 RCON
host: "0.0.0.0"        # 监听地址
port: 25575            # 监听端口
password: "change_me"  # RCON 密码(必填)
allowed-ips: []        # 来源 IP 白名单,空=全部放行
max-clients: 3         # 最大同时连接数
response-delay-ms: 100 # 额外等待毫秒数,用于收集异步命令输出

使用方法

控制台(或拥有 velocityrcon.admin 权限者)执行:

/vrcon reload   # 重新读取配置并重启 RCON 服务
/vrcon status   # 查看运行状态、端口、当前连接数
/vrcon start    # 启动 RCON 服务
/vrcon stop     # 停止 RCON 服务

mcrcon 连接示例:

mcrcon --host 127.0.0.1 --port 25575 --password change_me "list"
mcrcon --host 127.0.0.1 --port 25575 --password change_me   # 交互式控制台

安全注意事项

  • 不要把 RCON 端口暴露到公网——密码明文传输,且命令拥有控制台级权限。
  • 建议 host 填 127.0.0.1,通过 SSH 隧道远程管理;如必须对外,请设置 allowed-ips 并配合防火墙。
  • 请务必修改默认密码。

从源码构建

# Velocity 4.0.0(默认)
mvn clean package
# Velocity 3.x 正式版(3.4.0 / 3.5.1)
mvn clean package -P velocity3
# Velocity 3.3.x(3.3.0-SNAPSHOT)
mvn clean package -P velocity33

构建需要 JDK ≥ 25(如 JDK 26)。产物:target/velocity-rcon.jar、target/velocity-rcon-3.x.jar 或 target/velocity-rcon-3.3.x.jar(一次构建一个,会互相覆盖 target/)。

作者

LiquidTeam、YuHongChen —— GitHub 仓库

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源