Sieć serwerów Minecraft z Velocity - lobby, survival i minigry pod jednym adresem

Velocity to proxy: gracze łączą się z jednym adresem, a Velocity przekierowuje ich na wybrany serwer - lobby, survival, minigry. Gracz przełącza się między nimi bez wychodzenia z gry. Tak działają wszystkie duże serwery.

Czego potrzebujesz

• jednego serwera Velocity - do niego łączą się gracze,
• co najmniej dwóch serwerów Paper - to na nich toczy się gra.

Velocity nie przechowuje świata i zużywa mało zasobów. Najmniejszy pakiet wystarczy nawet na kilkaset graczy.

1. Adresy serwerów Paper

Dla każdego serwera Paper zapisz adres z zakładki Network w panelu gier, np. 51.83.1.2:25601 (lobby) i 51.83.1.2:25602 (survival).

2. Konfiguracja Velocity

Na serwerze Velocity otwórz w zakładce Files plik velocity.toml i ustaw:

player-info-forwarding-mode = "modern"

[servers]
lobby = "51.83.1.2:25601"
survival = "51.83.1.2:25602"
try = ["lobby"]

• [servers] - nazwy i adresy serwerów docelowych.
• try - na który serwer gracz trafia po wejściu (i gdzie wraca, gdy inny serwer padnie).
• modern - bezpieczne przekazywanie danych gracza (nick, UUID, skin) do serwerów Paper.

W tym samym folderze jest plik forwarding.secret. Skopiuj jego zawartość: to hasło, którym Velocity podpisuje połączenia.

3. Konfiguracja serwerów Paper

Na każdym serwerze Paper:

1. W server.properties ustaw online-mode=false. Logowanie graczy sprawdza teraz Velocity.
2. W pliku config/paper-global.yml znajdź sekcję proxies i ustaw:

proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: 'wklej-tu-zawartosc-forwarding.secret'

1. Zrestartuj serwer Paper, a na końcu Velocity.

Czy online-mode=false jest bezpieczne?

Tak, jeśli ustawisz sekret. Serwer Paper z włączonym velocity.enabled i poprawnym sekretem odrzuca każde połączenie, które nie przyszło przez Twoje Velocity. Bez sekretu każdy mógłby wejść na serwer Paper bezpośrednio, pod dowolnym nickiem. Dlatego nigdy nie udostępniaj pliku forwarding.secret.

Przełączanie między serwerami

Gracze używają komendy:

/server survival

Wygodniej jest dodać w lobby plugin z menu albo NPC do wyboru trybu - znajdziesz takie w zakładce Pluginy na serwerze Paper.

Pluginy na Velocity

Velocity ma własne pluginy (np. LuckPerms w wersji Velocity, ogólny czat między serwerami, lista graczy). Wgrywasz je do folderu plugins na serwerze Velocity. Pluginy Paper nie działają na Velocity i odwrotnie.

Najczęstsze błędy

• „If you wish to use IP forwarding, please enable it in your BungeeCord config as well!” - serwer Paper nie ma włączonego Velocity w paper-global.yml albo sekret się nie zgadza.
• „Unable to connect you to lobby” - zły adres w [servers] albo serwer docelowy jest wyłączony.

Aktualizacja: 2026-09-21