spvelocity

插件

· 作者 nehatsu.

一个允许你将 Velocity 作为 Spigot 插件使用的插件

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

最新 1.0 · 1.21.5 · Paper / Spigot

一键开服(送7天)

Spvelocity — 一个 Paper / Spigot 插件,用于下载并启动 Velocity 代理


它是什么?

Spvelocity 是一个 Paper / Spigot 插件,可自动执行以下操作:

  1. 从指定 URL 下载 Velocity jar 文件
  2. 在独立进程中启动 Velocity
  3. 允许你通过游戏内指令或控制台使用 /proxy start|stop|status 来控制它

非常适合快速网络测试、CI 流水线或临时测试服务器。


功能特性

  • 自动下载 velocity.jar,仅在首次执行 /proxy start 时触发
  • 兼容 Paper / Spigot 1.12 – 最新版本(基于 1.21.4 API 构建)
  • 仅需 Java 11 及以上版本,推荐使用 Java 17 或 21
  • 在后台线程中运行——不会阻塞主服务器线程
  • 当 Paper 服务器停止时,自动停止 Velocity
  • 通过 plugins/Spvelocity/config.yml 进行简单配置

环境要求

  • 一个 Paper 或 Spigot 服务器
    (支持 1.12 – 最新版本,基于 Paper-1.21.4 构建)
  • Java 11 或更高版本(Velocity 本身需要 11+)
  • 首次运行 /proxy start 时需要联网(以便下载 Velocity)

快速开始(预构建 jar)

  1. 从 Releases 页面下载 spvelocity-<version>-shaded.jar
  2. 将其放入 <server>/plugins 目录
  3. 使用 Java 17 / 21 等版本启动你的 Paper / Spigot 服务器
  4. 在游戏内或控制台中运行:
    /proxy start
    
    → velocity.jar 将被下载到 plugins/Spvelocity/proxy/ 目录,并在端口 25577 上启动

从源码构建

git clone https://github.com/<YOUR-USER>/spvelocity.git
cd spvelocity
mvn clean package    # 生成 target/spvelocity-*-shaded.jar

配置 — config.yml

velocity:
  download-url: "https://api.papermc.io/v2/projects/velocity/versions/3.3.0-SNAPSHOT/builds/261/downloads/velocity-3.3.0-SNAPSHOT-261.jar"
  jar-name: "velocity.jar"
  port: 25577
  • 从 PaperMC 的下载页面复制下载链接:
  • 稳定版本(如 3.2.0 等)的 URL 保持不变。
  • 对于 SNAPSHOT 版本,你可能需要一个脚本来查询 API 获取最新构建版,或者手动更新 URL。

指令与权限

指令 描述 权限 默认值
/proxy start 下载并启动 Velocity spvelocity.command OP
/proxy stop 停止正在运行的 Velocity 实例 spvelocity.command OP
/proxy status 显示代理状态 spvelocity.command OP

工作原理

  1. SpvelocityManager 检查 plugins/Spvelocity/proxy/velocity.jar 是否存在
  2. 如果不存在,则通过 Apache Commons IO 从配置的 URL 下载该文件
  3. 使用 ProcessBuilder 运行 java -jar velocity.jar --port <port>
  4. 将代理输出重定向到 Paper 控制台
  5. 当 Paper 服务器关闭时,子进程会通过 destroy() 被销毁

许可证

MIT License — 详情请参阅 LICENSE 文件。
欢迎 Fork、修改和重新分发!

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源