Como instalar MODs no Factorio, atualizar e restaurar【Compatível com Space Age】

Se você quer mexer com MODs no Factorio 2.0 e no ambiente Space Age, é seguro separar a facilidade do Mod Portal dentro do jogo da força do gerenciamento manual colocando arquivos na pasta mods. Este artigo foi escrito para quem está instalando MODs QoL pela primeira vez até para quem quer manter a operação de MODs adicionais oficiais incluindo quality e Elevated Rails sem problemas.

O eixo é conhecer onde seus dados de usuário estão, fazer backups, verificar dependências e logs antes de atualizar, desativar ou restaurar. Eu mesmo segui rigorosamente o método de começar com um único MOD QoL simples e observar o log antes de expandir, e graças a isso consegui migrar para MODs maiores sem nenhum acidente com save.

Pré-requisitos que você deve saber antes de instalar MODs no Factorio

Versão alvo e suposições deste artigo

Este artigo assume um ambiente posterior ao Factorio 2.0. Em termos de canais de MOD, focaremos principalmente no Mod Portal acessado a partir da tela "MOD" no jogo e no Mod Portal da versão navegador (factorio.com). Embora a operação usando Mod Portal seja comum na comunidade, recomenda-se confirmar a posição de tratamento do Steam Workshop em fontes primárias (é mais seguro dizer que a rota recomendada oficial é frequentemente descrita como Mod Portal).

A razão para separar isso no início é que a operação de MOD do Factorio não é concluída apenas com o local de instalação do corpo principal do jogo. Saves, configurações, MODs e script-output estão concentrados no lado dos dados do usuário, e o local também muda dependendo da configuração write-data conforme mostrado em 『Application directory - Factorio Wiki』. Em outras palavras, mesmo no mesmo PC, se "qual pasta você está vendo" ficar desalinhado, você pode instalar um MOD mas ele não aparecerá no lado do jogo - um mal-entendido elementar mas incômodo.

Após 2.0, a fronteira entre vanilla, DLC e MODs adicionais ficou mais visível. Por isso, se você não estiver acostumado com a ideia de "elementos oficiais adicionais também serem gerenciados como MODs", pode se sentir um pouco confuso no momento em que abre a lista de MODs. Eu mesmo, logo após instalar Space Age, primeiro revisei na tela de MOD se os MODs adicionais originários de DLC estavam ativados e, em seguida, liguei/desliguei apenas quality para compreender o comportamento. Procedendo nesta ordem, você consegue entender como a configuração oficial é exibida antes de instalar MODs da comunidade, o que torna as coisas muito menos confusas.

Observação: adicionar ou remover MODs corrompe dados de replay. Além disso, antes de instalar uma nova versão, é recomendado fazer backup do diretório contendo saves e configurações. O fluxo de "preservar primeiro, depois mexer" mencionado na seção anterior permanece válido neste ambiente 2.0.

Application directory/ja

wiki.factorio.com

Rota de implementação oficial

Quando você instala MODs no Factorio, a forma mais natural é procurar e instalar no Mod Portal dentro do jogo. Considerando a facilidade de instalação, a praticidade de lidar com dependências e a perseguição de atualizações, este é o ponto de entrada mais estável para a primeira vez. Na comunidade também, a operação de seleção automática de dependências obrigatórias durante a instalação a partir do navegador no jogo é amplamente utilizada.

O Mod Portal em factorio.com no lado do navegador é bom para procurar itens e verificar dependências. Especialmente quando você quer ver com calma "em que este MOD depende?" e "em qual série de versão está sendo atualizado?", a lista é melhor do que dentro do jogo. Para ir um pouco mais longe tecnicamente, em 『Mod portal API - Factorio Wiki』, o api/mods/{name}/full também pode recuperar um array de dependências. Para pessoas lidando com grandes configurações de MOD, operações de servidor ou considerando fixação de modpack, apenas conhecer a existência desta API muda muito a perspectiva.

A força deste método é que versão fixa e verificação são fáceis. Por exemplo, se você quer manter um grande MOD em sua versão anterior, quer evitar que a configuração desabe com atualizações, ou quer deixar um ambiente para reprodução, isso é mais fácil de lidar do que com a instalação no jogo. Em vez disso, você assume que dependências e conflitos são gerenciados por você. Se as dependências pré-requisitos necessárias não forem preenchidas, você simplesmente falhará ao iniciar, e se você misturar algo que requer DLC, será bloqueado imediatamente. Observe que rótulos de UI e valores padrão de configuração podem mudar dependendo da versão, então verifique as descrições reais e valores padrão na tela de configurações do jogo.

Quando você quer registrar a configuração, é conveniente poder escrever todos os MODs ativos e versões em script-output/mods.txt. Se você quer reproduzir depois, você não precisa se lembrar manualmente "o que estava instalado", então ajuda bastante em ambientes de verificação. O gerenciamento de MOD do Factorio é menos dependente de um software lançador dedicado e mais sobre combinar o Mod Portal oficial, o posicionamento dos dados do usuário, logs e arquivos de saída - se você entender isso, ficará muito mais fácil.

Mod portal API

wiki.factorio.com

Esclarecendo Space Age, quality e Elevated Rails

Space Age é uma expansão paga lançada em 21 de outubro de 2024 e estruturalmente consiste em 3 MODs adicionais. Olhando para as descrições em Space Age - em japonês e versão em inglês, o conteúdo é bastante grande - 4 novos planetas, 5 tipos de pacotes de ciência, 22 edifícios, 30 produtos intermediários, 5 armas, 2 tipos de inimigos e 29 conquistas são adicionados. Mesmo começando como uma extensão do vanilla, no meio do caminho você entra em uma fase completamente diferente - a escala é próxima a "outro Factorio".

O que importa aqui é que os elementos adicionados do Space Age não são "funcionalidade fixa queimada diretamente no corpo principal do jogo", mas também são itens de gerenciamento vistos na tela de MOD. É por isso que, após a instalação, quando você vê a lista de MODs, "onde termina a parte oficial e onde começa o MOD da comunidade?" é inicialmente confuso, mas você consegue entender a estrutura na mesma tela de gerenciamento de MOD normal.

Entre eles, quality é um pouco especial - conforme mostrado em Quality - Factorio Wiki, pode ser ativado como um MOD independente, mas requer propriedade do Space Age para usar. Isso é realmente importante, e apenas porque você instalou Space Age não significa que sempre precisa jogar com quality incluído. Eu mesmo desativei apenas quality no início, mexi por algumas horas, depois o ativei para ver a diferença. Procedendo assim, é fácil compreender onde as receitas, a sensação de equipamento e o significado das linhas de produção em massa mudam.

Elevated Rails também é bom manter uma sensação semelhante a quality em termos de como você organiza. Como um elemento oficial, Elevated rail é uma funcionalidade do lado do Space Age, mas no Mod Portal também existem vários MODs da comunidade relacionados. Em outras palavras, mesmo que você veja "nomes relacionados a Elevated Rails" na lista de MODs, nem todos significam a mesma coisa. Você precisa separar se é um componente de estrutura DLC oficial ou um MOD da comunidade que estende, promove ou ajusta essa funcionalidade.

Quando você consegue fazer essa distinção, o julgamento ao adicionar MODs em um ambiente Space Age fica muito mais fácil. Primeiro, entenda a relação entre os 3 MODs adicionais oficiais e quality, depois sobreponha QoL ou MODs maiores. Após o Factorio 2.0, simplesmente observar a ordem correta nas instalações de MOD reduz bastante a taxa de acidentes.

Existem 2 maneiras de instalar MODs: Mod Portal dentro do jogo e instalação manual

Procedimento de instalação no Mod Portal dentro do jogo

A forma mais simples é usar o Mod Portal diretamente na tela "MOD" do jogo. No Factorio, este canal é direto, e o fluxo de busca, instalação e atualização é fácil de ser concluído em uma única tela - essa é a força. Especialmente ao estágio de instalar alguns MODs QoL, é muito mais fácil do que rastrear manualmente as dependências.

O fluxo real é simples - abra "MOD" no menu principal, procure o nome do MOD que deseja instalar na aba de instalação e selecione o alvo para instalar. Como é amplamente conhecido na comunidade, com este método as dependências obrigatórias são facilmente selecionadas automaticamente, então os iniciantes se beneficiam muito. Por exemplo, mesmo quando requer MODs tipo biblioteca que não funcionam sozinhos, o navegador no jogo pode acompanhar.

Após a instalação, ele é adicionado à lista de MODs e pode ser visto em estado ativado. O que importa aqui é não apenas se a instalação foi bem-sucedida, mas também se passou no carregamento durante a inicialização sem erros. O processamento automático de dependências é muito conveniente, mas não cuida completamente da compatibilidade. Em configurações com MODs grandes ou requisitos de DLC, a instalação em si pode funcionar, mas pode parar no estágio de carregamento.

Tecnicamente, 『Mod portal API - Factorio Wiki』 também organiza a aquisição de informações de MOD e especificações de download, e api/mods/{name}/full também pode recuperar um array de dependências. Você não precisa tocar diretamente na API durante o jogo normal, mas conhecer o contexto de por que o navegador no jogo ficou mais fácil de lidar com dependências ajuda a entender por que este método é ideal para iniciantes.

Notas sobre criação de conta e vinculação do Steam

Quando você usa o Mod Portal dentro do jogo, um ponto que pode causar pequenos problemas é que um download às vezes requer uma conta em factorio.com. Mesmo que você jogue Factorio no Steam, o canal de obtenção de MOD não está diretamente conectado aos recursos do Steam - a autenticação do lado do Mod Portal oficial está envolvida.

Por isso, mesmo para proprietários da versão Steam, criar uma conta em factorio.com e vinculá-la ao sua conta Steam torna as coisas mais organizadas. Quando você conclui isso, o fluxo de procurar MODs no jogo e instalar fica estável. Por outro lado, se essa vinculação ficar vaga, é fácil acabar em um estado onde "o corpo principal do jogo está iniciando, mas apenas MODs não podem ser obtidos" - isso se torna uma fonte de confusão na instalação inicial.

Este reconhecimento é especialmente importante no ambiente Space Age. Como elementos adicionais oficiais também aparecem na listagem de MODs, elementos originários de DLC e MODs da comunidade aparecem na mesma tela. Se a confusão também incluir autenticação, fica difícil ver se é uma falha de instalação, um problema de propriedade ou um erro de dependência. Eu mesmo, ao configurar um novo ambiente, primeiro confirmo o estado de login no jogo antes de mexer com MODs. Este pequeno passo acelera bastante a solução de problemas.

Instalação manual (colocação em pasta mods) e manuseio de zip

A instalação manual é basicamente colocar um zip distribuído na pasta mods como está. É fácil imaginar extrair e colocar apenas a pasta dentro, mas normalmente o pensamento é colocar o zip como está. A pasta mods do lado dos dados do usuário do Factorio é conforme mencionado anteriormente, e se você mudou write-data, esse local de configuração se torna o local de colocação real.

A força deste método é que versão fixa e verificação são fáceis. Por exemplo, se você quer manter um grande MOD em sua versão anterior, quer evitar que a configuração desabe com atualizações, ou quer deixar um ambiente para reprodução, isso é mais fácil de lidar do que com a instalação no jogo. Em vez disso, você assume que dependências e conflitos são gerenciados por você. Se as dependências pré-requisitos necessárias não forem preenchidas, você simplesmente falhará ao iniciar, e se você misturar algo que requer DLC, será bloqueado imediatamente.

Algo fácil de perder é não manter várias versões do mesmo MOD juntas. Na comunidade também, deixar múltiplas versões de um mesmo MOD na pasta mods é um caso conhecido de falha na inicialização. Eu mesmo, antes de instalar um MOD grande manualmente, sempre verifico se não há zip com o mesmo nome ou pastas com o mesmo nome duplicadas diretamente em mods. Apenas isso reduz bastante as falhas de inicialização. É mundano em termos práticos, mas é a verificação que mais funciona.

Se você se debruçar manualmente sobre a configuração, a ordem de carregamento e o ponto de parada são fáceis de organizar vendo logs, e escrever todos os MODs ativos e versões em script-output/mods.txt torna mais fácil comparar configurações depois. Esta lista é surpreendentemente útil ao separar conflitos. Combinações que tendem a ser problemáticas em compatibilidade ficam mais fáceis de lidar quando vistas junto com a maneira de organizar configurações mencionada a seguir.

Diferenciando métodos de instalação

Os métodos de instalação não são uma questão de superioridade, mas sim usar diferentes métodos dependendo do que você quer fazer. Para instalação QoL inicial ou jogo normal, o Mod Portal dentro do jogo é claramente mais fácil. Procurar, instalar e ele pega algumas dependências, então a velocidade inicial de expansão da configuração é muito leve.

Por outro lado, se você prioriza manter versão antiga, reprodução para verificação ou preservação de configuração específica, a instalação manual é melhor. O método de colocar e gerenciar zip é simples, mas é muito mais fácil manter o mesmo estado sem ser agitado por atualizações - isso é grande. Quando você está mexendo com grandes configurações como Krastorio 2 ou Space Exploration, essa estabilidade tem muito valor.

Resumindo a diferença, o Mod Portal dentro do jogo é "facilidade de instalação", instalação manual é "facilidade de fixar configuração". Porém, o gerenciamento manual assume que você separa insuficiência de dependência e conflitos por si mesmo, então se você fizer instalação em massa sem experiência, é fácil ficar preso. Por essa razão, é natural começar pequeno no jogo e depois passar para manual quando necessário.

Entender mais detalhadamente fica mais fácil quando você vê "dependência", "compatibilidade do corpo principal" e "ordem de carregamento" separadamente do ponto de vista de verificação de compatibilidade.

Local da pasta mods e diretório de dados do usuário

Dados do usuário por OS e pasta mods

No Factorio, MOD, saves e arquivos de configuração são basicamente gerenciados sob o diretório de dados do usuário. A pasta mods que você toca na instalação manual também fica aqui, e é fácil entender quando você vê como mesmo sistema de local de armazenamento que saves e várias configurações. Os caminhos diferem por OS, e a configuração exata está resumida em 『Application directory - Factorio Wiki』.

Se eu repassar apenas os caminhos padrão frequentemente usados, no Windows é %APPDATA%\Factorio\mods, no Linux é ~/.factorio/mods e no macOS é ~/Library/Application Support/factorio/mods. saves e arquivos relacionados a configuração também ficam lado a lado aqui, então é mais prático em operações ver como "um conjunto completo de dados do usuário Factorio" em vez de pensar em MOD como algo separado.

Às vezes jogo em ambiente dual Windows e Linux, mas em vez de rastrear apenas mods, foi infinitamente mais fácil ver mods, saves e config juntos como uma unidade de diretório pai. A unidade de backup e sincronização fica alinhada, então acidentes como "neste ambiente apenas o save é novo" ou "este aqui apenas a configuração é antiga" diminuem. Quando você alternava entre grandes configurações de MOD, essa diferença era bastante significativa.

Impacto da opção write-data

Algo fácil de perder é que o local de armazenamento real não é fixo no caminho padrão. Factorio pode mudar o local do diretório de dados do usuário pela configuração write-data em config/config.ini. Quando você está usando essa configuração, o local de armazenamento de MOD e a posição da pasta mods também mudam para este novo local.

Em outras palavras, mesmo que você pense "como é Windows, deve estar em %APPDATA%\Factorio\mods", em um ambiente usando write-data, você não encontrará nada. Não é apenas mods - saves, configurações e script-output se movem juntos, então essa configuração é um pré-requisito para instalação manual, backup e restauração. O trabalho de colocação de zip mencionado na seção anterior é realmente em relação ao diretório para o qual write-data está apontando.

Entender essa especificação torna o gerenciamento de múltiplos ambientes muito mais limpo. Eu mesmo, ao especificar explicitamente write-data em um ambiente dual e alinhar o local de armazenamento de dados do usuário, backup e sincronização de repente ficaram muito mais fáceis. Em vez de rastrear apenas mods, o pensamento de fixar todo o diretório pai do local de armazenamento aumenta a reprodutibilidade da configuração.

Relação entre save, configuração e player-data.json

Sob o diretório de dados do usuário, não apenas MOD e save, mas configuração e informações relacionadas à conta também estão armazenadas. Um deles é importante entender: player-data.json. Não é apenas um local de armazenamento de configuração de aparência, mas um arquivo que contém token para Mod Portal - isso é importante saber. Ao organizar aquisição de MOD no jogo ou uso de API, conhecer o papel deste arquivo ajuda a não ler mal a situação.

Para resumir, mods é o corpo MOD instalado, saves é dados de fábrica durante o jogo, vários arquivos de configuração são o ambiente de operação e exibição, player-data.json é informações de jogador e informações auxiliares de autenticação Mod Portal - essa é a divisão. Todos ficam no mesmo diretório de dados do usuário, então durante backup ou migração é melhor pensar em relação em vez de apenas uma parte.

Conhecer essa estrutura torna fácil ver a razão de lacunas como "MOD foi restaurado mas o estado de login é diferente" ou "save existe mas a configuração não voltou ao original" ao migrar ambientes ou restaurar. A operação de arquivo do Factorio é um pouco bruta, mas entender que save, configuração e informações de autenticação estão na mesma base torna muito claro o que mudar para afetar o quê.

Procedimento de operação segura para atualização, desativação e backup

Checklist pré-atualização e backup

A atualização do corpo principal ou instalação de novo MOD muda bastante a taxa de acidentes dependendo de preservação antes de instalar ao invés de no instante de instalação. Factorio concentra MOD, save e configuração no mesmo diretório de dados do usuário, então o backup antes da atualização é mais seguro fazer backup de toda a pasta pai do que salvar arquivos individuais. 『Application directory - Factorio Wiki』 também organiza com base neste local de armazenamento.

Na prática, em vez de salvar mods e saves separadamente antes de atualizar, é mais rápido restaurar se você zipar todo o diretório de dados do usuário. Eu mesmo faço isso como unidade antes de grandes atualizações, e a reversão é rápida mesmo se houver incompatibilidades. Especialmente com atualizações grandes como Space Age onde a adição oficial é grande, este pequeno passo tem muito valor.

Para checklist pré-atualização, é mais fácil de gerenciar se você afunilar para estes 3 pontos em vez de aumentar muito os itens.

1. Fazer backup do diretório de dados do usuário inteiro como está
2. Duplicar o save em jogo em progresso com nome diferente
3. Estar ciente se esta atualização vai quebrar a configuração de MOD atual antes de aplicar

Aqui o especialmente importante é duplicação de save. Adição ou remoção de MOD não é apenas uma questão de possibilidade de carregamento, mas também se conecta à compatibilidade de replay. Conforme mostrado em 『Replay system - Factorio Wiki』, quando a configuração de MOD muda, dados de replay são corrompidos. Embora você facilmente não note ao jogar normalmente, isso começa a fazer diferença quando você quer reproduzir ou verificar depois, então duplicação de save antes de atualizar é mais como operação normal do que seguro.

Noções básicas de desativação e restauração (rollback)

Se houver problema após atualização, é mais rápido ir procurar a causa depois de conseguir voltar para o estado estável anterior. Problemas de MOD no Factorio geralmente não são um arquivo quebrado único - eles acontecem pela "combinação do corpo principal, MOD e save", então o rollback também deve ser pensado nessa unidade de combinação.

O primeiro passo da desativação é separar qual MOD adicionado ou atualizado é o culpado. Porém, simplesmente desmarcar nem sempre devolve as coisas ao normal. O save pode carregar mas o conteúdo pode estar alterado, ou ao contrário, o save pode ter sido salvo com aquele MOD como pré-requisito. Especialmente MODs que adicionam correntes de produção ou entidades têm impacto amplo, e externamente a fábrica se torna outra coisa.

Por isso, a prioridade de restauração é em vez de "remover o MOD problemático", é mais estável restaurar junto o save que você duplicou antes da atualização com o estado mods de antes da atualização. Isso torna fácil evitar estados meio a meio como "save antigo e MOD novo". Conforme mencionado na seção anterior, o pensamento de lidar com dados do usuário em unidade de diretório pai também funciona aqui.

Algo fácil de perder durante rollback é a ativação automática de novo MOD. Em uma configuração onde você colocou zip na pasta mods, esse MOD pode ser ativado no próximo boot. Mesmo se você achar que restaurou, se um zip desnecessário ficar para trás, é fácil recair na falha, então ao restaurar é importante alinhar tanto "qual arquivo está colocado" como "qual MOD está ativado" juntos.

Estratégia de evitar risco de mistura de múltiplas versões

Há muitas cenas onde você quer manter a versão antiga. Configuração de verificação, vida útil de save em progresso, espera de compatibilidade de MOD específico - as razões variam, mas o que é fácil de acontecer aqui é mistura de múltiplas versões. Se você acumular zip novo e velho na mesma pasta mods e além disso também atualizar o corpo, fica difícil entender qual combinação está funcionando. Quando há problema, a separação fica difícil - esse estado é mais típico.

Se você realmente precisa manter a versão antiga, o melhor é manter manualmente apenas uma em termos de operação. Em vez de coexistir configuração normal de jogo com configuração de verificação no mesmo lugar, é melhor colocar apenas os MODs para usar este save naquele lugar, reduzindo incompreensão na leitura e atualização perdida. Como instalação manual é forte em fixação de versão, mas também deixa resíduos facilmente, se você acumular sem organizar, vira uma mina de acidentes.

A região Space Age é especialmente problemática porque elementos adicionais oficiais e MOD normais aparece perto - a fronteira de configuração se torna vaga facilmente. Um MOD que assume elemento DLC e um que não assume convivem, então mesmo que pareça nome similar, o significado pode ser diferente. Eu mesmo, para evitar essa mistura, mantenho a pasta mods fina ao verificar. Em vez de colocar muito para obter conveniência, afunilando a fábrica para uma receita, é de fato mais rápido manter o ambiente também em configuração mínima.

Se você realmente precisa manter múltiplas versões em paralelo, o pensamento de dividir um conjunto de corpo, save e MOD como a mesma unidade é essencial. Se você apenas manter uma delas, a compatibilidade desaba facilmente, e quando você olha depois, a reprodutibilidade cai. O gerenciamento de MOD do Factorio tem diferença maior em manutenção do que em instalação, então evitar mistura e claramente escolher uma configuração para usar agora é por si só uma estratégia de segurança bem forte.

Como diferenciar dependência, compatibilidade e conflito

Como ler dependências

A maioria dos MODs que não iniciam começam com erro de interpretação de dependência. No Factorio, a Mod Portal de cada página geralmente mostra dependências, e os dados distribuídos também contêm informações de dependência em info.json. Quando você entra no Mod Portal dentro do jogo, dependência obrigatória pode ser automaticamente coletada, mas em instalação manual ou manutenção de versão antiga, você logo enfrenta essa interpretação por conta própria.

O truque é não ver "este MOD funciona sozinho?" mas sim em que este MOD se baseia?. Por exemplo, MODs tipo biblioteca, MODs tipo assistência de tradução, expansões que assumem restruturação específica - você não consegue dizer o peso de dependência apenas vendo nomes. Descrição em Mod Portal é importante, mas a coluna de dependência é muito mais conectada ao êxito ou falha real de inicialização.

Se você quiser confirmar mecanicamente, pode usar 『Mod portal API』 para ver informações de api/mods/{name}/full. Neste endpoint full, você consegue recuperar o array dependencies, então é bem conveniente quando difícil acompanhar apenas a exibição no jogo. Ao reproduzir o mesmo modset em múltiplas pessoas ou ao organizar qual MOD requer o quê, é mais rápido pela API do que pela exibição.

Eu mesmo ao adicionar um MOD grande, vejo a coluna de dependência antes de ler descrição. Ao compreender isso primeiro, é fácil evitar acidente de "imaginava ser adição de 1 MOD conveniência" quando na verdade era MOD base diferente ou pré-requisito DLC.

Confirmação de compatibilidade com versão Factorio body principal

Mesmo que as dependências estejam alinhadas, se a versão do corpo não corresponder, o carregamento para. Para MOD do Factorio, em qual versão do corpo principal este MOD foi feito é extremamente importante. Especialmente logo após atualização major, MODs populares frequentemente permanecem antes de acompanhamento, e é mais provável ficar preso aqui do que no procedimento de instalação em si.

A data de lançamento do Space Age foi 21 de outubro de 2024, e depois disso tanto migração para 2.0 quanto suporte a DLC avançaram de uma vez. Nestes grandes marcos, configurações que eram estáveis ontem podem de repente expor não-compatibilidade em larga escala depois da atualização. Além disso, Space Age aparece como MOD adicional mas na verdade envolve componentes de expansão oficial, então julgar sentindo "o nome está visível então deve estar disponível" é fácil de errar.

Página individual