Jak nastavit Velocity proxy na Minecraft serveru (Návod)

Velocity je moderní proxy. Hráč se připojí na jednu adresu. Proxy ho pošle do lobby nebo na konkrétní backend. Často nahrazuje BungeeCord.

Backend je pořád plný Minecraft server (Paper, Purpur, Fabric) s vlastním světem a pluginy. Velocity svět nespustí. Bez alespoň jedné instance za proxy se hráč nemá kam dostat.

Rychlý přehled

1. V Eternyx dashboardu založíte druhý server typu Velocity.
2. V velocity.toml nastavíte player-info-forwarding-mode = "modern" a do [servers] dáte adresu Paper backendu.
3. Ze souboru forwarding.secret zkopírujete secret. Hodnotu sem nepíšeme.
4. Na Paper nastavíte online-mode=false a v config/paper-global.yml zapnete proxies.velocity.
5. Hráči zadávají jen IP proxy. V tomto návodu je to game01.eternyx.cz:8044. Backend game01.eternyx.cz:8040 hráčům neposíláte.

1. Zjistěte, jestli proxy vůbec potřebujete

Velocity zapněte, když platí jedno z tohoto:

• víc herních světů jako samostatné servery (lobby + survival + minihry)
• hráč má mít jednu IP, ale uvnitř přechází mezi módy
• backendy běží na různých verzích Minecraftu

Jeden Paper s jedním světem proxy nepotřebuje. Tehdy hráče posíláte rovnou na ten server.

Backend spusťte jako první. Každý má vlastní pluginy, svět a port. Velocity jsou jen vstupní dveře.

Když víc služeb sdílí jeden stroj, druhý port řeší Jak přidat extra port. Extra port tu znovu nerozebíráme.

2. Vytvořte server Velocity

V dashboardu otevřete Servery a klikněte na + Vytvořit server.

Vyberte Minecraft a pokračujte.

V kroku Plán zvolte tarif PROXY s 1 GB RAM. Proxy nespočítává svět, stačí mu nejmenší plán.

V kroku Software sjeďte ke skupině PROXY SERVERY a vyberte Velocity.

U Verze nechte aktuální Velocity a zaškrtnuté Pouze stabilní verze. Potvrďte Pokračovat.

Do Název serveru napište například proxy.

V Úhradě potvrďte Zaplatit a vytvořit server.

Po vytvoření server Spusťte. Až po prvním startu Velocity vytvoří velocity.toml a forwarding.secret.

3. Nastavte modern forwarding

Otevřete proxy a záložku Prohlížeč souborů. V kořeni otevřete velocity.toml.

Najděte player-info-forwarding-mode a nastavte:

player-info-forwarding-mode = "modern"

Režim modern je oficiální forwarding Velocity pro Minecraft 1.13 a novější. Uložte soubor.

4. Přidejte Paper backend do [servers]

Ve stejném souboru najděte sekci [servers]. Každý klíč je jméno backendu, hodnota je host:port.

V tomto návodu běží Paper tutorial na game01.eternyx.cz:8040:

[servers]
tutorial = "game01.eternyx.cz:8040"

try = [
  "tutorial"
]

try je pořadí, ve kterém proxy hledá backend po přihlášení. Bez něj (nebo s cizím jménem) se hráč připojí a nemá kam jít.

Sekci [forced-hosts] vyprázdněte, pokud v ní zůstanou ukázkové hosty lobby.example.com, factions.example.com nebo minigames.example.com. Odkazují na servery, které nemáte, a Velocity se kvůli nim nespustí.

Uložte velocity.toml.

5. Zkopírujte forwarding.secret

V kořeni proxy otevřete forwarding.secret. Je to jeden řádek, který Velocity vygeneruje při startu. Zkopírujte ho. Do článku ani do chatu ho nevkládejte.

Stejnou hodnotu musí znát Paper. Secret zastaví podvržení identity, i kdyby někdo našel veřejný port backendu.

6. Nastavte Paper backend

Otevřete server tutorial (ne proxy). V server.properties nastavte:

online-mode=false

Ověření účtů řeší Velocity. Když na backendu necháte online-mode=true a zároveň forwarding, přihlášení se rozbije. Uložte soubor.

Pak otevřete config/paper-global.yml. V bloku proxies.velocity nastavte:

proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: '<stejná hodnota jako v forwarding.secret>'

online-mode: true u Velocity v Paperu musí sedět s online-mode na proxy (prémiové účty). Secret je stejný řetězec jako v forwarding.secret. Uložte soubor.

V spigot.yml nechte:

settings:
  bungeecord: false

BungeeCord forwarding sem nepatří. Restartujte tutorial i proxy.

7. Kam se hráči připojují

Hráči zadávají IP proxy: game01.eternyx.cz:8044.

IP backendu (game01.eternyx.cz:8040) hráčům neposílejte. Ten port existuje, ale hráč na něj nemá chodit. Když na Paperu vypnete online-mode, musíte mít zapnutý modern forwarding a stejný secret. Jinak se na backend může dostat někdo mimo proxy.

Fabric a Forge backendy

Na Fabric nainstalujte FabricProxy-Lite. Secret patří do config/FabricProxy-Lite.toml.

Na Forge nainstalujte Proxy Compatible Forge. Secret patří do config/proxy-compatible-forge.toml.

Pluginy

Pluginy Velocity nejsou pluginy Paper. Jar z plugins na Paper do složky plugins na Velocity nepatří. BungeeCord pluginy na Velocity často nefungují. Používejte build určený pro Velocity.

Časté problémy

Hráč se připojí, ale nemá kam jít

Za proxy neběží žádný backend, adresa v [servers] nesedí, nebo try odkazuje na jméno, které v [servers] není.

Někdo vešel rovnou na survival

Backend je z internetu otevřený a forwarding není zapnutý. Zapněte modern + stejný secret. Veřejný vstup na backend hráčům neposílejte.

Paper plugin na proxy nejde

To je správné. Velocity spouští jen své pluginy.

FAQ

Jaký online-mode na proxy a jaký na backendu?

Ověření účtů řeší proxy. Na Velocity nastavíte online-mode podle toho, jestli chcete prémiové účty. Backendy nechte v online-mode=false a identitu berte z forwardingu.

Potřebuji extra port?

Jen když na stejném stroji poslouchá víc služeb. Postup je v návodu na extra port.

Velocity se nespustí. Co zkontrolovat v Nastavení?

V Nastavení otevřete Docker kontejnery a přepněte Docker image na Java 21.

Pak proxy znovu spusťte. Zároveň zkontrolujte prázdné [forced-hosts].