Como configurar um proxy Velocity para uma rede de Minecraft

Por que montar uma rede de servidores de Minecraft e como o Velocity funciona

Uma rede permite rodar diferentes modos de jogo lado a lado no mesmo endereço, dar a cada um seus próprios plugins e recursos, e reiniciar um servidor sem derrubar ninguém dos outros.

Os jogadores só se conectam ao proxy. O proxy faz o login deles na Mojang e depois os envia para um dos servidores backend: servidores Paper comuns que guardam os mundos. Quando um jogador digita /server survival, o Velocity o move para outro backend sem desconectar.

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

Instalar o Velocity

1. Baixe o Velocity em papermc.io para uma pasta vazia.
2. Inicie-o uma vez com Java 25:

java -Xms512M -Xmx512M -jar velocity.jar

A primeira inicialização cria o velocity.toml e um arquivo forwarding.secret com um segredo aleatório. Pare o proxy com end e abra a configuração.

Configurar o velocity.toml

As configuraçõ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 aos quais os jogadores se conectam.
• player-info-forwarding-mode: defina como modern. O padrão é none, que dá a cada jogador um UUID offline; legacy é o formato antigo do BungeeCord e só vale a pena 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 os jogadores vão ao entrar e para onde são enviados se um backend os expulsar.

Os forced hosts, em [forced-hosts], podem mandar os jogadores para um backend de acordo com o endereço que digitaram; por exemplo, survival.yourserver.com direto 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 precisa bater com o velocity.toml, e secret precisa ser exatamente o texto do forwarding.secret do proxy. O modern forwarding funciona no Minecraft 1.13 e posteriores; servidores Spigot não têm suporte, então use Paper ou um fork do Paper.

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

Mantenha 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 é sua principal proteção. Um backend Paper com o forwarding do Velocity ativado recusa qualquer um que se conecte 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 se passar pelo seu proxy. Nunca o publique e troque-o em todos os lugares se ele vazar.
• Proteja os backends com firewall sempre que puder. A própria documentação do Velocity deixa claro que o modern forwarding não substitui um firewall. Se o proxy e os backends estiverem na mesma máquina, vincule cada backend a 127.0.0.1 e liste-os como 127.0.0.1:port.
• Nunca rode um backend em modo offline com o forwarding desligado. Isso deixa qualquer um entrar como qualquer pessoa, inclusive como operador.

Rodar 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, então o menor plano basta; dimensione os backends de acordo com os mundos e os jogadores em hospedagem de Minecraft.

1. Transforme um servidor no proxy. Na aba Version dele, escolha Velocity. O painel instala e define o bind para a porta do próprio servidor. Confira se o Java 25 está selecionado na aba Startup.
2. Configure o modern forwarding você mesmo. O painel grava um velocity.toml básico com a lista de servidores vazia. No gerenciador de arquivos, defina player-info-forwarding-mode = "modern" e adicione seus backends em [servers] com o endereço e a porta que cada um mostra no próprio painel.
3. Configure cada backend como na seção Paper acima, com o forwarding.secret do proxy.
4. Aponte seu domínio para o proxy e passe aos jogadores só esse endereço.

Cada backend tem seu próprio endereço público, então é o modern forwarding que barra as conexões diretas: não deixe nenhum backend em modo offline com o forwarding desligado. Para ter permissões na rede inteira, rode o LuckPerms em cada servidor com um único banco de dados MySQL compartilhado; todos os planos incluem bancos de dados.