Mods: Instalar, Criar e Solucionar Guide

Mods expand Timberborn com novos prédios, alterações na interface, mapas e mecânicas de jogo; eles são essenciais para jogadores que querem melhorias de qualidade de vida, conteúdo da comunidade ou sistemas inteiros novos. Esta página explica como mods são distribuídos, instalados, criados e solucionados, além de tipos recomendados e práticas seguras.

O que os mods podem fazer

Adicionar novos prédios, recursos e biomas usando a Mod API oficial.
Fornecer melhorias de QoL e na interface (sobreposições de gerenciamento de beavers, sobreposições de água, pular a introdução, auxiliares de automação).
Disponibilizar novos mapas e ativos do editor de mapas (posições iniciais personalizadas, rios, terreno, posicionamento de recursos).
Introduzir sistemas de jogabilidade (trens, ferramentas de terreno expandidas, modo criativo).
Expor pontos de integração avançados (HTTP Lever / HTTP Adapter para automação e monitoramento externos).

O ecossistema de mods de Timberborn varia de pequenos ajustes cosméticos e sobreposições a grandes pacotes de conteúdo que alteram a progressão no fim do jogo.

Onde encontrar mods

Steam Workshop — assinatura com um clique para jogadores Steam; a fonte mais popular para mapas, tails e muitos mods.
mod.io — o hub multiplataforma oficial integrado ao cliente do jogo.
Thunderstore — comum para usuários de BepInEx/BepInExPack e algum conteúdo legado.
Nexus Mods e canais de Discord da comunidade — uploads adicionais, gráficos, templates e ajuda.

Recursos da comunidade também reúnem listas populares ou recomendadas (por exemplo, BeaverBuddy, Water Overlay Enhanced, TimberbornTerrainTools, ChooChoo train mod).

Como instalar mods

Instalação integrada no jogo / plataforma (recomendado)

Steam Workshop: subscreva os itens; eles são baixados automaticamente. Inicie Timberborn, abra o menu Mods e ative os mods subscritos.
mod.io: navegue dentro do jogo ou no mod.io, siga as instruções da plataforma e então ative os mods no menu Mods do jogo.

Instalação manual

Baixe o arquivo do mod ou os arquivos.
Extraia para a sua pasta de Mods do Timberborn:
- Windows: %USERPROFILE%\Documents\Timberborn\Mods
- macOS: ~/Library/Application Support/Timberborn/Mods
- Linux: ~/.local/share/Timberborn/Mods
Inicie o jogo e ative o mod no menu Mods, se necessário.

Requisito BepInEx / BepInExPack

Muitos mods (especialmente mods de código) requerem BepInEx ou o BepInExPack da comunidade para Timberborn. Instale o BepInExPack extraindo seu conteúdo na pasta do jogo Timberborn e execute o jogo uma vez para completar a configuração. Siga a documentação do BepInEx para desenvolvimento de plugins e uso avançado.

Criando mods

Mods de código são escritos em C# para Unity usando o modding SDK de Timberborn e BepInEx. Espera-se um entendimento elementar de C# e familiaridade com tutoriais de plugins BepInEx.
O modding SDK fornece templates, exemplos e documentação da API; o Discord oficial tem canais de modding para suporte.
Para gráficos (banners, tail decals, imagens personalizadas), use PNGs quadrados (1024×1024 transparente preferido) e templates da comunidade.
Para compartilhar mapas, use o Map Editor embutido e depois envie para o Steam Workshop ou mod.io; arquivos de mapa (.timber) ficam na pasta Maps do jogador.

Habilitando mods e compatibilidade de saves

Habilite mods na seção Mods do menu principal após instalação/assinatura.
Mods que adicionam novos prédios, recursos ou mecânicas são mais seguros quando habilitados no início de um novo save. Adicionar esses mods no meio do jogo pode causar incompatibilidades.
Mods de UI/QoL (sobreposições, displays) geralmente são seguros para adicionar a saves existentes, mas verifique a descrição de cada mod.

Solução de problemas e problemas comuns

Travamentos na inicialização: desative mods um por um para isolar o mod problemático. Incompatibilidades de versão são a causa mais comum.
Conflitos: dois mods que alteram o mesmo sistema podem conflitar — verifique descrições dos mods e notas dos autores.
Arquivos de save: saves que usam mods podem não carregar em uma máquina que não possui os mesmos mods. Faça backup dos saves antes de habilitar ou desabilitar mods.
Se um mod quebrar após uma atualização do jogo, verifique a página do mod por uma versão atualizada ou reverta para uma versão anterior do jogo compatível com o mod.
Arquivos de log do jogo (diretório de logs do Timberborn) contêm mensagens de erro que apontam para mods problemáticos.

Melhores práticas e segurança

Faça backup da sua pasta Saves antes de instalar muitos ou grandes mods de conteúdo.
Prefira assinar através do Steam Workshop ou mod.io para atualizações automáticas.
Verifique notas de compatibilidade dos mods e dependências necessárias (por exemplo, BepInExPack).
Para sua primeira experiência com mods, instale mods leves de QoL (BeaverBuddy, melhorias de Water Overlay) antes de grandes mods de conteúdo para aprender o fluxo.
Evite ativar múltiplos mods que alterem o equilíbrio central a menos que você aceite conquistas ou jogabilidade alteradas.

Tipos de mods e pilares da comunidade

Mods de QoL/UI: sobreposições melhoradas, UIs de gerenciamento de beavers, pular introdução.
Automação e integração: ferramentas no estilo SmartPower e HTTP Lever/HTTP Adapter para controle/monitoramento externo.
Pacotes de conteúdo: novas culturas, prédios, biomas e árvores tecnológicas.
Ferramentas criativas e sandbox: Creative Mode, ferramentas de terreno expandidas, pacotes de mapas.
Cosméticos: tail decals, banners, imagens personalizadas.

Compartilhamento e publicação

Steam Workshop: use as ferramentas de upload dentro do jogo para mapas e itens do Workshop; escolha visibilidade, adicione descrições e changelogs.
mod.io: siga o guia de upload do mod.io para mapas e mods; forneça os metadados e ativos exigidos.
Ao publicar, inclua compatibilidade clara (versão do jogo, dependências requeridas), changelogs e instruções de instalação.

Localizações de arquivos e compartilhamento

Pasta Mods (instalações manuais): Documents/Timberborn/Mods (caminhos por plataforma acima).
Conteúdo do Steam Workshop é armazenado na sua pasta de conteúdo do Steam workshop (Steam/steamapps/workshop/content/1062090).
Mapas personalizados vão para a pasta local Maps; compartilhe arquivos .timber ou envie através do editor.

Use este guia para escolher, instalar e gerenciar mods com segurança para que você possa expandir Timberborn com confiança — desde simples ajustes de QoL até sistemas de jogabilidade complexos.