Como configurar um proxy Velocity para uma rede de Minecraft

Porquê criar uma rede de servidores de Minecraft e como funciona o Velocity

Uma rede permite ter vários modos de jogo lado a lado sob o mesmo endereço, dar a cada um os seus próprios plugins e recursos, e reiniciar um servidor sem expulsar ninguém dos outros.

Os jogadores ligam-se sempre e apenas ao proxy. O proxy autentica-os junto da Mojang e depois envia-os para um dos servidores backend: servidores Paper normais que guardam os mundos. Quando um jogador escreve /server survival, o Velocity muda-o para outro backend sem o desligar.

• O proxy é leve: não guarda nenhum mundo, por isso precisa de muito menos memória do que um servidor de jogo.
• Os backends correm em modo offline e confiam no proxy para saber quem é cada jogador. É essa confiança que tem de proteger.
• O Velocity 4, a versão atual, precisa de Java 25 e funciona com Minecraft desde a 1.7.2 até à versão mais recente.

Instalar o Velocity

1. Transfira o Velocity a partir de papermc.io para uma pasta vazia.
2. Inicie-o uma vez com Java 25:

java -Xms512M -Xmx512M -jar velocity.jar

O primeiro arranque cria o velocity.toml e um ficheiro forwarding.secret com um segredo aleatório. Pare o proxy com end e abra a configuração.

Configurar o velocity.toml

As definições que importam para uma primeira rede:

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: o endereço e a porta a que os jogadores se ligam.
• player-info-forwarding-mode: defina-o como modern. O valor predefinido é none, que dá a cada jogador um UUID offline; legacy é o formato antigo do BungeeCord e só compensa para servidores 1.12 ou anteriores.
• [servers]: um nome e um endereço para cada backend. O nome é o que os jogadores usam com /server.
• try: para onde vão os jogadores ao entrar e para onde são enviados se um backend os expulsar.

Os forced hosts, em [forced-hosts], podem enviar os jogadores para um backend consoante o endereço que escreveram; por exemplo, survival.yourserver.com diretamente para a sobrevivência.

Preparar os backends Paper para modern forwarding

Em cada backend Paper, faça três alterações e reinicie:

1. server.properties: online-mode=false; agora é o proxy que faz o login na 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'

Aqui, online-mode tem de coincidir com o velocity.toml, e secret tem de ser exatamente o texto do forwarding.secret do proxy. O modern forwarding funciona no Minecraft 1.13 e posteriores; os servidores Spigot não o suportam, por isso use Paper ou um fork do Paper.

Outros backends: os servidores Fabric usam o mod FabricProxy-Lite com o mesmo segredo, e os servidores Forge acima da 1.20.2 precisam do ProxyCompatibleForge. Os plugins do BungeeCord não funcionam no Velocity.

Manter os backends seguros

Um servidor em modo offline aceita qualquer nome de jogador. Isso só é seguro se os jogadores não conseguirem chegar aos backends sem passar pelo proxy.

• O modern forwarding é a sua principal proteção. Um backend Paper com o forwarding do Velocity ativo recusa quem se ligar diretamente: sem os dados assinados pelo proxy, o login é rejeitado com This server requires you to connect with Velocity.
• Mantenha o segredo em segredo. Quem tiver o forwarding.secret pode fazer-se passar pelo seu proxy. Nunca o publique e altere-o em todo o lado se for divulgado.
• Proteja os backends com uma firewall sempre que possível. A própria documentação do Velocity é clara: o modern forwarding não substitui uma firewall. Se o proxy e os backends partilharem a mesma máquina, associe cada backend a 127.0.0.1 e indique-os como 127.0.0.1:port.
• Nunca corra um backend em modo offline com o forwarding desligado. Isso permite que qualquer pessoa entre como quem quiser, incluindo como operador.

Ter uma rede Velocity na HytHost

Cada parte da rede é um servidor próprio: um para o proxy e um para cada backend. O proxy precisa de pouca memória, por isso o plano mais pequeno chega; dimensione os backends consoante os mundos e os jogadores em alojamento de Minecraft.

1. Transforme um servidor no proxy. No separador Version, escolha Velocity. O painel instala-o e define o bind para a porta do próprio servidor. Confirme que o Java 25 está selecionado no separador Startup.
2. Configure o modern forwarding manualmente. O painel escreve um velocity.toml básico com a lista de servidores vazia. No gestor de ficheiros, defina player-info-forwarding-mode = "modern" e adicione os seus backends em [servers] com o endereço e a porta que cada um mostra no respetivo painel.
3. Configure cada backend como na secção Paper acima, com o forwarding.secret do proxy.
4. Aponte o seu domínio para o proxy e dê aos jogadores apenas esse endereço.

Cada backend tem o seu próprio endereço público, por isso é o modern forwarding que bloqueia as ligações diretas: não deixe nenhum backend em modo offline com o forwarding desligado. Para ter permissões em toda a rede, use o LuckPerms em cada servidor com uma única base de dados MySQL partilhada; todos os planos incluem bases de dados.