English
Hot plugin management, custom resource pack delivery and hosting, entry-domain diagnostics, and server version rules for Velocity.
中文 · Wiki · Releases · Hangar · Modrinth
Requires Velocity 4.0+ and Java 25+. Put the JAR in the proxy's plugins/ directory and start the proxy. Grant velocitytoolbox.admin and run /vtb help. The full command name is /vtoolbox.
Version rules, HTTP hosting and pack delivery default to disabled. Replace example files and server names before enabling them. Apply configuration changes with /vtb reload.
When updating, replace the JAR and restart the proxy. Existing configuration still works: add resource-packs when you want pack delivery; leaving it out keeps delivery disabled. If you made few language changes, back up and move the old language files, then run /vtb reload to generate fresh copies. Reapply any custom text using the new keys.
/vtb plugin list|inspect|load|unload|reload lists, inspects and manages proxy plugins, including cleanup reports. Required dependencies prevent unloading. Restart the proxy when updating permission, protocol or connection plugins.
resource-packs sets network-wide defaults and lets you choose packs by backend, client version and permission. pack-host serves local ZIPs, calculates hashes and limits downloads. Enable each module separately.
-
url: "@filename.zip"uses VTB hosting with an automatic URL and SHA-1. - External HTTP/HTTPS URLs download directly and require the actual hash.
-
url: "@"sends nothing and needs no hosting.
For hosted files, public-url is the client's download address prefix. An empty value selects a local network address. Public servers need a reachable IP/domain with port forwarding or a reverse proxy.
Clients on 1.20.3+ can stack packs. Older clients receive the first matching complete pack. A selected required pack disconnects on rejection, failure or timeout. Use /vtb pack list, status player and resend player to inspect or resend packs.
/vtb server hosts groups online players by their entry domain and shows ports and latency. Click an entry for player details.
server-versions restricts client versions per backend using min/max/allow/deny. It needs no ViaVersion and does not translate protocols.
/vtb info shows module status. /vtb reload reloads configuration and language without reloading other plugins.
Modules and permissions · Resource packs · 中文版本限制指南
Messages support Simplified Chinese, Traditional Chinese, English and custom MiniMessage language files. Set language to zh_tw for Traditional Chinese, or leave it empty to follow the system locale. Unsupported languages fall back to Simplified Chinese. bStats can be disabled in its configuration.