Skip to content

About

Velocity 4.0+ 工具箱:插件热管理、自定义资源包下发与托管、入口域名排查、子服客户端版本限制。

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Latest commit

 

History

41 Commits

Folders and files

Repository files navigation

VelocityToolBox

VelocityToolBox

Velocity 运维工具箱:插件热管理、自定义资源包下发与托管、入口域名排查、子服客户端版本限制。

资源包托管与下发分开开关;@文件.zip 自动计算哈希。可用 /vtb pack check 检查配置、用 status 查看匹配原因,并用 resend all 分批重发。自托管带请求与下载限流。

English · Wiki 使用文档 · 问题与建议

下载与发布平台

GitHub Releases Hangar Modrinth MineBBS 苦力怕论坛

安装

将 JAR 放入代理的 plugins/ 后完整启动一次,生成 config.yml。当前构建目标为 Velocity 4 与 Java 25。 管理员权限为 velocitytoolbox.admin,入口为 /vtb help,也可使用 /vtoolbox。

子服版本限制、HTTP 托管和资源包下发默认关闭。配置中提供完整样例,启用前替换文件及子服名,删除不用的样例。修改后执行 /vtb reload。

更新时替换 JAR 后完整重启代理。旧配置可以继续使用,想用资源包下发再补上 resource-packs,不加这段也不会启用下发。语言文件改动不多的话,建议备份后移走旧文件,再执行 /vtb reload 重新生成;自定义文案可按新键名补回。

模块

插件管理

/vtb plugin list|inspect|load|unload|reload 查看、检查或热管理代理插件,并报告清理结果。仍被其它插件硬依赖的插件不能卸载。权限、协议及连接管理插件建议重启代理更新。

插件加载

插件卸载与清理结果

自定义资源包下发与托管

resource-packs 可设置全服默认资源包,再按子服、客户端版本和权限分配。pack-host 提供 ZIP 下载、自动哈希和访问保护。两者独立开关,可以配合使用。

  • url: "@文件.zip":从托管目录取文件,自动生成链接和 SHA-1。
  • 外部 HTTP/HTTPS 直链:客户端从该地址下载,须填写真实 hash。
  • url: "@":不下发,无需文件或托管。
  • servers.<子服>.keep-existing: true 配合 packs: []:切服后保留已下发资源包,在该子服不发起新请求(1.3.6+)。

自托管的 public-url 是玩家下载地址前缀。留空自动选本机局域网地址;公网服请填可访问的 IP 或域名,自行配置端口映射或反代。

pack-host 是带限流的公开 HTTP 下载:知道完整 URL 的人都可以下载。查询参数里的票据只用来关联过载重试,不是登录或鉴权。

1.20.3+ 支持多包叠加;旧客户端只接收首个匹配的完整包。已选中的必需包被拒绝、失败或超时会断开玩家。 用 /vtb pack list、status 玩家、resend 玩家|all 查看或重新下发。/vtb pack check 只检查配置,不应用改动。

客户端资源包下载提示

子服与入口

/vtb server hosts 按加入域名分组显示在线玩家、端口和延迟,点击展开玩家详情。

按入口域名分组查看玩家

server-versions 按子服限制客户端的版本范围、允许列表和排除列表;无需 ViaVersion,但不提供协议转换。

子服客户端版本限制

状态与文档

/vtb info 按模块展示运行状态;/vtb reload 重载配置、语言、版本规则和资源包,不重载其它插件。

模块、命令和权限 · 资源包原理与配置 · 子服版本限制

界面支持简体中文、繁体中文、英文和自定义语言文件,玩家消息使用 MiniMessage。language 留空跟随系统语言,无对应翻译时回退中文。

问题与建议 · 维护文档

bStats

About

Velocity 4.0+ 工具箱:插件热管理、自定义资源包下发与托管、入口域名排查、子服客户端版本限制。

Topics

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages