Sieť serverov cez Velocity: lobby, survival a minihry pod jednou adresou

Velocity je proxy, cez ktorú sa hráči pripájajú na jednu adresu a potom medzi servermi prechádzajú príkazom /server – napríklad z lobby do survivalu alebo na minihry. Ukážeme, ako Velocity nainštalovať, nastaviť, prepojiť so servermi cez bezpečný modern forwarding a zabezpečiť servery za proxy tak, aby sa na ne nikto nedostal priamo.

Kedy proxy potrebujete#

Proxy sama hru nepočíta, iba preposiela spojenia. Na výkon je nenáročná: pre desiatky hráčov stačí 1–⁠2 GB pamäte.

Ako sieť funguje#

Hráč ──► mc.example.cz:25565  (Velocity, overí účet hráča)
              │
              ├──► lobby     (Paper, online-mode=false, prijme iba proxy)
              ├──► survival  (Paper, online-mode=false, prijme iba proxy)
              └──► minihry   (Paper, online-mode=false, prijme iba proxy)

1. Hráč sa pripojí na adresu proxy. Proxy u Microsoftu overí, že má originálny účet (online-mode = true).
2. Proxy ho pošle na prvý server zo zoznamu try (lobby).
3. S pripojením proxy odovzdá serveru meno, UUID, skin a skutočnú IP adresu hráča (player info forwarding). Dáta podpíše tajným kľúčom, ktorý pozná iba proxy a vaše servery.
4. Servery za proxy (backendy) samy nič neoverujú (online-mode=false) a veria iba proxy s platným kľúčom. Kto by sa pripojil priamo, dostane hlášku This server requires you to connect with Velocity.

Proxy, servery a doména#

• Proxy: Velocity 4.x vyžaduje Javu 25. Prevádzkujte ju na VPS (VPS Performance, VPS Budget). Na proxy patria iba pluginy pre Velocity – pluginy pre Paper na nej nefungujú.
• Backendy: bežné Minecraft servery. Môžu bežať u nás ako samostatné služby (každá má vlastnú adresu a port), alebo na rovnakej VPS ako proxy.
• Doména (voliteľné): hráči zadajú mc.example.cz namiesto IP (Adresa servera a doména).

Inštalácia Velocity na VPS#

Platí pre Ubuntu 24.04 aj Debian 13. Príkazy spúšťajte ako root.

1. Nainštalujte Javu 25 a program curl:

   apt update
   apt install openjdk-25-jre-headless curl

   • apt update – stiahne aktuálny zoznam balíkov.
   • apt install openjdk-25-jre-headless – nainštaluje bežné prostredie Javy 25 bez grafických knižníc (na serveri nie sú potrebné).
   • curl – program na sťahovanie súborov z internetu (ak ho už máte, nič sa nestane).

2. Overte verziu:

   java -version

   Prvý riadok výstupu musí obsahovať 25.

3. Vytvorte používateľa a priečinok pre proxy:

   useradd --system --create-home --home-dir /opt/velocity --shell /usr/sbin/nologin velocity

   • useradd --system – vytvorí systémového používateľa bez hesla (proxy nepobeží ako root).
   • --create-home --home-dir /opt/velocity – vytvorí priečinok /opt/velocity, kde bude proxy.
   • --shell /usr/sbin/nologin – pod týmto používateľom sa nedá prihlásiť.
   • velocity – meno používateľa.

4. Na stránke papermc.io/downloads/velocity (otvorí sa v novom okne) skopírujte odkaz na najnovšiu stabilnú verziu a stiahnite ju:

   cd /opt/velocity
   curl -o velocity.jar "<ODKAZ_KE_STAZENI>"
   chown velocity:velocity velocity.jar

   • cd /opt/velocity – prejde do priečinka proxy.
   • curl -o velocity.jar – stiahne súbor a uloží ho ako velocity.jar.
   • <ODKAZ_KE_STAZENI> – odkaz skopírovaný zo stránky. Nahraďte ho celý vrátane lomených zátvoriek, úvodzovky ponechajte.
   • chown velocity:velocity – súbor bude patriť používateľovi velocity.

5. Spustite proxy prvýkrát, aby vytvorila konfiguráciu:

   runuser -u velocity -- env MALLOC_ARENA_MAX=2 java -Xms1G -Xmx1G -XX:MaxDirectMemorySize=512M -XX:+UseG1GC -XX:G1HeapRegionSize=4M -XX:+UnlockExperimentalVMOptions -XX:+ParallelRefProcEnabled -XX:+AlwaysPreTouch -jar velocity.jar

   • runuser -u velocity -- – spustí príkaz za -- ako používateľ velocity.
   • env MALLOC_ARENA_MAX=2 – obmedzí pamäťové arény alokátora, proxy potom nezaberá zbytočne pamäť navyše.
   • -Xms1G -Xmx1G – proxy dostane 1 GB haldy (naraz, nemusí ju zväčšovať za behu). Pre väčšiu sieť zvýšte na 2G. Proxy potrebuje veľa pamäte aj mimo haldy na sieť, preto jej nedávajte viac než polovicu pamäte, ktorú pre ňu máte.
   • -XX:MaxDirectMemorySize=512M – strop pre sieťové buffery. Bez neho môžu narásť až do veľkosti haldy.
   • -XX:+UseG1GC … -XX:+AlwaysPreTouch – parametre odporúčané dokumentáciou Velocity (garbage collector G1 vyladený pre proxy).
   • -jar velocity.jar – spustí proxy.

   Príkaz pre inú veľkosť pamäte pripraví Generátor štartovacieho skriptu.

   Po štarte uvidíte riadok Done (…)!. Zadajte end a Enter, proxy sa vypne. V priečinku vznikli súbory velocity.toml a forwarding.secret.

6. Aby proxy bežala trvalo a po reštarte VPS sa spustila sama, vytvorte pre ňu službu systemd podľa návodu Aplikácia 24/7 na VPS. Do unit súboru zadajte User=velocity, WorkingDirectory=/opt/velocity, Environment=MALLOC_ARENA_MAX=2 a do ExecStart príkaz z kroku 5 bez runuser -u velocity -- env MALLOC_ARENA_MAX=2 a s plnou cestou k Jave, teda začínajúci /usr/bin/java -Xms1G ….

7. Povoľte port proxy vo firewalle VPS: TCP 25565 (a UDP port Geyseru, ak ho budete používať). Pozrite Firewall v zákazníckej zóne a UFW.

velocity.toml#

Otvorte súbor /opt/velocity/velocity.toml (napríklad nano /opt/velocity/velocity.toml). Ukážka s nastavením pre sieť troch serverov (zvyšok súboru ponechajte):

bind = "0.0.0.0:25565"
motd = "<gold><bold>StormCraft</bold></gold> <gray>| lobby, survival, minihry"
show-max-players = 100
online-mode = true
force-key-authentication = true
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"

[servers]
lobby = "203.0.113.10:30066"
survival = "203.0.113.11:30067"
minihry = "203.0.113.12:30068"

try = [
    "lobby"
]

[forced-hosts]
"survival.example.cz" = [
    "survival"
]

Zo sekcií [advanced] a [query] stoja za pozornosť tri položky:

Tajný kľúč forwardingu#

Velocity pri prvom štarte vytvorí súbor forwarding.secret s náhodným kľúčom s 12 znakmi. Odporúčame ho nahradiť dlhším:

1. Vygenerujte náhodné heslo s 32 a viac znakmi (písmená a číslice) v generátore hesiel.
2. Vložte ho ako jediný riadok do /opt/velocity/forwarding.secret (napríklad cez nano).
3. Rovnaký kľúč potom zadáte na všetkých backendoch.

Nastavenie backendov (Paper a Purpur)#

Pri každom serveri za proxy:

1. V záložke Nastavenia servera vypnite v skupine Hráči Overovanie účtov (online-mode=false) a kliknite na Uložiť.

   Zákaznícka zóna zobrazí varovanie, že sa môže pripojiť ktokoľvek. Za proxy s modern forwardingom je to správne – overenie robí proxy a server prijme iba hráčov s platným kľúčom.

2. V záložke Súbory otvorte spigot.yml a skontrolujte, že settings.bungeecord je false:

   settings:
     bungeecord: false

   • bungeecord – zapína forwarding vo formáte BungeeCord (legacy). Pre modern forwarding musí byť vypnutý.

3. Otvorte config/paper-global.yml a v sekcii proxies nastavte:

   proxies:
     velocity:
       enabled: true
       online-mode: true
       secret: "<SECRET>"

   Za <SECRET> vložte obsah súboru forwarding.secret z proxy. Nahraďte ho celý vrátane lomených zátvoriek, úvodzovky ponechajte.

4. Reštartujte server.

Čo nastavenia v paper-global.yml znamenajú:

Na Paperi 1.18.2 a staršom sú tieto nastavenia v súbore paper.yml pod názvami settings.velocity-support.enabled, settings.velocity-support.online-mode a settings.velocity-support.secret.

Fabric, Forge a NeoForge#

Nastavenia FabricProxy-Lite:

Zabezpečenie backendov#

Backend s online-mode=false bez funkčného forwardingu by pustil kohokoľvek pod ľubovoľným menom. Podľa toho, kde servery bežia:

• Backendy u nás (samostatné služby): adresu a port nastavujeme automaticky (server-ip zmeniť nemožno), servery sú teda dostupné z internetu. Ochranu zaisťuje modern forwarding: s proxies.velocity.enabled: true server odmietne každého, kto nepríde cez proxy s platným kľúčom. Nikdy preto nepoužívajte legacy ani none.
• Backendy na rovnakej VPS ako proxy: v server.properties každého backendu nastavte server-ip=127.0.0.1 a vo velocity.toml zadajte adresy 127.0.0.1:<PORT>. Servery potom nie sú zvonka vôbec dostupné. Vo firewalle VPS povoľte iba port proxy.
• Backendy na inej VPS: vo firewalle backendu povoľte port servera iba z IP adresy proxy (Firewall v zákazníckej zóne).

Prepínanie serverov a pluginy na proxy#

Pluginy na proxy (do priečinka /opt/velocity/plugins, verzie pre Velocity):

• LuckPerms – oprávnenia pre príkazy proxy. Pre oprávnenia na serveroch musí byť LuckPerms aj na každom backende a všetky inštancie musia používať rovnakú databázu MySQL/MariaDB (MySQL pre pluginy). Na každom backende nastavte v konfigurácii LuckPerms iný server (napríklad lobby, survival), aby sa dali dávať oprávnenia pre jednotlivé servery, a messaging-service: sql, aby sa zmeny prejavili na všetkých serveroch hneď. Podrobne v návode LuckPerms.
• Geyser a Floodgate – hráči z Bedrocku, inštalujte ich iba na proxy (návod).
• spark – profilovanie proxy, príkaz sparkv.

Overenie#

1. Spustite proxy a backendy. V konzole proxy uvidíte Listening on …:25565 a Done (…)!.
2. Pripojte sa v hre na adresu proxy. Ocitnete sa na serveri lobby.
3. Napíšte /server survival – prepne vás bez odpojenia.
4. V konzole backendu skontrolujte riadok s vaším pripojením: musí obsahovať vašu skutočnú IP adresu, nie adresu proxy. Potom forwarding funguje. Konzola v zákazníckej zóne v predvolenom režime streamu IP adresy skrýva – na túto kontrolu kliknite hore na Zobraziť údaje.
5. Skúste sa pripojiť priamo na adresu backendu. Musíte dostať This server requires you to connect with Velocity.

Keď niečo nefunguje#

Your server did not send a forwarding request to the proxy. Make sure the server is configured for Velocity forwarding.#

Backend nemá zapnutý modern forwarding. Skontrolujte proxies.velocity.enabled: true v config/paper-global.yml (pri Fabricu FabricProxy-Lite) a či ste server po úprave reštartovali.

Unable to verify player details#

Kľúč na backende nesúhlasí s forwarding.secret na proxy. Skopírujte ho znova (bez medzier a prázdnych riadkov navyše) a backend reštartujte.

This server requires you to connect with Velocity.#

Pripájate sa priamo na backend – to je správne, server je chránený. Ak hlášku vidíte aj pri pripojení cez proxy, má proxy player-info-forwarding-mode iný než modern.

Unable to connect you to lobby. Please try again later.#

Proxy sa nedostala na backend: server nebeží, adresa alebo port v [servers] nesúhlasí s adresou v záložke Sieť daného servera, alebo spojenie blokuje firewall.

There are no available servers to connect you to. Try again later or contact an admin.#

Žiadny server zo zoznamu try nie je dostupný. Spustite lobby alebo pridajte do try záložný server.

Hráči majú po prechode na proxy prázdny inventár a iné oprávnenia#

Hráči dostali iné UUID. Príčinou je player-info-forwarding-mode = "none" (offline UUID) alebo nesúlad online-mode na proxy a proxies.velocity.online-mode na backende. Nastavte modern forwarding a obe hodnoty na true. Dáta so staršími UUID zostávajú v súboroch sveta a pluginov; pred prechodom veľkej siete na proxy si urobte zálohu.

Hráčov z Bedrocku proxy nepustí alebo nemôžu písať#

Pozrite Crossplay s Bedrockom: Geyser musí byť na proxy a vo velocity.toml vypnuté force-key-authentication.

Ďalšie zdroje#

• Velocity: prvé kroky (otvorí sa v novom okne)
• Velocity: player information forwarding (otvorí sa v novom okne)
• Velocity: konfigurácia (otvorí sa v novom okne)
• Velocity: zabezpečenie serverov (otvorí sa v novom okne)
• Paper: globálna konfigurácia (otvorí sa v novom okne)
• LuckPerms: inštalácia v sieti (otvorí sa v novom okne)