Een Velocity-proxy instellen voor een Minecraft-netwerk

Waarom een Minecraft-servernetwerk, en hoe Velocity werkt

Met een netwerk draai je verschillende spelmodi naast elkaar onder één adres, geef je elk zijn eigen plugins en resources, en herstart je één server zonder dat iemand van de andere servers wordt gegooid.

Spelers verbinden altijd alleen met de proxy. De proxy logt ze in bij Mojang en stuurt ze daarna door naar een van de backendservers: gewone Paper-servers waarop de werelden staan. Typt een speler /server survival, dan verplaatst Velocity hem naar een andere backend zonder de verbinding te verbreken.

• De proxy is licht: er staat geen wereld op, dus hij heeft veel minder geheugen nodig dan een gameserver.
• De backends draaien in offline mode en vertrouwen op de proxy om te weten wie elke speler is. Dat vertrouwen moet je beveiligen.
• Velocity 4, de huidige versie, heeft Java 25 nodig en werkt met Minecraft vanaf 1.7.2 tot en met de nieuwste release.

Velocity installeren

1. Download Velocity van papermc.io naar een lege map.
2. Start het één keer met Java 25:

java -Xms512M -Xmx512M -jar velocity.jar

Bij de eerste start worden velocity.toml en een bestand forwarding.secret met een willekeurig secret aangemaakt. Stop de proxy met end en open de configuratie.

velocity.toml configureren

De instellingen die ertoe doen voor een eerste netwerk:

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: het adres en de poort waarmee spelers verbinden.
• player-info-forwarding-mode: zet deze op modern. De standaard is none, waardoor elke speler een offline UUID krijgt; legacy is het oude BungeeCord-formaat en alleen de moeite waard voor servers op 1.12 of ouder.
• [servers]: een naam en adres voor elke backend. De naam is wat spelers gebruiken met /server.
• try: waar spelers bij het inloggen terechtkomen, en waar ze heen gaan als een backend ze kickt.

Forced hosts, onder [forced-hosts], kunnen spelers naar een backend sturen op basis van het adres dat ze intypten, bijvoorbeeld survival.yourserver.com rechtstreeks naar survival.

De Paper-backends instellen voor modern forwarding

Voer op elke Paper-backend drie wijzigingen door en herstart:

1. server.properties: online-mode=false: de proxy regelt nu de Mojang-login.
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 moet hier overeenkomen met velocity.toml, en secret moet precies de tekst uit de forwarding.secret van de proxy zijn. Modern forwarding werkt op Minecraft 1.13 en nieuwer; Spigot-servers ondersteunen het niet, dus gebruik Paper of een fork van Paper.

Andere backends: Fabric-servers gebruiken de mod FabricProxy-Lite met hetzelfde secret, en Forge-servers boven 1.20.2 hebben ProxyCompatibleForge nodig. BungeeCord-plugins draaien niet op Velocity.

Houd de backends veilig

Een server in offline mode accepteert elke spelersnaam. Dat is alleen veilig als spelers de backends niet kunnen bereiken zonder via de proxy te gaan.

• Modern forwarding is je belangrijkste bescherming. Een Paper-backend met Velocity-forwarding ingeschakeld weigert iedereen die rechtstreeks verbindt: zonder de ondertekende gegevens van de proxy wordt de login geweigerd met This server requires you to connect with Velocity.
• Houd het secret geheim. Wie forwarding.secret heeft, kan zich voordoen als jouw proxy. Deel het nooit en vervang het overal als het uitlekt.
• Zet waar mogelijk een firewall voor de backends. De documentatie van Velocity zelf is duidelijk: modern forwarding is geen vervanging voor een firewall. Draaien de proxy en de backends op dezelfde machine, bind elke backend dan aan 127.0.0.1 en vermeld ze als 127.0.0.1:port.
• Draai nooit een backend in offline mode met forwarding uit. Dan kan iedereen inloggen als wie dan ook, ook als operator.

Een Velocity-netwerk draaien op HytHost

Elk onderdeel van het netwerk is een eigen server: één voor de proxy en één voor elke backend. De proxy heeft weinig geheugen nodig, dus het kleinste pakket volstaat; kies de backends op basis van hun werelden en spelers bij Minecraft-hosting.

1. Maak van één server de proxy. Kies Velocity in het tabblad Version. Het panel installeert het en zet bind op de eigen poort van de server. Controleer of Java 25 is geselecteerd in het tabblad Startup.
2. Stel modern forwarding zelf in. Het panel schrijft een eenvoudige velocity.toml met een lege serverlijst. Zet in de bestandsbeheerder player-info-forwarding-mode = "modern" en voeg je backends toe onder [servers] met het adres en de poort die elk in zijn panel toont.
3. Configureer elke backend zoals in het Paper-gedeelte hierboven, met de forwarding.secret van de proxy.
4. Laat je domein naar de proxy wijzen en geef spelers alleen dat adres.

Elke backend heeft een eigen openbaar adres, dus modern forwarding is wat directe verbindingen tegenhoudt: laat geen enkele backend in offline mode staan met forwarding uit. Voor rechten over het hele netwerk draai je LuckPerms op elke server met één gedeelde MySQL-database; elk pakket bevat databases.