Instalar mods de Don't Starve Together – servidor e cliente

Instalas mods para Don't Starve Together num Dedicated Server em dois passos: primeiro deixas o servidor descarregar os mods desejados do Workshop através dos seus IDs; depois ativas e configuras esses mods no ficheiro modoverrides.lua correto. É importante tratar os shards Master e Caves separadamente e, após cada alteração, verificar sempre com um reinício.

Requisitos

Precisas de acesso aos ficheiros de configuração do teu servidor de Don't Starve Together e deves parar o servidor antes de fazer alterações. Na game-serverhosting, o fluxo de trabalho recomendado é: editar ficheiros, guardar a alteração, reiniciar o servidor, verificar o log e só depois adicionar mais mods. Assim fica claro qual mod é responsável quando surgem problemas.

A referência oficial para operar um Dedicated Server é o guia da Klei no fórum do fabricante: documentação em forums.kleientertainment.com. Para mods, a respetiva página do Steam Workshop também é relevante, porque lá encontras o autor do mod, o Workshop-ID, dependências e notas sobre uso no servidor ou no cliente.

Se ainda estás a configurar o próprio servidor, o guia interno Alugar e configurar um servidor de Don't Starve Together encaixa bem. Para fluxos de mods semelhantes noutros jogos, Instalar mods de Factorio no servidor e Instalar mods de V Rising com BepInEx são bons pontos de comparação.

Encontrar Workshop-IDs

Cada mod do Steam Workshop tem um ID numérico. Encontras esse ID no URL da página do Workshop, normalmente como valor depois de id=. Exemplo: num URL como steamcommunity.com/sharedfiles/filedetails/?id=378160973, 378160973 é o Workshop-ID.

Anota apenas os mods que queres mesmo usar no servidor. Muitos mods de conveniência são apenas do lado do cliente e não pertencem à configuração do servidor. Outros mods alteram o mundo, o equilíbrio, a interface ou o inventário e precisam de ser ativados no servidor. Por isso, verifica sempre a descrição do mod e as notas do autor.

Configurar mods pelo Workshop

Insere os mods que o servidor deve descarregar em dedicated_server_mods_setup.lua. Esse ficheiro é a lista de downloads. Ele ainda não ativa os mods no teu mundo; primeiro garante apenas que o Dedicated Server conhece os conteúdos do Workshop.

-- Mods que devem ser descarregados
ServerModSetup("378160973")    -- Global Positions
ServerModSetup("462434129")    -- Wormhole Marks
ServerModSetup("458587300")    -- Season Clock
ServerModSetup("375850593")    -- Extra Equip Slots

Tem atenção a aspas corretas, sem espaços adicionais no ID e sem entradas duplicadas. Comentários atrás das linhas são úteis, porque mais tarde consegues ver imediatamente que ID pertence a que mod.

Ativar e configurar mods

Os mods são ativados em modoverrides.lua. Esse ficheiro define quais mods descarregados do Workshop ficam ativos no mundo. Num servidor com Caves, precisas da configuração para Master e Caves, porque ambos os shards podem usar definições próprias.

Em modoverrides.lua (para Master e Caves):

return {
  ["workshop-378160973"] = { enabled = true },
  ["workshop-462434129"] = { enabled = true },
  ["workshop-458587300"] = {
    enabled = true,
    configuration_options = {
      clock_style = "analog"
    }
  }
}

A chave é composta por workshop- mais o Workshop-ID. enabled = true ativa o mod. Se um mod suportar opções próprias, elas pertencem a configuration_options. As opções válidas não são gerais; dependem do mod em questão. Por isso, usa apenas opções que apareçam na descrição do Workshop, em configurações de exemplo existentes ou numa configuração gerada pelo jogo.

Mods populares

A tabela seguinte mantém os mods de exemplo existentes. Não é uma lista de recomendações com promessas de desempenho ou estabilidade, mas sim um ponto de partida prático para tipos de mods usados com frequência.

Adiciona mods novos um de cada vez e testa após cada reinício. Mods que alteram inventário, combate, geração do mundo ou interface podem influenciar-se entre si. Um processo passo a passo poupa bastante tempo quando há conflitos.

Mods de cliente vs. mods de servidor

• Mods de servidor: Têm de estar instalados no servidor
• Mods de cliente: Têm de estar instalados no jogador
• Dos dois lados: Têm de estar instalados em ambos

A maioria dos mods é dos dois lados – os jogadores descarregam-nos automaticamente ao ligar. Mesmo assim, não deves assumir que todos os mods funcionam sem mais nada. Alguns mods exigem definições específicas no cliente; outros servem apenas para funções locais de conveniência e não devem ir para os ficheiros do servidor.

Verificar o resultado

Reinicia o servidor após a alteração e observa o arranque. Um teste limpo tem três partes: o servidor arranca sem erros de Lua, o mundo fica acessível e um jogador consegue ligar sem ficar preso num ciclo de download de mods ou de erros.

Depois verifica no jogo se a função desejada está realmente ativa. Com Global Positions, por exemplo, deves ver se as posições dos jogadores aparecem no mapa como esperado. Em Caves, testa também a mudança entre superfície e cavernas, porque muitas vezes um erro só fica visível num shard.

Resolução de problemas

• Mods não carregam: verificar os Workshop-IDs
• Crash: desativar os mods individualmente
• Mods de Caves: modoverrides.lua nas DUAS pastas de shard!

Se o servidor deixar de arrancar depois de um mod novo, remove primeiro a última linha alterada em modoverrides.lua e reinicia. Se o erro continuar, verifica também dedicated_server_mods_setup.lua, especialmente parênteses, aspas e vírgulas em tabelas Lua.

Se os jogadores ficarem presos ao ligar, um mod pode estar desatualizado, pode faltar uma dependência ou pode ser necessário um componente no cliente. Nesse caso, abre a página do Workshop do mod e verifica as notas do autor. Se adicionaste vários mods novos, não os desatives todos permanentemente; divide a lista ao meio para testar até isolares a causa.

Em problemas com Caves, a causa mais comum é uma configuração diferente entre o shard Master e o shard Caves. Não copies definições às cegas; verifica se o mod foi pensado para ambos os shards. Mods de geração de mundo muitas vezes pertencem a uma categoria diferente dos mods puramente de interface ou conveniência.

Verificação, limites e caminho seguro de retorno

O guia “Instalar mods de Don't Starve Together – servidor e cliente” aplica-se ao tipo de servidor descrito no artigo e à versão 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 após atualizações. Por isso, não transfiras valores para outra versão do jogo, loader ou servidor sem verificar.

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

Um teste individual bem-sucedido não é garantia de desempenho nem de 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 entender desvios futuros.

FAQ

Tenho de reiniciar o servidor após cada alteração de mod?

Sim. Alterações em dedicated_server_mods_setup.lua e modoverrides.lua só entram em vigor de forma fiável depois de reiniciares o servidor.

Onde insiro o Workshop-ID?

A lista simples de downloads vai para dedicated_server_mods_setup.lua. Depois, o mod é ativado em modoverrides.lua através da chave workshop-ID, por exemplo workshop-378160973.

Preciso do mesmo modoverrides.lua para Caves?

Se o teu servidor usa Caves, tens de considerar a configuração de mods para ambos os shards. Muitos setups precisam de um modoverrides.lua na pasta Master e de outro na pasta Caves.

Os jogadores descarregam mods de servidor automaticamente?

Em muitos mods dos dois lados, o cliente descarrega automaticamente os conteúdos necessários ao ligar. Mas isso não substitui a verificação de que o mod está atualizado, combina com o servidor e não tem notas adicionais do autor.

O que faço se um mod fizer o servidor crashar?

Desativa primeiro o mod adicionado mais recentemente e reinicia o servidor. Se vários mods foram alterados ao mesmo tempo, testa-os individualmente ou em pequenos grupos até o conflito ficar claro.