Create a web of interconnected Minecraft servers that allows players to seamlessly switch between servers using in-game commands via a Velocity proxy.
Edit the start.bat files in all folders:
- Games
- Lobby
- Velocity
Update them to match your Java installation path. Example for Minecraft 1.21.10: jdk21.0.9_10\bin\java.exe
Download the jar files:
- Visit https://papermc.io
- Download the appropriate server JARs
- Place the files in the correct folders:
velocity.jarin the Velocity folderpaper.jarin the Lobby and Games folders
- Open the
Velocityfolder - Run
start.batonce to generate configuration files - Open
velocity.toml
Update the following:
-
Set player forwarding mode: player-info-forwarding-mode = "modern" (Refer to comments in the file if using a different Minecraft version)
-
Under
[servers]:- Delete
minigames - Rename
factionstogames - Set ports: lobby = "127.0.0.1:25566" games = "127.0.0.1:25567"
(Additional servers can be added using new ports as needed)
- Delete
-
Under
[forced-hosts]:- Delete all existing entries
- Open
forwarding.secret - Copy the contents and save them for later use
-
Open the
Lobbyfolder -
Run
start.bat -
Open
eula.txtand set: eula=true -
Save and restart the server to generate files
-
Open
server.propertiesand set: online-mode=false server-port=25566 -
Open: config/paper-global.yml
Find the velocity: section and set:
enabled: true
online-mode: true
secret: "PASTE_FORWARDING_SECRET_HERE"
- Copy the contents of the
Lobbyfolder - Paste them into the
Gamesfolder - Open
server.propertiesinGames - Change: server-port=25567
-
Run
start.batin each folder:- Velocity
- Lobby
- Games
-
Open Minecraft 1.21.10
-
Join the server using the Velocity port (Common choice: 25565)
You will be automatically redirected to the Lobby server.
Use the command: /server X
to join another server (e.g., /server games).
- Only the Velocity port needs to be port forwarded
- Backend servers (Lobby, Games) do NOT require port forwarding
- This setup improves security and mirrors production proxy architectures
You now have a fully functional local Minecraft server network.