Velocity 运维工具箱:插件热管理、自定义资源包下发与托管、入口域名排查、子服客户端版本限制。
资源包托管与下发分开开关;@文件.zip 自动计算哈希。可用 /vtb pack check 检查配置、用 status 查看匹配原因,并用 resend all 分批重发。自托管带请求与下载限流。
将 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 留空跟随系统语言,无对应翻译时回退中文。





