Spvelocity — 一个 Paper / Spigot 插件,用于下载并启动 Velocity 代理
它是什么?
Spvelocity 是一个 Paper / Spigot 插件,可自动执行以下操作:
- 从指定 URL 下载 Velocity jar 文件
- 在独立进程中启动 Velocity
- 允许你通过游戏内指令或控制台使用
/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)
- 从 Releases 页面下载
spvelocity-<version>-shaded.jar - 将其放入
<server>/plugins目录 - 使用 Java 17 / 21 等版本启动你的 Paper / Spigot 服务器
- 在游戏内或控制台中运行:
→/proxy startvelocity.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 |
工作原理
SpvelocityManager检查plugins/Spvelocity/proxy/velocity.jar是否存在- 如果不存在,则通过 Apache Commons IO 从配置的 URL 下载该文件
- 使用 ProcessBuilder 运行
java -jar velocity.jar --port <port> - 将代理输出重定向到 Paper 控制台
- 当 Paper 服务器关闭时,子进程会通过
destroy()被销毁
许可证
MIT License — 详情请参阅 LICENSE 文件。
欢迎 Fork、修改和重新分发!
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
可自定义玩家模型
tom5454
自定义你的Minecraft头像!
装饰社交
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧