Velocity 4.0.0-SNAPSHOT Proxy Download

Version facts

What changed

Newest upstream commits:

• #5 · 11 Jul 2026 Bump netty to 4.2.16.Final 4bd30ba
• #4 · 11 Jul 2026 Small optimization to prevent blocking netty threads on UUID.randomUUID() (#1781) 28c9f5a
• Set TitleActionbarPacket's default action to SET_ACTION_BAR (#1802) da7427f
• #3 · 11 Jul 2026 Setup encryption before possible disconnect (#1754) b8d1f16
• Fix build-time GraalVmProcessor warning (#1801) 729a050
• Strip pre-java-9 version check in `Metrics` as Velocity targets 21+ (#1836) c690b4a
• Use `SecureRandom` to generate verification/anti-MITM token (#1797) 5cc6b0b
• Use correct max tab complete lengths for < 1.13, = 1.13 and > 1.13 (#1796) 757711a
• #2 · 11 Jul 2026 Update jline to 4.3.1 95694cb
• [ci skip] Bump API source & docs link to java 25 7cb01b8
• #1 · 11 Jul 2026 bump version to 4.0.0-SNAPSHOT 0942e16
• Toolchain and gradle bump (Java 25+) c1cd71a

Compatibility

Runs Velocity plugins (not Bukkit or BungeeCord plugins).

Known issues & safety notes

• Known issues: search Velocity's issue tracker for 4.0.0-SNAPSHOT

How to set up Velocity 4.0.0-SNAPSHOT

1. Install Java 25 or newer (e.g. Eclipse Temurin) and check it with java -version.
2. Download the Velocity jar and start it with the script below — a proxy has no Mojang EULA and is not tied to one Minecraft version.
3. It listens on port 25565 by default (bind in velocity.toml). Players connect to the proxy; your backend servers run on other ports (or machines) and must not be reachable directly.
4. Use modern forwarding: in velocity.toml set player-info-forwarding-mode = "modern"; the secret is in forwarding.secret. On each Paper backend set online-mode=false in server.properties, and in config/paper-global.yml set proxies.velocity.enabled: true, proxies.velocity.secret to the same secret and proxies.velocity.online-mode to match Velocity (Paper 1.18.2 and older: settings.velocity-support in paper.yml).
5. Register your backend servers in the proxy config and restart.

#!/bin/sh
# start.sh — Velocity 4.0.0-SNAPSHOT
cd "$(dirname "$0")"
JAVA_MAJOR=$(java -version 2>&1 | awk -F'"' '/version/ {split($2, v, "."); print (v[1] == "1") ? v[2] : v[1]}')
if [ "$JAVA_MAJOR" -lt 25 ] 2>/dev/null; then
  echo "Java 25 or newer is required (found Java $JAVA_MAJOR)."
  exit 1
fi
java -Xms512M -Xmx1G -XX:+UseG1GC -XX:G1HeapRegionSize=4M -XX:+UnlockExperimentalVMOptions -XX:+ParallelRefProcEnabled -XX:+AlwaysPreTouch -XX:MaxInlineLevel=15 -jar velocity-4.0.0-SNAPSHOT-5.jar

@echo off
REM start.bat — Velocity 4.0.0-SNAPSHOT
REM Needs Java 25 or newer: run "java -version" to check.
java -Xms512M -Xmx1G -XX:+UseG1GC -XX:G1HeapRegionSize=4M -XX:+UnlockExperimentalVMOptions -XX:+ParallelRefProcEnabled -XX:+AlwaysPreTouch -XX:MaxInlineLevel=15 -jar velocity-4.0.0-SNAPSHOT-5.jar
pause

The JVM flags are the ones Velocity's documentation recommends. Customise RAM, flags and restart loop →

A proxy needs little memory: 512 MB–1 GB is plenty for most networks. How much RAM?

Docker

docker run -d -p 25565:25565 -e TYPE=VELOCITY --name proxy itzg/mc-proxy

Uses the community itzg/mc-proxy image, which downloads the file itself.

Upgrading

• Newer: Velocity 4.0.0
• Previous: Velocity 3.6.0-SNAPSHOT
• How to update a Minecraft server safely