NeoForged Velocity Support
by Swedz
NeoForged Velocity Support lets a NeoForge server accept connections forwarded by a Velocity proxy through Velocity's Modern Forwarding.
What it does
Velocity's Modern Forwarding passes each player's identity from the proxy to the backend server, and this mod adds that support to NeoForge. Its implementation aims for the same behavior as Paper's modern forwarding, and the code is kept simple to ease compatibility with other mods. The mod is server-side only, so players join without installing anything, and it is released under the MIT License as open source.
Setting it up takes a few steps. Install the mod on the NeoForge server, then copy the proxy's forwarding.secret file into the server's directory. Set online-mode=false in server.properties so the server accepts forwarded identities, and launch the server. Files cover the game versions 1.21.1 – 26.1.2, and the latest NeoForge file is 1.0.0-26.1.2 for 26.1.2.
Key features
Modern Forwarding support
Connections routed through a Velocity proxy carry the player's identity to the NeoForge server.
Forwarding secret
The shared forwarding.secret file from the proxy is read from the server directory to verify forwarded logins.
Packet decoding diagnostics
An added startup argument makes Velocity report more detail when packet decoding errors occur, which helps diagnose connection problems.
Compatibility
Latest build for each game version and loader.
Only full game releases are shown. This mod publishes no snapshot builds.
Use cases
Hosting behind a Velocity proxy
A network of NeoForge servers can sit behind one Velocity proxy, with players connecting through the proxy instead of each server directly.
Who it’s for: Server owners who run NeoForge servers behind a Velocity proxy and want players to connect through it. Players only need the usual client setup, since the mod runs on the server alone.
How it compares
NeoVelocity is also a NeoForge server-side mod for Velocity, covering 1.21 – 1.21.11 under the GNU General Public License v3.0 only. NeoForged Velocity Support covers 1.21.1 – 26.1.2 and is released under the MIT License, so the two differ in version range and license. Proxy Compatible Forge takes a different route, supporting Forge and NeoForge across a much wider range of game versions under the GNU Lesser General Public License v2.1 or later.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| NeoForged Velocity Support | NeoForge | 1.21.1 – 26.1.2 | Server-side only | 2026-07-10 |
| NeoVelocity | NeoForge | 1.21 – 1.21.11 | Server-side only | 2026-01-15 |
| Proxy Compatible Forge | Forge and NeoForge | 1.7.2 – 26.2 | Server-side only | 2026-08-31 |
Questions
Does the mod need to be installed on player clients?
Why must online-mode be set to false?
What should be done if packet decoding errors appear?
In the catalog
NeoForged Velocity Support is one of 8,016 Management mods on ModsFinder, and one of 2,689 Management mods for NeoForge. 15,189 mods support Minecraft 26.1.2.
More from Swedz
Similar mods
What the author says
This implementation strives for consistency with Paper's implementation of modern forwarding. This helps with compatibility and keeps the code simple. For any questions, please ask in the #velocity-support channel on my discord.
Official listing
- Modrinth page
- modrinth.com/mod/neoforged-velocity-support
- Owner
- Swedz
- Published
- 2025-12-29
- Updated on Modrinth
- 2026-07-10
- Facts verified
- 2026-10-15