Velocity network

Velocity je moderní proxy pro Minecraft sítě. Oproti BungeeCordu je rychlejší a řeší bezpečnostní slabinu backend serverů díky modern forwardingu.

Proč Velocity

	Velocity	BungeeCord
Výkon	vyšší	nižší
Zabezpečení backendu	modern forwarding	jen IP filtr
Aktivní vývoj	ano	omezený
Podpora pluginů	vlastní API	starší API

Postup

Objednej Velocity server

Potřebuje dedikovaný port pro veřejné připojení.

Nastav velocity.toml

velocity.toml


bind = "0.0.0.0:25565"
motd = "&6Muj network"
show-max-players = 200
online-mode = true
player-info-forwarding-mode = "modern"
forwarding-secret-file = "forwarding.secret"
 
[servers]
lobby = "10.0.0.11:25566"
survival = "10.0.0.12:25567"
try = ["lobby"]
 
[forced-hosts]
"survival.mujserver.cz" = ["survival"]

Zkopíruj forwarding secret

Obsah souboru forwarding.secret vlož do každého backendu.

Nastav backend (Paper)

config/paper-global.yml


proxies:
  velocity:
    enabled: true
    online-mode: true
    secret: 'zde-vloz-obsah-forwarding.secret'

A v server.properties:

server.properties


online-mode=false

Spusť backendy, potom proxy

Modern forwarding kryptograficky ověří, že spojení přišlo z tvé proxy. Útočník bez znalosti secretu se na backend nepřipojí, i kdyby byl port dostupný.

forwarding.secret je heslo k celé síti. Nikdy ho nedávej do veřejného repozitáře ani do screenshotu konzole.

Migrace z BungeeCordu

Zálohuj konfiguraci

Celý config.yml a pluginy proxy.

Přepiš servery do velocity.toml

Sekce [servers].

Přepni backend z bungee na velocity mód

V paper-global.yml vypni bungee-cord a zapni velocity.

Nahraď proxy pluginy

BungeeCord pluginy na Velocity nefungují. Hledej Velocity ekvivalent.

Nezapomeň vypnout bungee-cord.online-mode na backendu. Zapnutá obě nastavení naráz způsobí, že se hráči nepřipojí a v logu uvidíš chybu o neplatném forwardingu.

Nejčastější chyby

Projev	Příčina
`Unable to verify player details`	Nesouhlasí forwarding secret
Hráči mají offline UUID	Backend má vypnutý velocity mód
`Server is online-mode`	Backend má `online-mode=true`

Tipy

Nastav try = ["lobby"]. Při pádu serveru hráče přesune do lobby místo odpojení.
Používej forced-hosts pro připojení přímo na konkrétní server přes vlastní subdoménu.

Poznámka

Velocity vyžaduje Java 17 a novější. Na starších verzích Minecraftu (1.8) je nutný doplňkový plugin pro kompatibilitu.