Com configurar un proxy Velocity per a una xarxa de Minecraft

Per què tenir una xarxa de servidors de Minecraft i com funciona Velocity

Una xarxa et permet executar diferents modes de joc l'un al costat de l'altre sota una sola adreça, donar a cadascun els seus propis plugins i recursos, i reiniciar un servidor sense fer fora tothom dels altres.

Els jugadors només es connecten al proxy. El proxy els autentica amb Mojang i després els passa a un dels servidors backend — servidors Paper normals que contenen els mons. Quan un jugador escriu /server survival, Velocity el mou a un altre backend sense desconnectar-lo.

• El proxy és lleuger: no conté cap món, així que necessita molta menys memòria que un servidor de joc.
• Els backends funcionen en mode offline i confien que el proxy els digui qui és cada jugador. Aquesta confiança és el que has de protegir.
• Velocity 4, la versió actual, necessita Java 25 i funciona amb Minecraft des de la 1.7.2 fins a la darrera versió.

Instal·la Velocity

1. Descarrega Velocity de papermc.io en una carpeta buida.
2. Inicia'l una vegada amb Java 25:

java -Xms512M -Xmx512M -jar velocity.jar

El primer inici crea velocity.toml i un fitxer forwarding.secret amb un secret aleatori. Atura el proxy amb end i obre la configuració.

Configura velocity.toml

Els paràmetres que importen per a una primera xarxa:

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 — l'adreça i el port als quals es connecten els jugadors.
• player-info-forwarding-mode — posa-hi modern. El valor per defecte és none, que dona a cada jugador un UUID offline; legacy és l'antic format de BungeeCord i només val la pena per a servidors 1.12 i anteriors.
• [servers] — un nom i una adreça per a cada backend. El nom és el que fan servir els jugadors amb /server.
• try — on van els jugadors en entrar i on se'ls envia si un backend els expulsa.

Els forced hosts, a [forced-hosts], poden enviar els jugadors a un backend segons l'adreça que han escrit — per exemple, survival.yourserver.com directament a survival.

Configura els backends Paper per al reenviament modern

A cada backend Paper, fes tres canvis i reinicia'l:

1. server.properties: online-mode=false — ara és el proxy qui fa l'autenticació amb Mojang.
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'

Aquí online-mode ha de coincidir amb velocity.toml, i secret ha de ser exactament el text del forwarding.secret del proxy. El reenviament modern funciona a Minecraft 1.13 i posteriors; els servidors Spigot no l'admeten, així que fes servir Paper o un fork de Paper.

Altres backends: els servidors Fabric fan servir el mod FabricProxy-Lite amb el mateix secret, i els servidors Forge per sobre de la 1.20.2 necessiten ProxyCompatibleForge. Els plugins de BungeeCord no funcionen a Velocity.

Mantén segurs els backends

Un servidor en mode offline accepta qualsevol nom de jugador. Això només és segur si els jugadors no poden arribar als backends sense passar pel proxy.

• El reenviament modern és la teva protecció principal. Un backend Paper amb el reenviament de Velocity activat rebutja qualsevol que s'hi connecti directament: sense les dades signades del proxy, l'inici de sessió es rebutja amb This server requires you to connect with Velocity.
• Guarda el secret en secret. Qualsevol que tingui forwarding.secret podria fer-se passar pel teu proxy. No el publiquis mai i canvia'l a tot arreu si es filtra.
• Protegeix els backends amb un tallafoc quan puguis. La mateixa documentació de Velocity deixa clar que el reenviament modern no substitueix un tallafoc. Si el proxy i els backends comparteixen màquina, vincula cada backend a 127.0.0.1 i llista'ls com a 127.0.0.1:port.
• No executis mai un backend en mode offline amb el reenviament desactivat. Això permet que qualsevol entri com qualsevol altre, fins i tot com a operador.

Executa una xarxa Velocity a HytHost

Cada part de la xarxa és un servidor independent: un per al proxy i un per a cada backend. El proxy necessita poca memòria, així que el pla més petit n'hi ha prou; dimensiona els backends segons els seus mons i jugadors a hosting de Minecraft.

1. Converteix un servidor en el proxy. A la seva pestanya Version, tria Velocity. El panell l'instal·la i posa bind al port propi del servidor. Comprova que Java 25 estigui seleccionat a la pestanya Startup.
2. Configura tu mateix el reenviament modern. El panell escriu un velocity.toml bàsic amb la llista de servidors buida. Al gestor de fitxers, posa player-info-forwarding-mode = "modern" i afegeix els teus backends a [servers] amb l'adreça i el port que cadascun mostra al seu panell.
3. Configura cada backend com a la secció de Paper de més amunt, amb el forwarding.secret del proxy.
4. Apunta el teu domini al proxy i dona als jugadors només aquesta adreça.

Cada backend té la seva pròpia adreça pública, així que és el reenviament modern el que impedeix les connexions directes — no deixis un backend en mode offline amb el reenviament desactivat. Per a permisos a tota la xarxa, executa LuckPerms a cada servidor amb una única base de dades MySQL compartida; cada pla inclou bases de dades.