Pacotes de idioma | Wiki de The Undercut

O jogo sai em seis idiomas — inglês, francês, espanhol, italiano, alemão e português — e qualquer outro idioma pode ser acrescentado sem uma única linha de código: uma tradução é um ficheiro de texto colocado no lang/ da sua pasta de mods (%APPDATA%\TheUndercut\mods\lang\ no Windows — ver onde ficam os ficheiros).

mods/
  lang/
    pl.txt      ← o pacote de idioma inteiro

Assim que o ficheiro está lá, o idioma aparece em Definições → Idioma, com a sua bandeira. A mudança é instantânea, em carreira ou a partir do menu principal.

O inglês é a chave

Não há identificadores de cadeias. A frase inglesa escrita no jogo é a chave de tradução, e um pacote associa as linhas inglesas às suas:

#name: Polski
#flag: pl

>New Career
=Nowa kariera

>Lap {} / {}
=Okrążenie {} / {}

> abre uma chave (a cadeia inglesa), = dá a tradução, # é um comentário.
#name: é o nome mostrado no seletor, #flag: o código de país de duas letras da bandeira.
Os marcadores {} e {named} têm de ser mantidos — o jogo substitui neles por ordem.
Uma entrada ocupa uma linha física. Um texto de várias linhas (o corpo de um correio) escreve as quebras como um \n literal.

Um pacote a meio é perfeitamente jogável. Tudo o que não tiver traduzido aparece em inglês — não há estado partido, não há marca de cadeia em falta, e pode publicar um pacote a 40 % e terminá-lo mais tarde.

O Editor de idiomas

Menu principal → Ferramentas de modding → Editor de idiomas (ou abra lang-editor/index.html na pasta do jogo). Tal como o Editor de mods, corre offline no seu browser, a partir do próprio ficheiro.

Todas as cadeias traduzíveis são listadas: o inglês à esquerda, a sua tradução à direita. A tradução francesa é mostrada como segunda referência — esconda-a com o interruptor se atrapalhar.
Preencha o cabeçalho: o nome do idioma mostrado no jogo, o código do ficheiro (pl → pl.txt) e o código da bandeira.
Traduza. O editor marca uma linha a vermelho quando os seus marcadores deixam de corresponder à chave inglesa — é o único erro que vale a pena apanhar, porque um marcador partido nota-se no jogo.
Guardar pacote (Ctrl+S) em mods/lang/. O Chrome e o Edge escrevem diretamente no ficheiro; o Firefox transfere-o.
No jogo: Definições → Idioma → a sua bandeira.

Só por traduzir e o contador de progresso mostram o que falta. Reabrir um pacote existente retoma onde parou, e as cadeias vindas de outra versão do jogo são preservadas no fim do ficheiro em vez de descartadas.

Traduzir sem o editor

A lista de cadeias é um ficheiro de texto simples, o que torna a tradução em massa — inclusive com uma IA — muito direta. Trabalhe em blocos de 200–300 entradas com uma única regra:

Preencha as linhas =, nunca toque nas linhas >.

A chave inglesa é comparada byte a byte em tempo de execução. Uma chave reescrita — um espaço a mais, um acento alterado — não é um erro: é uma operação silenciosa sem efeito que deixa essa cadeia em inglês para sempre. Mantenha cada {marcador} exatamente como aparece.

O que um pacote não pode fazer

Não pode tapar um idioma integrado. Os seis incorporados ganham sempre; um pacote tem de trazer um código novo.
Não traduz nomes próprios. Pilotos, equipas, patrocinadores e circuitos são conteúdo gerado e ficam como estão.
A narração do tutorial fica em inglês. Só o seu texto no ecrã é traduzido.
Os correios mantêm o idioma em que chegaram. Um correio é traduzido quando é escrito e guardado assim, por isso mudar de idioma a meio da carreira deixa o correio antigo como estava.

Alfabetos e fontes

As fontes de ecrã do jogo cobrem o latino e, através de um recurso automático, o latino estendido e o cirílico: quando um idioma carregado usa letras que faltam à fonte escolhida, o jogo troca essa fonte por uma que as cubra e repõe a original quando muda de idioma. Assim, pacotes em polaco, checo, turco, russo ou ucraniano aparecem corretamente sem trabalho adicional.

Chinês, japonês e coreano ainda não são suportados — precisam de uma fonte que o jogo não inclui. Um pacote CJK carrega, mas os glifos não são desenhados.

Partilhar

Envie o ficheiro .txt e ele vai para o mods/lang/ de quem o receber. Para o publicar como item subscritível, veja o guia da Workshop: um pacote de idioma fica na raiz do item (como <código>.txt) ou dentro de uma pasta lang/. O seu próprio ficheiro ganha sempre a uma subscrição com o mesmo código — é assim que testa uma alteração sem cancelar a subscrição.