O server.properties do Minecraft explicado

O server.properties é o principal arquivo de configuração de um servidor da Java Edition. Ele fica na pasta do servidor, é criado na primeira inicialização e controla a porta, o mundo, a dificuldade, a segurança e o desempenho. Este guia explica as opções que importam, com valores sensatos e o que dá errado quando você as altera.

Como o arquivo funciona

• Cada linha é key=value, sem espaços em volta do sinal de igual.
• Pare o servidor antes de editar. A maioria das mudanças só vale depois de reiniciar, e o servidor pode sobrescrever o arquivo quando é desligado.
• Linhas que começam com # são comentários.
• Se você apagar o arquivo, o servidor cria um novo com os valores padrão na próxima inicialização.
• Paper, Spigot e Purpur também leem este arquivo e adicionam as suas próprias configurações em outros arquivos, como o spigot.yml e a pasta de configuração do Paper.

Os valores abaixo são para o Java 1.20 e 1.21. Desde a 1.21.9, pvp, allow-nether, spawn-monsters e enable-command-block não são mais propriedades do servidor: viraram regras de jogo que você altera dentro do jogo com /gamerule. Em versões mais antigas, elas ainda estão neste arquivo.

Configurações de conexão

server-port: se você mudar, os jogadores precisam adicionar a porta ao endereço (play.example.com:25570), a não ser que você configure um registro SRV. Você também precisa abrir a nova porta. Veja IP e porta de servidor de Minecraft.

max-players: colocar um valor muito alto não deixa o servidor mais rápido nem mais popular. Coloque um número que o seu hardware realmente aguente, para o servidor recusar jogadores em vez de travar para todo mundo.

motd: aceita códigos de cor escritos como \u00A7 seguido de um código, por exemplo \u00A7a para verde, e \n para a segunda linha. Escrever isso à mão é chato; o nosso gerador de MOTD monta a linha para você.

enable-status: se você colocar false, o servidor aparece como offline na lista do Multijogador e nas listas de servidores, mesmo que os jogadores ainda consigam entrar. Deixe ativado em um servidor público.

network-compression-threshold: deixe em 256 na maioria dos servidores. -1 desativa a compressão, o que só faz sentido quando o servidor e os jogadores (ou um proxy) estão na mesma rede local rápida. Valores muito baixos usam mais CPU sem benefício real.

Configurações do mundo

• level-name (padrão world): o nome da pasta do mundo. Mude para carregar outra pasta de mundo.
• level-seed: a seed de um mundo novo. Não faz nada em um mundo que já existe.
• level-type (padrão minecraft:normal): outros valores são minecraft:flat, minecraft:large_biomes, minecraft:amplified e minecraft:single_biome_surface. Assim como a seed, só vale quando o mundo é criado. Mundos amplificados pesam muito mais na CPU.
• generator-settings: JSON para mundos planos personalizados. Deixe vazio, a não ser que você saiba que precisa.
• generate-structures (padrão true): vilas, templos e outras estruturas.
• max-world-size: o raio da borda do mundo em blocos. Em servidores públicos, uma borda menor junto com um mundo pré-gerado mantém o uso de disco e o lag sob controle.
• allow-nether (1.21.8 e anteriores): desativa o Nether quando está em false. Em servidores baseados em Bukkit, o End é controlado pelo allow-end no bukkit.yml.

Para começar um mundo novo com outra seed ou outro tipo, pare o servidor, mude o valor e renomeie ou remova as pastas do mundo antigo. Faça um backup antes.

Configurações de jogo

difficulty: a maioria dos servidores de sobrevivência usa normal ou hard. O pacífico remove os mobs hostis e o dano por fome, o que quebra farms de mobs e muitos objetivos da sobrevivência.

allow-flight: coloque true se você usa plugins de voo, jogabilidade com muita elytra e lag, ou certas montarias. Caso contrário, os jogadores podem ser expulsos por “voar” quando o servidor está só travando. Plugins de anticheat pegam hacks de voo de verdade muito melhor do que essa configuração.

spawn-protection: a área protegida é um quadrado em volta do spawn do mundo, e os operadores a ignoram. Ela só funciona quando pelo menos um jogador é operador. Muitos servidores colocam 0 e protegem o spawn com o WorldGuard, que dá um controle mais fino sobre o que os jogadores podem fazer ali.

Configurações de desempenho

view-distance vs simulation-distance: a distância de visão é quantos chunks em volta de cada jogador são enviados para o cliente dele, para que ele possa vê-los. A distância de simulação é quantos chunks em volta de cada jogador realmente rodam: os mobs se movem, as plantações crescem, a redstone e as fornalhas funcionam. A simulação é a parte cara, então uma configuração comum é uma distância de visão moderada com uma distância de simulação menor. Os jogadores continuam vendo longe, mas o servidor só trabalha perto deles. Uma distância de simulação muito baixa quebra farms que precisam do jogador por perto, então não desça abaixo de 4 em um servidor de sobrevivência.

entity-broadcast-range-percentage: a que distância os jogadores conseguem ver entidades, como porcentagem do alcance padrão (10 a 1000). Diminuir reduz o tráfego de rede em servidores cheios, mas os jogadores veem mobs e outros jogadores aparecerem mais tarde, o que faz diferença no PvP.

sync-chunk-writes: quando true, os chunks são salvos de forma síncrona, o que é mais seguro se o servidor travar. Colocar false pode deixar o salvamento mais rápido, mas você corre o risco de perder mudanças recentes em um crash. Deixe ativado, a não ser que saiba por que está mudando.

max-tick-time: se um tick demorar mais que esse número de milissegundos, o watchdog para o servidor, porque ele provavelmente congelou. -1 desativa o watchdog. Não o desative para esconder crashes; encontre a causa com um profiler. Como reduzir o lag em um servidor de Minecraft explica como.

Na 1.21.2 e mais recentes, pause-when-empty-seconds pausa o servidor depois que ele fica vazio por esse número de segundos. Isso economiza recursos em um servidor privado, mas em um servidor público alguns plugins e timers esperam que o mundo continue rodando.

Configurações de segurança

online-mode

online-mode=true (o padrão) faz o servidor verificar a conta de cada jogador com a Mojang. Mantenha ativado.

Com online-mode=false (modo offline), o servidor confia em qualquer nome que o cliente enviar. Qualquer um pode entrar como qualquer jogador, inclusive você ou a sua staff, e pegar o inventário, os terrenos e as permissões dele. Plugins que usam UUIDs também veem UUIDs diferentes dos do modo online, então trocar depois bagunça os dados dos jogadores.

A única exceção normal é um servidor atrás de um proxy como o Velocity: nesse caso, o proxy roda em modo online e os servidores de backend rodam em modo offline com encaminhamento das informações dos jogadores, e os backends só devem aceitar conexões vindas do proxy. Veja como configurar uma rede Velocity.

enforce-secure-profile

Padrão true. Os jogadores precisam ter uma chave de perfil assinada pela Mojang para entrar, usada no chat assinado. Se alguns jogadores não conseguem entrar com uma mensagem sobre chave pública ausente, ou se você usa certas configurações de chat ou de proxy, os donos às vezes colocam false. Deixe em true, a não ser que tenha um motivo específico.

Whitelist

• white-list (padrão false): só jogadores na whitelist podem entrar.
• enforce-whitelist (padrão false): quando true, jogadores online que não estão na lista são expulsos assim que a whitelist é recarregada.

Você também pode ativá-la dentro do jogo com /whitelist on. O passo a passo completo está em como colocar whitelist em um servidor de Minecraft.

Query e RCON

enable-query (padrão false) ativa o protocolo de query GameSpy4 na query.port (UDP, 25565 por padrão). Algumas ferramentas e listas o usam para ler os plugins e os nomes dos jogadores. É opcional; os pings de status funcionam sem ele.

enable-rcon (padrão false) permite acesso remoto ao console na rcon.port (TCP, 25575 por padrão) com a rcon.password. O RCON envia comandos com o poder total do console, e a senha não é criptografada. Se você usar:

• Use uma senha longa e aleatória.
• Nunca abra nem exponha a porta do RCON para a internet. Só permita o acesso da mesma máquina ou de uma rede privada.
• Se não precisar dele, deixe desativado.

Outras opções de segurança

• op-permission-level (padrão 4): o que os operadores podem fazer. 4 permite tudo, inclusive parar o servidor.
• prevent-proxy-connections (padrão false): expulsa jogadores cuja conexão parece vir de uma VPN ou proxy, comparando os endereços com os da Mojang. Pode bloquear jogadores legítimos.
• rate-limit (padrão 0): expulsa clientes que enviam pacotes demais por segundo. 0 desativa.
• log-ips (padrão true, 1.20.2+): se os endereços IP dos jogadores são gravados no log.
• accepts-transfers (padrão false, 1.20.5+): se o servidor aceita jogadores enviados de outro servidor com o pacote de transferência.

Configurações de resource pack

• resource-pack: uma URL de download direto para um arquivo zip. Links para páginas de download não funcionam; a URL precisa retornar o próprio arquivo.
• resource-pack-sha1: o hash SHA-1 do zip. Ele permite que os clientes guardem o pack em cache e percebam quando ele mudou. Atualize toda vez que mudar o arquivo.
• require-resource-pack: se true, jogadores que recusam o pack são desconectados.
• resource-pack-prompt: uma mensagem personalizada exibida no aviso de download.

Só exija um pack se o seu servidor realmente precisar dele, e mantenha-o pequeno. Um pack grande e obrigatório é mais um motivo para um jogador novo desistir. Jogadores do Bedrock que entram pelo Geyser precisam de um pack convertido.

Um ponto de partida sensato

Para um pequeno servidor público de sobrevivência no Paper:

server-port=25565
online-mode=true
enforce-secure-profile=true
max-players=50
difficulty=normal
view-distance=8
simulation-distance=6
spawn-protection=0
white-list=false
enable-status=true
enable-query=false
enable-rcon=false
network-compression-threshold=256
max-tick-time=60000
sync-chunk-writes=true

Ajuste max-players, view-distance e simulation-distance ao seu hardware e observe como o servidor se comporta com jogadores online. Depois de mudar as configurações, reinicie e confira se o servidor ainda aparece corretamente com o verificador de status de servidor.