Mods: Guia de Mods e Instalação

Mods estendem Oxigênio Not Included adicionando conteúdo, alterando a interface e expondo dados do jogo para assets e comportamentos criados pelos usuários. A modificação permite novas ferramentas, buildings, overlays, elementos, animações e cenários de jogo — mas exige cuidado: o jogo pode ficar instável quando modado, e alguns sistemas base foram especificamente refatorados para tornar a modificação mais segura e fácil.

Começando

Inscrever e ativar: Use o Workshop do Vapor para inscrever-se em mods. No jogo, abra o menu Mods, marque os mods que deseja e reinicie o jogo para carregá-los.
Ferramentas de Debug e Sandbox: Use o modo Debug (alternância Backspace no PC) para acelerar testes: revele o nevoeiro de guerra, copie/cole regiões do mapa (incluindo buildings e seus conteúdos), pinte elementos e gere Duplicants. Modos sandbox e comandos de spawn em debug tornam a validação de mods e cenários mais rápida.

O que o jogo expõe aos modders

Mudanças recentes no motor e nos dados foram feitas especificamente para tornar a modificação viável e mais robusta:

Menus de Planejamento/Construção e Ferramentas: Categorias de construção e o menu Tools agora são implementados como coleções dinâmicas (listas/tabelas hash) para que mods possam adicionar novas ferramentas e entradas de menu sem conflitar com enums do jogo.
Overlays: Overlays foram convertidos para tabelas suportadas por hash para que mods possam adicionar overlays ou se conectar à inicialização de overlays.
Elementos e Substâncias: A estrutura de dados Substances foi limpa e campos não usados foram removidos; a tela Filter mostra elementos adicionados por mods.
Animações e assets: A ordem de inicialização foi ajustada para que animações e assets adicionados por mods possam se registrar. ModUtil foi adicionado para garantir que as anims e assets necessários sejam carregados.
Materiais e elementos: Stubs de materiais base para sólidos e líquidos existem para simplificar a criação de materiais mock para protótipos.
Banco de dados e logging: O relatório de erros para chaves inválidas foi melhorado, e mais erros de carregamento de mods são enviados para os logs; erros de inicialização têm mais chance de mostrar uma tela de crash.

Essas mudanças permitem que modders adicionem novos buildings, materiais, elementos, entradas de UI e outros conteúdos com mais confiabilidade.

Conteúdo típico de mods

Novos buildings e estações: Mods comumente adicionam buildings ao menu de construção, incluindo novas estações funcionais (pesquisa/produção) e estruturas decorativas. Como a tela de planejamento agora é extensível, um mod pode adicionar categorias inteiras.
Novos elementos e substâncias: Mods adicionam gases, líquidos e sólidos. Os sistemas Filter e Substance aceitam elementos adicionados por mods para que apareçam nos filtros de UI e overlays.
Novos overlays e ferramentas: Mods podem registrar overlays customizados (por exemplo, um indicador visual para um novo recurso ou perigo) e ferramentas para posicionamento e edição.
Animações e skins: Modders fornecem arquivos anim e skins. Use ModUtil e coloque as anims nas pastas de assets corretas para que o jogo as carregue na inicialização.
Conteúdo estilo Scenario / Lab: Mods podem criar layouts alternativos de asteróides e conteúdo de cenário que se comporta como The Lab, possibilitando asteróides desafiadores, missões personalizadas ou jogabilidade estilo evento.
Itens cosméticos e recompensas: Skins especiais e desbloqueios cosméticos podem ser distribuídos por mods ou vinculados a sistemas de recompensas externos.

Fluxo de trabalho de desenvolvimento e dicas

Comece pequeno: Adicione um building ou elemento e verifique se ele aparece no menu de construção e nos overlays antes de expandir.
Use as utilidades fornecidas: ModUtil e os novos sistemas baseados em listas/hashes reduzem erros comuns. Garanta que quaisquer anims ou assets referenciados estejam incluídos e registrados.
Verifique os logs: O banco de dados e os logs de carregamento de mods melhorados apontarão chaves inválidas e referências ausentes. Corrija os erros relatados durante a inicialização.
Teste com o modo Debug: Use as funcionalidades de debug (Backspace) para pintar elementos, gerar itens e copiar/colar templates para iteração rápida.
Fique atento à estabilidade: O suporte a mods foi melhorado, mas modding ainda pode introduzir crashes ou incompatibilidades de save — teste saves entre sessões e observe erros na inicialização.

Possibilidades avançadas e advertências

Substituir ou estender categorias de UI com segurança: Como as categorias são hashes, você pode adicionar novas entradas; evite reutilizar chaves existentes para prevenir colisões.
Elementos e balanceamento de jogabilidade: Adicionar um novo gás ou líquido é suportado, mas assegure-se de definir propriedades físicas apropriadas; o jogo impõe um elemento por célula e vários comportamentos térmicos/de fase que interagem com os sistemas base.
Interações com foguetes/espaço e exploits: O mundo do jogo contém contextos especiais (por exemplo, módulos de foguete e interiores de estações). Conteúdo modado que interage com limites especiais ou áreas isoladas pode involuntariamente habilitar exploits (espaço utilizável expandido, paredes indestrutíveis, etc.). Teste interações em casos de borda como interiores de foguetes, estações e vácuo.
Tamanhos de assets e visuais: DLC e o jogo base às vezes usam sprites ou tamanhos diferentes para buildings similares (por exemplo, visuais de Baía de Carga diferem conforme o conteúdo Spaced Out). Ao criar assets, inclua tamanhos e variantes corretas se pretende compatibilidade com conteúdo de DLC.

Distribuição e experiência do usuário

Forneça instruções claras de instalação: Diga aos usuários como se inscrever, ativar o mod e se ele requer outros mods ou DLC.
Notas de compatibilidade: Informe quais versões do jogo e DLC seu mod suporta, e se saves feitos com o mod são compatíveis com o jogo base sem ele.
Ofereça presets e exemplos: Envie um asteróide de exemplo ou template, e inclua configurações recomendadas para quaisquer overlays ou ferramentas customizadas.

Recursos úteis para modders

ModUtil e as novas coleções baseadas em listas/hashes são os principais auxiliares para registrar assets e entradas de UI.
Use ferramentas de debug para testes rápidos: pinte elementos, copie/cole templates e gere Duplicants e itens.
Leia os logs de carregamento de mods na inicialização para capturar chaves ausentes, anims faltando ou problemas de banco de dados.

Modding em Oxigênio Not Included agora é muito mais prático graças a mudanças estruturais em menus, overlays, substâncias e carregamento de assets. Com testes cuidadosos e atenção à estabilidade, mods podem adicionar jogabilidade, visuais e cenários cativantes ao jogo.