By
How to Set Up Velocity Proxy for Minecraft (Secure, Step-by-Step Guide)

Jak skonfigurować proxy Velocity dla sieci Minecraft How to Set Up Velocity Proxy for Your Minecraft Network

Velocity to nowoczesne, lekkie proxy Minecraft łączące wiele serwerów (lobby, survival, skyblock itd.) w jedną sieć. Ten poradnik prowadzi krok po kroku przez bezpieczną konfigurację.

Velocity is a lightweight, modern Minecraft proxy that connects multiple servers (lobby, survival, skyblock, etc.) into a single network. This guide walks you through a clean, secure setup—step by step.

Proxy Velocity – poradnik konfiguracji Velocity proxy setup guide

Wymagania wstępne

  • Osobna instancja (lub zatrzymany serwer) pod proxy.
  • Backendy (np. lobby, survival) na Paper lub kompatybilnych.
  • Dostęp do panelu (np. Pterodactyl) lub shella do wgrywania JARów i edycji plików.
  • Firewall/zasady hostingu tak, by publiczny był tylko proxy (zalecane).
Uwaga Nigdy nie udostępniaj forwarding secret. Mając go, ktoś mógłby podszyć się pod graczy na backendach.

1) Pobierz Velocity

2) Przygotuj serwer proxy

  1. Zatrzymaj serwer proxy i poczekaj na pełne wyłączenie.
  2. Wyczyść katalog główny proxy (zrób backup, jeśli trzeba).
  3. Wgraj Velocity jako server.jar.
  4. W panelu (np. Pterodactyl → Startup → Bungeecord Jar File) ustaw ścieżkę na server.jar.
  5. Uruchom proxy i sprawdź, czy startuje bez błędów.

3) Skopiuj forwarding secret

Po pierwszym starcie w katalogu proxy pojawi się plik forwarding.secret. Otwórz go i skopiuj całą wartość — wkleisz ją na każdym back-endzie.

Wskazówka Zapisz secret w menedżerze haseł — użyjesz go dla lobby, survival itd.

4) Konfiguracja velocity.toml

Włącz nowoczesne przekazywanie informacji o graczu (dla 1.13+):

player-info-forwarding-mode = "modern"

Dodaj serwery backend

W sekcji [servers] wypisz tryby wraz z IP:port:

[servers]
lobby = "123.123.123.123:25565"
survival = "123.123.123.123:25566"
skyblock = "123.123.123.123:25567"

Domyślne miejsce dołączania

Ustaw serwer startowy (zwykle lobby):

try = [
  "lobby"
]

Zrestartuj proxy po zapisaniu zmian.

5) Skonfiguruj backendy (Paper)

  1. Zatrzymaj backend (lobby/survival/skyblock).
  2. Na 1.19+ edytuj config/paper-global.yml (starsze: paper.yml).
  3. W sekcji velocity ustaw:
enabled: true
online-mode: true # zgodnie z trybem uwierzytelniania proxy
secret: <wklej wartość z forwarding.secret>
  1. Powtórz dla każdego backendu używając tego samego secretu.
  2. Uruchom backendy.
Wskazówka Upewnij się, że backendy nie są publiczne. Gracze powinni łączyć się tylko z IP/portem proxy.

6) Test i przełączanie serwerów w grze

Połącz się z adresem proxy. W grze użyj:

/server <nazwa>

Przykłady: /server lobby, /server survival.

FAQ i porady

Gracze nie mogą dołączyć — co sprawdzić?

  • Czy w velocity.toml jest player-info-forwarding-mode = "modern"?
  • Czy w Paper włączono Velocity i wklejono identyczny secret na wszystkich backendach?
  • Czy gracze łączą się na IP proxy (a nie backendu)?

Czy potrzebuję BungeeGuard albo trybu legacy?

Używaj modern dla serwerów 1.13+. Legacy/BungeeGuard to starsze lub specyficzne przypadki.

Skąd pobrać Velocity?

Z oficjalnej strony PaperMC: papermc.io/downloads/velocity.


Prerequisites

  • A fresh or stoppable instance for the proxy.
  • Backend servers (e.g., lobby, survival) running Paper or compatible.
  • Panel/shell access to upload JARs and edit files.
  • Firewall/host rules so only the proxy is public (recommended).
Warning Never share your forwarding secret. With it, someone could impersonate players on your backends.

1) Download Velocity

2) Prepare the Proxy Server

  1. Stop the proxy server and wait until it’s fully shut down.
  2. Clear the proxy’s root folder (back up first if needed).
  3. Upload Velocity as server.jar.
  4. In your panel (e.g., Pterodactyl → Startup → Bungeecord Jar File) point it to server.jar.
  5. Start the proxy and confirm it boots cleanly.

3) Copy Your Forwarding Secret

After the first start, Velocity creates forwarding.secret in the proxy folder. Open it and copy the entire value — you’ll paste it on every backend.

Tip Store the secret in a password manager. You’ll reuse it for lobby, survival, etc.

4) Configure velocity.toml

Enable modern player info forwarding (for 1.13+):

player-info-forwarding-mode = "modern"

Add your backend servers

Under [servers], list each game mode with IP:port:

[servers]
lobby = "123.123.123.123:25565"
survival = "123.123.123.123:25566"
skyblock = "123.123.123.123:25567"

Choose the default join target

Set where players land first (usually lobby):

try = [
  "lobby"
]

Restart the proxy after saving changes.

5) Configure Your Backend Servers (Paper)

  1. Stop the backend (lobby/survival/skyblock).
  2. On 1.19+, edit config/paper-global.yml (older: paper.yml).
  3. Find the velocity section and set:
enabled: true
online-mode: true # match your proxy’s auth mode
secret: <paste value from forwarding.secret>
  1. Repeat on every backend using the same secret.
  2. Start the backend servers.
Tip Ensure backends are not publicly exposed. Players should connect only to the proxy’s IP/port.

6) Test & Switch Servers In-Game

Connect to the proxy address. In-game, use:

/server <name>

Examples: /server lobby, /server survival.

FAQ & Tips

Players can’t join—what should I check?

  • Is player-info-forwarding-mode = "modern" set in velocity.toml?
  • Did you enable Velocity in Paper and paste the exact same secret on all backends?
  • Are players connecting to the proxy IP (not a backend)?

Do I need BungeeGuard or legacy mode?

Use modern for 1.13+ servers. Legacy/BungeeGuard is for older/niche setups.

Where do I download Velocity?

From PaperMC’s official page: papermc.io/downloads/velocity.