Instalar mods de 7 Days to Die – servidor e cliente

Instalas mods para 7 Days to Die de forma fiável se primeiro esclareceres o tipo de mod, parares o servidor, criares um backup e colocares cada mod como uma pasta própria em /Mods. O essencial é a estrutura correta de pastas com ModInfo.xml, versões compatíveis do jogo e do mod, bem como um teste limpo com um cliente configurado de forma compatível.

Requisitos

Antes de adicionares mods, deves ter acesso aos ficheiros do servidor, à consola do servidor ou aos logs e à tua instalação local de 7 Days to Die. Planeia também um backup: pelo menos o estado do mundo, a configuração do servidor e a pasta Mods existente devem ser guardados. Num servidor game-serverhosting alugado, normalmente fazes a transferência de ficheiros, reinício e controlo através dos métodos de gestão disponibilizados; ainda assim, continua a ser importante não forçar alterações enquanto o jogo está em funcionamento.

Como referência técnica, a documentação oficial da wiki de 7 Days to Die é útil. A página sobre a Mod Interface descreve que os mods pertencem a uma pasta Mods no diretório principal do jogo e que cada mod precisa da sua própria pasta com ModInfo.xml: documentação em 7daystodie.wiki.gg. Para modlets, o guia oficial acrescenta que a pasta do mod é reconhecida através do ModInfo.xml incluído: documentação em 7daystodie.wiki.gg.

Identificar tipos de mod

Os XML modlets alteram frequentemente dados de configuração como itens, receitas, loot, blocos ou balanceamento. Alterações puramente em XML podem funcionar do lado do servidor assim que o servidor as carrega ao iniciar. No entanto, se um mod incluir ícones próprios, asset bundles, ficheiros de UI ou componentes de código, muitas vezes os clientes também têm de instalar o mesmo mod. Por isso, não te fies apenas no nome do mod; lê as instruções de instalação do respetivo mod.

Os overhaul mods intervêm de forma muito mais profunda. Muitas vezes alteram progressão, crafting, inimigos, geração de mundo, UI e objetos. Estes pacotes normalmente têm de ser instalados no servidor e no cliente exatamente na versão compatível. Já os mods server-only são pensados para administração, logging, moderação ou regras do lado do servidor e dispensam instalação no cliente, desde que a documentação do mod não exija outra coisa.

Instalar modlets

1. Transfere o modlet, por exemplo de 7daystodiemods.com, e verifica a compatibilidade com a tua versão de 7 Days to Die.
2. Para completamente o servidor. Um reinício não basta se os ficheiros forem substituídos durante o processo em execução.
3. Extrai o arquivo localmente e abre a pasta extraída. Procura por ModInfo.xml.
4. Copia a pasta que contém diretamente o ModInfo.xml para o diretório /Mods do servidor.
5. Se /Mods ainda não existir, cria a pasta no diretório principal do servidor, não dentro de Data ou Config.
6. Reinicia o servidor e verifica o log à procura de erros de carregamento de mods.

A causa de erro mais comum é uma camada adicional de empacotamento. Por exemplo, /Mods/MinhaMod-v1/MinhaMod/ModInfo.xml estaria errado se a pasta real do mod for MinhaMod. Nesse caso, o correto é /Mods/MinhaMod/ModInfo.xml.

Implementar overhaul mods corretamente

Com overhaul mods, deves trabalhar de forma especialmente rigorosa. Primeiro verifica se o mod é compatível com a versão instalada de 7 Days to Die. Depois instala-o no servidor e em cada cliente conforme as instruções do respetivo projeto do mod. Se um overhaul mod exigir o seu próprio launcher ou passos adicionais de instalação, segue essas instruções em vez de uma instalação genérica de modlet.

Para mundos existentes, aplica-se o seguinte: grandes overhauls podem alterar fortemente estados de mundo, progressão e objetos. Sempre que possível, começa com um mundo novo ou testa o mod numa cópia separada. Em servidores comunitários produtivos, faz sentido definir uma janela de manutenção clara, para que os jogadores saibam de que mods de cliente precisam e quando o servidor volta a estar disponível.

Mods Server-Only

Estes mods não precisam de instalação no cliente, desde que a respetiva versão do mod e a documentação o confirmem:

• Server Tools – ferramentas de administração
• Allocs Server Fixes – desempenho e mapa web
• CSMM – gestão do servidor

Os mods server-only são especialmente práticos para tarefas administrativas, porque os jogadores não precisam de instalar ficheiros por conta própria. Ainda assim, depois de cada alteração deves verificar se o mod é compatível com a versão atual do servidor e se causa conflitos com ferramentas já instaladas.

Verificar o resultado

Depois do reinício, liga-te primeiro tu próprio ao servidor. Verifica se o servidor aparece na lista, se a entrada funciona e se o mundo carrega sem mensagens de erro. Depois testa especificamente aquilo que o mod deve alterar: novos itens, receitas, janelas de UI, comandos, zombies, tabelas de loot ou funções de administração.

Verifica também os logs do servidor. Avisos sobre ModInfo.xml em falta, erros de XML, caminhos inválidos ou conflitos de versão indicam que o mod não foi carregado corretamente. Se estiverem instalados vários mods, testa os problemas individualmente: primeiro remove todos os mods novos e depois reativa um mod de cada vez.

Troubleshooting

O mod não é carregado

Verifica primeiro a estrutura de pastas. O ficheiro ModInfo.xml tem de estar diretamente na respetiva pasta do mod. Além disso, a pasta Mods pertence ao diretório principal da instalação do servidor. Se estiver em Data, Config ou numa subcamada adicional do arquivo, muitas vezes o mod não é reconhecido.

Os jogadores não conseguem entrar

Neste caso, normalmente falta no cliente um mod necessário, ou o servidor e o cliente usam versões diferentes. Compara a lista de mods, a versão do jogo e os caminhos de instalação. Em overhauls, todos os jogadores devem usar a mesma versão do pacote.

O servidor já não inicia depois de um mod

Para o servidor, remove de /Mods o último mod instalado e inicia novamente. Se o servidor voltar a funcionar, verifica a documentação do mod, as dependências e a compatibilidade. Restaura o backup se os ficheiros do mundo tiverem sido danificados ou se o mod não puder ser removido sem deixar resíduos.

Vários mods substituem os mesmos conteúdos

Os conflitos surgem frequentemente quando vários mods alteram as mesmas áreas de XML, ficheiros de UI ou sistemas de progressão. Reduz a lista de mods aos pacotes necessários e testa a ordem ou a combinação. Com grandes overhauls, só deves usar mods adicionais de gameplay se forem expressamente compatíveis.

Outros guias de modding

Se geres vários servidores de survival, processos semelhantes também ajudam noutros jogos. Para verificações cruzadas de mods de cliente e servidor, encontras guias adequados sobre instalar mods de Palworld, mods de servidor V Rising BepInEx e instalar mods de Factorio no servidor. Os detalhes variam, mas backup, verificação de versões e um reinício controlado continuam a ser os passos de trabalho mais importantes.

Verificação, limites e caminho seguro de retorno

O guia “Instalar mods de 7 Days to Die – servidor e cliente” aplica-se ao tipo de servidor descrito no artigo e ao estado de versões visível no momento da verificação. Nomes de menus, versões disponíveis, compatibilidade de mods ou plugins e recursos necessários podem mudar depois de atualizações. Por isso, não transfiras valores para outra versão de jogo, loader ou servidor sem os verificar.

Cria um backup dos ficheiros afetados antes de alterares mundo, progresso, configuração ou extensões. Depois altera apenas um passo relacionado de cada vez e verifica-o com a mesma versão de cliente e servidor com que pretendes jogar mais tarde.

Um teste individual bem-sucedido não é uma garantia de desempenho ou disponibilidade. Tamanho do mundo, mods, plugins, número de jogadores, rota de rede e carga simultânea podem alterar o resultado. Documenta a versão, a alteração e o resultado do teste, para conseguires compreender desvios posteriores.

FAQ

Todos os jogadores têm de instalar mods de 7 Days to Die?

Nem sempre. Mods administrativos puramente do lado do servidor geralmente não precisam de cliente. Overhauls e mods com assets, alterações de UI ou ficheiros próprios normalmente também têm de ser instalados por todos os jogadores.

Onde fica a pasta Mods correta?

A pasta chama-se Mods e fica no diretório principal da instalação de 7 Days to Die ou do Dedicated Server. Não pertence a Data nem a Config.

Posso instalar mods num mundo existente?

Modlets pequenos podem funcionar, mas ainda assim deves criar antes um backup. Sempre que possível, deves testar grandes overhauls com um mundo novo, porque podem alterar fortemente progressão, itens e comportamento do mundo.

O que faço em caso de conflito de versões?

Verifica primeiro a versão do jogo, a versão do mod e as instruções de instalação do mod. Não atualizes todos os mods ao mesmo tempo às cegas; testa alterações individualmente e mantém um backup funcional disponível.

Posso combinar vários overhaul mods?

Na maioria dos casos, isso não é uma boa base para um servidor estável. Overhauls alteram muitos sistemas centrais ao mesmo tempo. Combina-os apenas se os projetos de mod envolvidos suportarem expressamente essa combinação.