Este guia aborda como configurar seu servidor Project Zomboid hospedado na Legion Hosting — incluindo o arquivo de configurações do servidor e variáveis de sandbox através do GPanel.
Pare seu servidor antes de editar qualquer arquivo de configuração. Project Zomboid grava sua configuração no disco ao desligar. Se você editar arquivos enquanto o servidor estiver em execução, suas alterações serão sobrescritas quando o servidor parar novamente. Sempre pare o servidor no GPanel primeiro, faça suas alterações e depois inicie-o novamente.
Visão Geral dos Arquivos de Configuração
Project Zomboid armazena a configuração do servidor em dois arquivos dentro do diretório /.cache/server/ no seu servidor. Ambos os arquivos usam o nome do seu servidor como parte do nome do arquivo.
| Arquivo | Finalidade |
|---|---|
/.cache/server/servername.ini |
Configurações principais do servidor — senha, slots de jogadores, portas, PvP, chat de voz e mais |
/.cache/server/servername_SandboxVars.lua |
Configurações de gameplay e mundo — população de zumbis, abundância de loot, velocidade, taxas de respawn |
Qual é o nome do meu servidor? O nome do servidor é definido na aba Startup no GPanel. O padrão é
servertest a menos que você o tenha alterado. Se não tiver certeza, verifique a aba Startup do GPanel — é o valor no campo Server Name.
Passo 1 — Abrir o Gerenciador de Arquivos no GPanel
- Faça login no GPanel.
- Clique no seu servidor Project Zomboid na lista de servidores.
- Na aba Console, clique em Stop se o servidor estiver em execução. Aguarde o status mudar para Offline antes de continuar.
- Clique na aba Files para abrir o gerenciador de arquivos.
- Navegue até o diretório
.cache/server/. Você pode precisar clicar em Show Hidden Files ou alternar a visibilidade de arquivos ocultos se a pasta.cachenão estiver visível — ela começa com um ponto.
Passo 2 — Editar o Arquivo de Configurações do Servidor (.ini)
O arquivo .ini controla a configuração principal do servidor. Clique no arquivo para abri-lo no editor inline.
Configurações Mais Alteradas
| Configuração | Descrição | Valor de Exemplo |
|---|---|---|
PublicName |
O nome do servidor exibido no navegador público de servidores | My PZ Server |
PublicDescription |
Descrição curta exibida no navegador de servidores | Welcome! Friendly server. |
Password |
Senha que os jogadores devem inserir para entrar. Deixe em branco para sem senha. | hunter2 |
MaxPlayers |
Número máximo de jogadores simultâneos | 16 |
PVP |
Ativar ou desativar combate jogador contra jogador | true ou false |
Public |
Se o servidor aparece na lista pública de servidores | true ou false |
DefaultPort |
Porta UDP na qual o servidor escuta (padrão 16261). Deve corresponder à porta atribuída pelo GPanel. | 16261 |
Map |
Nome do mapa. Use Muldraugh, KY para o mapa padrão. Adicione mapas de mods separados por ponto e vírgula. |
Muldraugh, KY |
Mods |
Lista de Mod IDs separados por ponto e vírgula. Formato B41: modid1;modid2. Formato B42: \modid1;\modid2; |
2392509783;2400857388 |
WorkshopItems |
IDs de itens da Workshop separados por ponto e vírgula (deve corresponder à lista Mods) |
2392509783;2400857388 |
Mods e WorkshopItems devem estar sincronizados. Cada mod ID listado em
Mods deve ter uma entrada correspondente em WorkshopItems. Uma incompatibilidade é uma causa comum de falhas na inicialização do servidor após adicionar mods.
Após fazer suas alterações, clique em Save no editor de arquivos. Não inicie o servidor ainda se você também quiser editar as variáveis de sandbox — complete o Passo 3 primeiro.
Passo 3 — Variáveis de Sandbox (Configurações de Gameplay)
As variáveis de sandbox controlam a experiência de gameplay: quantos zumbis aparecem, quão rápido eles se movem, raridade de loot e dezenas de outros parâmetros do mundo. Elas ficam em servername_SandboxVars.lua no mesmo diretório /.cache/server/.
Recomendado: Use o painel de admin do jogo em vez de editar este arquivo diretamente. O painel de admin do jogo fornece controles deslizantes e menus suspensos rotulados para cada opção de sandbox, tornando muito mais fácil encontrar e alterar configurações sem erros de digitação. A edição de arquivos é uma alternativa para alterações em massa ou quando o servidor nunca foi iniciado. Para acessá-lo, use o painel de admin do jogo (pressione Esc enquanto estiver no jogo como admin).
Editando o Arquivo SandboxVars Diretamente
Se você preferir editar o arquivo, o formato é uma tabela Lua. Cada configuração está em sua própria linha:
SandboxVars = {
Zombies = 3, -- Population: 1=Insane, 2=Very High, 3=High, 4=Normal, 5=Low
Distribution = 2, -- Zombie distribution: 1=Urban focused, 2=Uniform
ZombieSpeedType = 3, -- Speed: 1=Sprinters, 2=Fast Shamblers, 3=Shamblers, 4=Crawlers
LootAbundance = 3, -- Loot: 1=Insane, 2=Abundant, 3=Normal, 4=Scarce, 5=Very Scarce
DayLength = 2, -- In-game day length in hours: 1=1h, 2=2h ... 15=15h, 16=Real Time
StartYear = 1, -- Starting year (offsets from 1993)
StartMonth = 7, -- Starting month (1–12)
StartDay = 9, -- Starting day (1–31)
WaterShut = 0, -- Tap water shutoff: 0=Never, 1=Instant ... 14=2 years
ElecShut = 0, -- Electricity shutoff: 0=Never, 1=Instant ... 14=2 years
HoursForCorpseRemoval = 0, -- 0=Never auto-remove
CharacterFreePoints = 0, -- Bonus starting trait points
}
Configurações de sandbox se aplicam apenas a novos mundos. Se seu servidor já executou e criou um mundo, alterar variáveis de sandbox no arquivo não altera retroativamente o mundo ativo. Para aplicar novas configurações de sandbox, você deve limpar o mundo e começar do zero. Se você quiser apenas ajustar configurações controláveis pelo admin durante o jogo, use o painel de admin do jogo.
Solução de Problemas
Minhas alterações no arquivo .ini não foram salvas
- A causa mais provável é que o servidor ainda estava em execução quando você salvou o arquivo. Project Zomboid sobrescreve a configuração ao desligar. Pare o servidor primeiro, edite o arquivo, salve-o e depois inicie o servidor.
- Confirme que você salvou o arquivo no editor do GPanel antes de navegar para outra página — procure por uma confirmação ou verifique se o timestamp de última modificação do arquivo foi atualizado.
Não consigo ver a pasta .cache no gerenciador de arquivos
- Diretórios ocultos (aqueles que começam com um ponto) não são exibidos por padrão. Procure por um botão Show Hidden Files ou caixa de seleção na aba Files do GPanel e ative-o.
- Se o diretório não existir, o servidor ainda não foi executado. Inicie e pare o servidor uma vez para gerar os arquivos de configuração, depois edite-os.
As configurações de sandbox não estão mudando no mundo ativo
- Alterações no arquivo
_SandboxVars.luasó têm efeito em um novo mundo. Para um mundo existente em execução, use a aba Options do painel de admin do jogo para ajustar configurações sem precisar limpar o mundo.
Precisa de mais ajuda? Abra um ticket de suporte e inclua o ID do seu servidor do GPanel junto com qualquer saída relevante do console.
