O server.properties reúne opções de partida do servidor: autenticação, conexão, comportamento de mundo, exibição no navegador, distância e algumas proteções. Editá-lo sem contexto pode mudar como jogadores entram ou expor um serviço que não deveria estar acessível.

Este guia organiza uma revisão segura. Valores e opções mudam entre versões do Minecraft e Paper. Compare com a referência correspondente à versão instalada e veja se o painel ou os argumentos de inicialização substituem o arquivo.

Faça uma cópia e pare o servidor

Antes de editar, solicite uma parada completa no painel e aguarde o processo terminar. Alterar o arquivo enquanto o servidor grava configurações pode fazer a mudança se perder na próxima gravação. Faça uma cópia e, se a mudança puder afetar mundo ou operação, inclua um backup recuperável dos dados necessários.

Abra uma cópia de trabalho em editor de texto simples. Não renomeie o arquivo para server.properties.txt nem o salve como documento formatado. Anote data, versão e objetivo de cada alteração para facilitar revisão e rollback.

Confirme qual configuração tem prioridade

Não presuma que o valor visível no arquivo é o que está em vigor. Paper aceita argumentos de linha de comando que podem espelhar propriedades; esses argumentos têm precedência. O painel também pode gerar argumentos ao iniciar o servidor ou aplicar opções pela interface.

Confira o comando real da inicialização e a documentação do painel. Se a interface controla o valor, altere-o ali e reinicie para observar o arquivo resultante. Evite manter o mesmo ajuste em dois lugares: uma divergência pode parecer que Paper ignora a configuração.

Revise autenticação e acesso

online-mode determina se o servidor verifica contas pelo serviço oficial de autenticação. Alterá-lo pode afetar identidade dos jogadores e segurança da rede. Em uma configuração direta comum, mantenha o modo online habilitado. Em rede com proxy, a topologia exige encaminhamento coordenado e proteção da origem; não desligue autenticação do backend sem seguir o procedimento oficial aplicável.

white-list limita a entrada a jogadores autorizados e enforce-whitelist define se o servidor remove quem não está autorizado. Uma whitelist ajuda durante manutenção e testes privados, mas não substitui segurança do proxy, controle de contas ou permissões da equipe. Tenha um operador responsável capaz de recuperar o acesso.

Trate portas e interfaces como superfície pública

server-port define a porta do Minecraft e server-ip define o endereço de interface usado pelo processo. Em muitos cenários gerenciados, o endereço deve permanecer vazio para que o serviço escute nas interfaces configuradas pela hospedagem. Um IP local inexistente pode impedir o bind, enquanto uma interface errada pode tornar o serviço inacessível.

enable-rcon habilita acesso remoto ao console, que tem poder administrativo. Se necessário, use as instruções do provedor, senha forte e controles de rede; não publique a porta nem reutilize senha. Se você não precisa de RCON, mantenha-o desligado. Query e gestão remota são serviços distintos: habilite apenas o que o monitoramento utiliza e saiba qual porta ficará exposta.

Confira mundo e experiência de jogo

level-name identifica o diretório do mundo principal; mudar o campo pode iniciar um mundo diferente em vez de renomear os dados existentes. Confira qual pasta será carregada e não apague arquivos que parecem antigos antes de validar todas as dimensões.

view-distance define até que alcance o servidor envia dados de chunks, enquanto simulation-distance limita a área de atividade simulada. As opções afetam partes distintas da experiência e podem ser sobrepostas por configurações por mundo. Altere em degraus e compare MSPT, geração, qualidade visual e funcionamento de fazendas.

max-players é um limite operacional, não uma medida de capacidade real. Ele não garante que o hardware suporte esse número com determinado plugin, mapa ou padrão de exploração. Teste carga e monitore recursos antes de anunciar capacidade.

Entenda as opções que parecem protetoras

max-world-size não é igual a definir uma fronteira jogável. Limita dimensões associadas à geração, enquanto o limite visível e os comandos de fronteira têm funcionamento próprio. Se quer restringir exploração, configure e teste o recurso correto, incluindo centro e diâmetro.

max-tick-time controla quando o watchdog considera um tick travado e encerra o processo. Aumentar ou desativar o limite não corrige travamento; pode apenas adiar a detecção e prolongar a indisponibilidade. Investigue o relatório ou log que identifica o trabalho que ocupava a thread principal.

Valide sintaxe e comportamento

O arquivo usa pares chave=valor. Preserve comentários e nomes de propriedades, use um valor permitido e evite duplicar a mesma chave. Um arquivo salvo com codificação estranha ou caractere extra pode ser interpretado de forma inesperada. Faça uma alteração pequena e identificável, não uma reformatação completa.

Inicie o servidor e leia o console desde o começo. Confira warnings, portas, autenticação e mundo selecionado. Conecte com uma conta de teste e verifique o comportamento: iniciar sem erro não prova que a configuração está correta. Para mudanças de acesso, valide de fora da rede local quando isso for seguro e permitido.

Guarde a configuração aprovada

Mantenha uma cópia da configuração testada junto com a versão e a data. Se o ajuste tiver resultado errado, pare, restaure a cópia, reinicie e confirme a recuperação. Registre a razão das mudanças que afetam segurança, mundo ou experiência para que uma manutenção futura não desfaça uma decisão deliberada.

Consulte a referência de server.properties, a documentação de argumentos de linha de comando e a página de configuração Paper. Valores encontrados em guias antigos podem ter mudado.

Revise também a exposição de informações

log-ips influencia se endereços são registrados no log. Isso pode ajudar a investigar um incidente, mas logs de acesso também são dados operacionais que precisam de retenção e acesso definidos. Se a equipe não precisa desse detalhe, avalie o padrão e documente a necessidade antes de ampliar coleta ou compartilhamento de arquivos.

Confira opções de status, query, resource pack e links públicos conforme o uso do servidor. Desligar um indicador pode tornar a lista de servidores menos informativa sem afetar conexão direta, então teste de um cliente externo. Exigir resource pack altera a entrada dos jogadores; confira URL, hash e comportamento do cliente antes de tornar a exigência obrigatória.

Fontes e referências

Documentação consultada em 2026-10-08. Os exemplos precisam ser conferidos na versão instalada; este guia não afirma que a configuração foi testada no seu ambiente.