Jak nastavit Velocity proxy pro síť Minecraft serverů

Proč provozovat síť Minecraft serverů a jak Velocity funguje

Síť vám umožní provozovat různé herní režimy vedle sebe pod jednou adresou, dát každému vlastní pluginy a prostředky a restartovat jeden server, aniž byste odpojili všechny ostatní.

Hráči se vždy připojují jen k proxy. Proxy je přihlásí přes Mojang a pak je předá na jeden z backendových serverů — běžných Paper serverů, které drží světy. Když hráč napíše /server survival, Velocity ho přesune na jiný backend bez odpojení.

• Proxy je nenáročná: nedrží žádný svět, takže potřebuje mnohem méně paměti než herní server.
• Backendy běží v offline režimu a spoléhají na proxy, že jim řekne, kdo je který hráč. Právě tuto důvěru musíte zabezpečit.
• Velocity 4, aktuální verze, vyžaduje Java 25 a funguje s Minecraftem od 1.7.2 až po nejnovější vydání.

Instalace Velocity

1. Stáhněte Velocity z papermc.io do prázdné složky.
2. Jednou ji spusťte s Java 25:

java -Xms512M -Xmx512M -jar velocity.jar

První spuštění vytvoří velocity.toml a soubor forwarding.secret s náhodným tajným klíčem. Zastavte proxy příkazem end a otevřete konfiguraci.

Konfigurace velocity.toml

Nastavení, na kterých u první sítě záleží:

bind = "0.0.0.0:25565"
motd = "<#09add3>My Network"
online-mode = true
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"

[servers]
lobby = "203.0.113.10:25566"
survival = "203.0.113.11:25567"
try = ["lobby"]

• bind — adresa a port, ke kterým se hráči připojují.
• player-info-forwarding-mode — nastavte na modern. Výchozí hodnota je none, která dá každému hráči offline UUID; legacy je starý formát BungeeCord a vyplatí se jen pro servery 1.12 a starší.
• [servers] — název a adresa každého backendu. Název hráči používají s /server.
• try — kam hráči jdou po přihlášení a kam jsou posláni, když je backend vyhodí.

Forced hosts v sekci [forced-hosts] umí poslat hráče na backend podle adresy, kterou zadali — například survival.yourserver.com rovnou na survival.

Nastavení Paper backendů pro modern forwarding

Na každém Paper backendu proveďte tři změny a restartujte:

1. server.properties: online-mode=false — přihlášení přes Mojang teď řeší proxy.
2. spigot.yml: settings.bungeecord: false.
3. config/paper-global.yml:

proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: 'paste the contents of forwarding.secret here'

online-mode zde musí odpovídat velocity.toml a secret musí být přesně text ze souboru forwarding.secret na proxy. Modern forwarding funguje na Minecraftu 1.13 a novějším; servery Spigot ho nepodporují, proto použijte Paper nebo fork Paperu.

Ostatní backendy: servery Fabric používají mod FabricProxy-Lite se stejným tajným klíčem a servery Forge nad 1.20.2 potřebují ProxyCompatibleForge. Pluginy BungeeCord na Velocity nefungují.

Zabezpečení backendů

Server v offline režimu přijme jakékoli jméno hráče. To je bezpečné jen tehdy, když se hráči k backendům nedostanou jinak než přes proxy.

• Modern forwarding je vaše hlavní ochrana. Paper backend se zapnutým forwardingem Velocity odmítne každého, kdo se připojí přímo: bez podepsaných dat z proxy je přihlášení zamítnuto hláškou This server requires you to connect with Velocity.
• Udržte tajný klíč v tajnosti. Kdokoli se souborem forwarding.secret by se mohl vydávat za vaši proxy. Nikdy ho nezveřejňujte, a pokud unikne, změňte ho všude.
• Kde to jde, chraňte backendy firewallem. Dokumentace Velocity jasně říká, že modern forwarding firewall nenahrazuje. Pokud proxy a backendy sdílejí jeden stroj, navažte každý backend na 127.0.0.1 a uveďte je jako 127.0.0.1:port.
• Nikdy neprovozujte backend v offline režimu s vypnutým forwardingem. Pak se může kdokoli připojit jako kdokoli, včetně operátora.

Provoz sítě Velocity na HytHost

Každá část sítě je samostatný server: jeden pro proxy a jeden pro každý backend. Proxy potřebuje málo paměti, takže jí stačí nejmenší tarif; backendy dimenzujte podle jejich světů a hráčů na stránce Minecraft hosting.

1. Udělejte z jednoho serveru proxy. V jeho záložce Version vyberte Velocity. Panel ji nainstaluje a nastaví bind na vlastní port serveru. Zkontrolujte, že je v záložce Startup vybrána Java 25.
2. Modern forwarding nastavte sami. Panel zapíše základní velocity.toml s prázdným seznamem serverů. Ve správci souborů nastavte player-info-forwarding-mode = "modern" a přidejte své backendy do [servers] s adresou a portem, které každý z nich ukazuje ve svém panelu.
3. Nakonfigurujte každý backend podle sekce o Paperu výše, s forwarding.secret z proxy.
4. Nasměrujte svou doménu na proxy a hráčům dávejte jen tuto adresu.

Každý backend má vlastní veřejnou adresu, takže přímým připojením brání právě modern forwarding — nenechávejte backend v offline režimu s vypnutým forwardingem. Pro oprávnění napříč celou sítí provozujte LuckPerms na každém serveru s jednou sdílenou databází MySQL; každý tarif obsahuje databáze.