Installation

Download a release from GitHub Releases. Check the Minecraft version and loader requirements for that release before installing.

Where you are installing	File	Folder
Fabric client or server	raknetify2-fabric-*.jar	mods
Forge client or server	raknetify2-forge-*.jar	mods
NeoForge client or server	raknetify2-neoforge-*.jar	mods
Spigot or Paper server	raknetify2-spigot-*.jar	plugins
Velocity proxy	raknetify2-velocity-*.jar	plugins
BungeeCord proxy	raknetify2-bungee-*.jar	plugins

Close the client or stop the server before replacing its JAR. Remove the original Raknetify JAR and any older Raknetify2 JAR from the same installation before adding the new file.

Client folders belong to the Minecraft instance or modpack you launch. Server and proxy folders belong to that server or proxy installation. Create the appropriate folder if your loader has not created it yet.

Direct server connections

1. Install the client mod for your loader.
2. Install the matching server mod, or the Spigot/Paper plugin on a compatible server.
3. Follow Firewall and router configuration to allow UDP connections to the server.
4. Restart the client and server.
5. Add a server address such as raknet;play.example.com or raknet;play.example.com:25565.

Addresses without the raknet; prefix use TCP.

Installing the client mod alone does not add RakNet support to a remote server. The server operator must provide a RakNet endpoint. Players joining someone else's server usually need no inbound router forwarding rules.

Velocity and BungeeCord

Install the matching proxy plugin and the client mod. Follow Velocity and BungeeCord for listener settings, backend forwarding, access restrictions, and the address players should use.

A separate UDP listener port

For a direct Minecraft server, set the appropriate Java argument below. Proxy operators should use the Velocity and BungeeCord listener settings.

Platform	Java argument	Accepted ports
Fabric, Forge, or NeoForge server	-Draknetify.fabric.portOverride=25570	1 through 65534
Spigot or Paper server	-Draknetify.spigot.portOverride=25570	1 through 65535

Forge and NeoForge use the shared listener code, so their property name also contains fabric. Replace 25570 with the desired UDP port.

The Spigot/Paper setting requires 0.1.0-beta.1.431 or later.

Add the argument before -jar in the Java command, or in your host's JVM arguments field. Restart the server and allow UDP on the chosen listener port. If the public port is also 25570, connect with raknet;play.example.com:25570. If a router translates the port, use its public port in the client address. The TCP port stays at its existing value.

On Spigot/Paper, the UDP listener keeps the Minecraft TCP listener's local bind address. An invalid override or occupied UDP port prevents RakNet from starting. Check the startup log for the bound UDP address and port. Remove the argument and restart to return to the TCP listener's port number.

A router or UDP proxy can also expose a different public UDP port and forward it to the existing listener without changing the server's Java arguments.

Development builds

Open a successful main run in GitHub Actions and download its Artifacts archive. GitHub requires an account to download workflow artifacts. Use the installation table above to choose a JAR from the archive.