Come configurare un proxy Velocity per un network Minecraft

Perché creare un network di server Minecraft e come funziona Velocity

Un network ti permette di far girare diverse modalità di gioco una accanto all'altra sotto un unico indirizzo, dare a ciascuna i propri plugin e le proprie risorse, e riavviare un server senza buttare fuori nessuno dagli altri.

I giocatori si connettono sempre e solo al proxy. Il proxy li autentica con Mojang e poi li passa a uno dei server backend: normali server Paper che contengono i mondi. Quando un giocatore digita /server survival, Velocity lo sposta su un altro backend senza disconnetterlo.

• Il proxy è leggero: non contiene alcun mondo, quindi richiede molta meno memoria di un server di gioco.
• I backend girano in modalità offline e si fidano del proxy per sapere chi è ogni giocatore. È proprio questa fiducia che devi proteggere.
• Velocity 4, la versione attuale, richiede Java 25 e funziona con Minecraft dalla 1.7.2 fino all'ultima release.

Installare Velocity

1. Scarica Velocity da papermc.io in una cartella vuota.
2. Avvialo una volta con Java 25:

java -Xms512M -Xmx512M -jar velocity.jar

Il primo avvio crea velocity.toml e un file forwarding.secret con un segreto casuale. Ferma il proxy con end e apri la configurazione.

Configurare velocity.toml

Le impostazioni che contano per un primo network:

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'indirizzo e la porta a cui si connettono i giocatori.
• player-info-forwarding-mode: impostalo su modern. Il valore predefinito è none, che assegna a ogni giocatore un UUID offline; legacy è il vecchio formato di BungeeCord e conviene solo per server 1.12 o precedenti.
• [servers]: un nome e un indirizzo per ogni backend. Il nome è quello che i giocatori usano con /server.
• try: dove finiscono i giocatori all'accesso e dove vengono mandati se un backend li espelle.

I forced host, in [forced-hosts], possono mandare i giocatori a un backend in base all'indirizzo che hanno digitato: ad esempio survival.yourserver.com direttamente alla survival.

Configurare i backend Paper per il modern forwarding

Su ogni backend Paper fai tre modifiche e riavvia:

1. server.properties: online-mode=false: ora è il proxy a gestire il login con 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'

Qui online-mode deve corrispondere a velocity.toml, e secret deve essere esattamente il testo contenuto nel forwarding.secret del proxy. Il modern forwarding funziona su Minecraft 1.13 e successive; i server Spigot non lo supportano, quindi usa Paper o un fork di Paper.

Altri backend: i server Fabric usano la mod FabricProxy-Lite con lo stesso segreto, e i server Forge successivi alla 1.20.2 richiedono ProxyCompatibleForge. I plugin di BungeeCord non funzionano su Velocity.

Proteggere i backend

Un server in modalità offline accetta qualsiasi nome giocatore. È sicuro solo se i giocatori non possono raggiungere i backend senza passare dal proxy.

• Il modern forwarding è la tua protezione principale. Un backend Paper con il forwarding di Velocity attivo rifiuta chiunque si connetta direttamente: senza i dati firmati dal proxy, il login viene respinto con This server requires you to connect with Velocity.
• Tieni segreto il segreto. Chiunque abbia forwarding.secret potrebbe spacciarsi per il tuo proxy. Non pubblicarlo mai e cambialo ovunque se trapela.
• Proteggi i backend con un firewall quando puoi. La documentazione di Velocity stessa è chiara: il modern forwarding non sostituisce un firewall. Se proxy e backend condividono la stessa macchina, associa ogni backend a 127.0.0.1 e indicali come 127.0.0.1:port.
• Non far mai girare un backend in modalità offline con il forwarding disattivato. Così chiunque può entrare come chiunque altro, anche come operatore.

Gestire un network Velocity su HytHost

Ogni parte del network è un server a sé: uno per il proxy e uno per ogni backend. Il proxy richiede poca memoria, quindi gli basta il piano più piccolo; dimensiona i backend in base ai loro mondi e giocatori su hosting Minecraft.

1. Trasforma un server nel proxy. Nella sua scheda Version, scegli Velocity. Il pannello lo installa e imposta bind sulla porta del server stesso. Controlla che nella scheda Startup sia selezionato Java 25.
2. Imposta tu il modern forwarding. Il pannello scrive un velocity.toml di base con la lista dei server vuota. Nel file manager, imposta player-info-forwarding-mode = "modern" e aggiungi i tuoi backend sotto [servers] con l'indirizzo e la porta che ognuno mostra nel proprio pannello.
3. Configura ogni backend come nella sezione Paper qui sopra, con il forwarding.secret del proxy.
4. Punta il tuo dominio al proxy e dai ai giocatori solo quell'indirizzo.

Ogni backend ha il proprio indirizzo pubblico, quindi è il modern forwarding a bloccare gli accessi diretti: non lasciare mai un backend in modalità offline con il forwarding disattivato. Per i permessi su tutto il network, usa LuckPerms su ogni server con un unico database MySQL condiviso; ogni piano include database.