Download and documentation for the Auto Translation Framework RimWorld mod
View the Project on GitHub hillegent/rimworld_auto_translater_wiki
| English | Русский | 简体中文 | Português (Brasil) |
Este guia descreve o fluxo de uso do Auto Translation Framework 1.0.18 no RimWorld 1.6.
A instalação recomendada é pela Oficina Steam. Para instalar sem o Steam, baixe o ZIP atual no GitHub e extraia a pasta RimWorldAutoTranslator em RimWorld\Mods.
Traduções humanas existentes são preservadas por padrão e têm prioridade sobre o conteúdo gerado.
O provedor padrão funciona sem chave de API. APIs pagas, modelos locais e a biblioteca compartilhada são opcionais.
| Aba | Finalidade |
|---|---|
| Overview (Visão geral) | Interruptor principal, idioma de destino e painel resumido do processo. |
| Translators (Tradutores) | Seleção de provedores, credenciais, verificações de saúde, perfis, lotes e modo com vários provedores. |
| Mods | Escopo por mod, resultados do escaneamento, progresso, repetição, aplicação, redefinição e pesquisa. |
| Editor | Abre a área de trabalho em tela cheia para correções manuais. |
| Library (Biblioteca) | Traduções-base compartilhadas, pacotes de autores, catálogo, downloads, avaliações e uploads opcionais. |
| Advanced (Avançado) | Escopos de tradução, desempenho, fila em segundo plano, validação, rede e armazenamento. |
| Debug (Depuração) | Estado do processo, logs de diagnóstico, ações de reparo e redefinição das configurações. |
Strings Keyed são chaves normais de localização do RimWorld usadas por menus, mensagens, alertas e muitos sistemas de mods. Esse escopo é ativado por padrão.
A tradução DefInjected cobre campos compatíveis nos Defs do RimWorld: nomes, descrições, traits, pensamentos, itens, construções, pesquisas, eventos, hediffs e dados semelhantes. Esse escopo é ativado por padrão.
Alguns mods desenham textos em inglês diretamente pelo C#, em vez de usar arquivos de idioma do RimWorld. A camada de execução observa caminhos de interface compatíveis e traduz textos conhecidos quando eles são desenhados. Ela cobre parte dos rótulos, botões, opções de menus flutuantes, comandos, dicas, textos de inspeção, cartas e mensagens.
A cobertura em tempo de execução é best effort. Se ela afetar o desempenho de uma lista muito grande de mods, desative apenas Translate hardcoded C# UI strings (Traduzir textos de interface C# codificados diretamente); as traduções Keyed e DefInjected podem continuar ativas.
A tradução genérica de arquivos Strings está desativada no momento. Esses arquivos podem conter regras sensíveis à formatação e exigem tratamento seguro específico.
As opções web integradas incluem Google Translate Web, Yandex Web, Bing Translator Web e MyMemory Web. Google Translate Web é a configuração padrão com um único provedor.
Serviços web públicos podem limitar requisições, mudar de comportamento ou ficar temporariamente indisponíveis. Verificações de saúde, intervalos de repetição e o disjuntor de rede evitam ciclos infinitos de falha.
O menu também oferece suporte a:
Para usar um provedor de API, selecione-o e preencha o endpoint, o modelo, a chave de API e os campos específicos mostrados na interface. Use Check providers now (Verificar provedores agora) antes de iniciar um lote grande.
As credenciais são salvas nas configurações do mod pelo RimWorld. Não publique nem compartilhe arquivos de configuração que contenham chaves privadas.
O modo com vários provedores divide as entradas pendentes entre serviços configurados e pode executar requisições em paralelo. Cada slot possui seu próprio valor de concorrência. Comece com limites conservadores; aumentar demais a concorrência pode provocar limitação do serviço sem melhorar a qualidade.
Os perfis permitem salvar várias configurações para o mesmo provedor, como um modelo local e um endpoint remoto compatível com OpenAI.
A aba Mods lista os mods ativos e mostra as quantidades escaneadas, pendentes e traduzidas.
Mods desativados continuam visíveis nas estatísticas, mas novas entradas deles não são adicionadas à fila.
Abra Editor > Open translation editor (Abrir editor de tradução) para iniciar a área de trabalho em tela cheia.
O editor permite:
Edições manuais ativam os agendadores de aplicação e geração de pacotes. Algumas mudanças aparecem durante o jogo; conteúdo Def sensível a formato pode ficar totalmente visível somente após a próxima inicialização.
A biblioteca é opcional e permanece desativada até que seus controles sejam habilitados.
Os fluxos disponíveis incluem:
Downloads e uploads são controlados separadamente. Ativar downloads não exige ativar uploads. Operações de envio podem exigir autorização do serviço, e os pacotes enviados podem ser revisados antes de se tornarem traduções compartilhadas confiáveis.
A biblioteca reduz chamadas repetidas aos provedores: quando já existe uma tradução compatível, ela pode ser reutilizada em vez de traduzir o mesmo texto novamente.
Auto Translation Framework não modifica os arquivos originais de outros mods do Steam Workshop.
A pasta de armazenamento local contém:
TranslationMemoryV2.jsonl — memória de tradução persistente;GeneratedPacks — dados de localização gerados;LibraryModStateV1.jsonl — estado local da biblioteca compartilhada;HumanCorrectionsV1.jsonl — correções manuais aguardando envio;PipelineDiagnostics.log — eventos de diagnóstico.Use Advanced/Debug > Open local files folder (Avançado/Depuração > Abrir pasta de arquivos locais) para abrir a localização correta da plataforma.
O XML gerado pertence ao cache do framework. Faça correções permanentes pelo editor de tradução, em vez de editar diretamente os arquivos gerados.
Abra Debug, examine o snapshot do processo e use Open pipeline diagnostics log. Ao relatar o problema na página do Steam Workshop, inclua o estado relevante e uma descrição curta para reprodução. Não inclua chaves de API nem tokens privados.
Strings ainda não são traduzidos.