Um proxy permite que os jogadores entrem por um só endereço e passem entre vários servidores de Minecraft, como um lobby, um mundo de sobrevivência e um servidor de minigames. O proxy em si não tem mundo. Os jogadores se conectam a ele, e ele os repassa aos servidores que ficam atrás dele, chamados de servidores de backend.
Na PlayNHost, cada servidor de backend e o proxy são servidores separados, cada um com seu próprio plano e seu próprio endereço. As instâncias não podem ocupar o lugar deles, porque só uma instância de um servidor roda por vez. Veja Como usar instâncias para alternar entre mundos.
Qual proxy escolher
| Proxy | Observações |
|---|---|
| Velocity | O proxy moderno da PaperMC. Escolha-o para qualquer rede nova. |
| BungeeCord | O proxy original, mantido para redes mais antigas. |
| Waterfall | Um fork do BungeeCord. A PaperMC não o desenvolve mais e recomenda o Velocity para redes novas. |
Este guia usa o Velocity com servidores Paper atrás dele. O BungeeCord e o Waterfall aparecem no fim. Os três aparecem como tipos de servidor em Proxies dentro de Editar tipo de servidor. Veja Tipos de servidor de Minecraft explicados.
Antes de começar
- Peça ou configure o servidor proxy e pelo menos dois servidores de backend. Coloque todos na mesma localização, para que os jogadores não esperem em saltos longos entre eles. Veja Onde seu servidor roda e como a localização funciona.
- Os servidores de backend devem rodar Paper ou um fork do Paper, como o Purpur. O encaminhamento seguro do Velocity é configurado nas configurações do Paper.
- Os jogadores só recebem o Endereço do servidor do proxy. Mantenha os endereços dos backends só para você.
O principal ponto fraco desta configuração. Cada servidor da PlayNHost tem o próprio endereço, então um jogador que descobrir o endereço de um backend pode tentar entrar direto nele e pular o proxy. O encaminhamento seguro com o segredo é o que impede que uma entrada direta funcione, então mantenha o segredo privado e nunca publique o endereço de um backend. Veja o primeiro item em "Coisas que pegam as pessoas de surpresa" abaixo.
- A versão de cada servidor de backend deve ser uma que o proxy e seus jogadores possam usar. Os jogadores entram pelo proxy, então a versão do jogo deles precisa corresponder ao que os backends aceitam.
Passo 1: inicie o proxy e copie o segredo dele
- Configure um servidor do tipo Velocity. Ele não pede escolha de versão. Inicie uma vez e depois pare. Ele cria o arquivo de configurações,
velocity.toml, e um arquivo de segredo,forwarding.secret. - Abra Files no proxy e abra
forwarding.secret. Copie o texto dele. É uma senha da sua rede. Não compartilhe, não poste em um ticket nem entregue um backup a ninguém.
Passo 2: configure cada servidor de backend
Faça isso em cada servidor Paper que ficará atrás do proxy.
- Inicie o servidor uma vez para os arquivos de configuração existirem e depois pare.
- Abra Configurações e depois Server Properties (Java). Desligue Modo online e clique em Só salvar. A documentação do Velocity exige isso em todo servidor de backend, porque o proxy faz a verificação de login no lugar dele.
Abra Configurações e depois Paper's Global Settings. Essa página existe no Paper 1.19 e mais novos. As versões mais antigas do Paper guardam essas configurações em outro arquivo (
paper.yml) e não têm essa página, então atualize-as primeiro ou abra um ticket. Use a caixa de busca para achar estas três configurações emproxies.velocity, altere-as e clique em Só salvar:enabled: ligue.online-mode: precisa corresponder aoonline-modedovelocity.tomldo proxy. Isso fica ligado a menos que você tenha mudado.secret: cole o texto que você copiou deforwarding.secret.
- Inicie o servidor.
Desligar o Modo online só é seguro atrás de um proxy que encaminha os jogadores com segurança, o que estes passos configuram. Um servidor de backend com o Modo online desligado e sem encaminhamento deixa qualquer pessoa entrar com qualquer nome, inclusive o seu. Veja Como entrar no seu servidor de Minecraft.
Passo 3: avise o proxy sobre os backends
- No proxy, abra Configurações e depois Velocity Settings. Defina player-info-forwarding-mode como
MODERN. Clique em Só salvar. - Na seção servers do
velocity.toml, dê a cada backend um nome e o endereço dele comohost:port. O Velocity se conecta a ele diretamente, então nenhum jogador precisa digitá-lo. Comece com o Endereço do servidor mostrado na página Visão geral daquele backend. Não podemos prometer que um proxy sempre alcance um backend por esse endereço, porque o painel descreve essa entrada como um endereço interno, e não o que os jogadores usam. Se o proxy não conseguir alcançar um backend (os jogadores são mandados de volta ou expulsos, e o Console do proxy mostra um erro de conexão), abra um ticket, escolha o proxy em Qual servidor?, diga o nome do servidor de backend na mensagem e pergunte qual endereço o proxy deve usar. - Na mesma seção,
tryguarda os nomes dos servidores em que os jogadores caem primeiro, em ordem. O Velocity usa o próximo se o primeiro estiver fora do ar. Coloque seu lobby em primeiro. - Inicie o proxy.
A página de configurações só edita entradas que já existem no arquivo. Para adicionar um novo backend, pare o proxy, abra velocity.toml em Files, adicione uma linha na seção servers, salve e inicie o proxy de novo.
Entre e teste
- Inicie todos os servidores de backend e espere cada um dizer Online.
- Inicie o proxy.
- No Minecraft Java Edition, entre com o Endereço do servidor do proxy. Você deve chegar ao primeiro servidor da lista
try. - No jogo, digite
/servere o nome de outro backend para se mover. No Velocity, funciona um nome da seçãoservers. - Se um jogador aparecer com o nome errado, outro UUID ou sem skin, o encaminhamento não está funcionando. Confira se o mesmo segredo está no proxy e em todos os backends e se player-info-forwarding-mode é
MODERN.
Para saber como ler o Console do proxy e o que os filtros dele mostram, veja Como usar o console e executar comandos.
Coisas que pegam as pessoas de surpresa
- Os servidores de backend são alcançáveis pelo próprio endereço. Jogadores que souberem o endereço de um backend podem tentar entrar direto nele. O próprio guia de segurança do Velocity diz que um firewall é a primeira escolha e que o encaminhamento moderno não o substitui. Com o encaminhamento moderno e o segredo no lugar, um backend não aceita jogadores a menos que os dados tragam o segredo. Mantenha o segredo privado e não publique os endereços dos backends. Se você precisar de um acesso mais restrito, abra um ticket e pergunte o que é possível.
- Segredo errado. Um backend com um segredo diferente rejeita a conexão, e o jogador é mandado de volta ao primeiro servidor ou expulso. Copie o segredo de novo.
- Limites de jogadores. A contagem de jogadores mostrada pelo proxy é só um número. Cada backend ainda aplica os slots de jogadores do próprio plano. Veja Como renomear seu servidor e mudar os slots de jogadores.
- Whitelist, ops e banimentos ficam guardados em cada servidor de backend. Defina-os em todos os backends ou use um plugin de permissões que abranja a rede. Veja Como montar uma whitelist e banir jogadores.
- Os plugins do proxy são diferentes dos plugins do Paper. Em Modding e depois Plugins, um proxy mostra só plugins de proxy. Veja Como instalar plugins no Paper, Spigot e Purpur.
- Servidores de backend com mods precisam de passos extras que dependem do carregador de mods. Abra um ticket se você quiser tentar um.
- Jogadores de Bedrock podem entrar pelo Geyser no proxy. Veja Como deixar jogadores de Bedrock entrarem no seu servidor Java com o Geyser.
BungeeCord e Waterfall
A configuração é a mesma em linhas gerais, com configurações diferentes.
- Inicie o proxy uma vez. As configurações dele ficam em Configurações e depois Proxy Settings, que é o arquivo
config.yml. - Adicione os backends nas entradas de servers como
host:porte liste-os emprioritiesdentro delisteners. A questão do endereço do Passo 3 vale aqui também. Ligueip_forwardpara os jogadores manterem a identidade real. - Em cada backend, desligue o Modo online e, em Configurações, Spigot Settings, ligue
bungeecordemsettings. O painel descreve essa configuração como segura só se o servidor não puder ser alcançado diretamente. Como cada servidor da PlayNHost tem o próprio endereço, o encaminhamento do BungeeCord oferece uma proteção bem mais fraca que o do Velocity, e esse é um bom motivo para escolher o Velocity em uma rede nova.
Se você não conseguir decidir, escolha o Velocity.





