Skip to content

chillinturt/MinecraftVelocityProxyNetwork

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MinecraftVelocityProxyNetwork

Create a web of interconnected Minecraft servers that allows players to seamlessly switch between servers using in-game commands via a Velocity proxy.


Step 1: Java & Server Setup

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:

  1. Visit https://papermc.io
  2. Download the appropriate server JARs
  3. Place the files in the correct folders:
    • velocity.jar in the Velocity folder
    • paper.jar in the Lobby and Games folders

Step 2: Velocity Configuration

  1. Open the Velocity folder
  2. Run start.bat once to generate configuration files
  3. 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 factions to games
    • Set ports: lobby = "127.0.0.1:25566" games = "127.0.0.1:25567"

    (Additional servers can be added using new ports as needed)

  • Under [forced-hosts]:

    • Delete all existing entries
  1. Open forwarding.secret
  2. Copy the contents and save them for later use

Step 3: Lobby Server Configuration

  1. Open the Lobby folder

  2. Run start.bat

  3. Open eula.txt and set: eula=true

  4. Save and restart the server to generate files

  5. Open server.properties and set: online-mode=false server-port=25566

  6. Open: config/paper-global.yml

Find the velocity: section and set: enabled: true online-mode: true secret: "PASTE_FORWARDING_SECRET_HERE"


Step 4: Games Server Setup

  1. Copy the contents of the Lobby folder
  2. Paste them into the Games folder
  3. Open server.properties in Games
  4. Change: server-port=25567

Step 5: Run the Network

  1. Run start.bat in each folder:

    • Velocity
    • Lobby
    • Games
  2. Open Minecraft 1.21.10

  3. 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).


Networking Notes

  • 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.

About

Create a web of interconnected Minecraft servers to easily switch between servers using in game commands

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors