Wiki in costruzione. Molti concetti qui descritti provengono dall'alpha 0.2 e possono ancora cambiare. La wiki sarà finalizzata per la versione 1.0 — per ora serve ad aiutare i tester chiusi e, più avanti, i giocatori dell'accesso anticipato a orientarsi. Per le informazioni più aggiornate e affidabili, entra nel Discord — è lì che le novità vengono annunciate per prime e dove puoi chiedere direttamente.

Entra nel Discord per le ultime novità

Pacchetti lingua

Tradurre il gioco in una nuova lingua — il formato del file, l'Editor di lingue offline, cosa ricade sull'inglese e quali alfabeti coprono i font inclusi.

In questa pagina

Il gioco esce in sei lingue — inglese, francese, spagnolo, italiano, tedesco e portoghese — e qualsiasi altra lingua può essere aggiunta senza una sola riga di codice: una traduzione è un file di testo messo nel lang/ della tua cartella mods (%APPDATA%\TheUndercut\mods\lang\ su Windows — vedi dove vanno i file).

mods/
  lang/
    pl.txt      ← l'intero pacchetto lingua

Appena il file è lì, la lingua compare in Impostazioni → Lingua, con la sua bandiera. Il cambio è immediato, in carriera come dal menu principale.


L’inglese è la chiave

Non esistono identificatori delle stringhe. La frase inglese scritta nel gioco è la chiave di traduzione, e un pacchetto associa le righe inglesi alle tue:

#name: Polski
#flag: pl

>New Career
=Nowa kariera

>Lap {} / {}
=Okrążenie {} / {}
  • > apre una chiave (la stringa inglese), = fornisce la traduzione, # è un commento.
  • #name: è il nome mostrato nel selettore, #flag: il codice paese di due lettere per la bandiera.
  • I segnaposto {} e {named} vanno mantenuti: il gioco vi sostituisce i valori nell’ordine.
  • Una voce sta su una sola riga fisica. Un testo su più righe (il corpo di una mail) scrive le interruzioni come un \n letterale.
«New Career» la stringa nel gioco il tuo pacchetto la chiave è tradotta? sì no «Nowa kariera» «New Career» ricade sull'inglese

Un pacchetto a metà è perfettamente giocabile. Tutto ciò che non hai tradotto compare in inglese: nessuno stato rotto, nessun segnalibro di stringa mancante, e puoi pubblicare un pacchetto al 40 % e finirlo più avanti.


L’Editor di lingue

Menu principale → Strumenti di modding → Editor di lingue (oppure apri lang-editor/index.html nella cartella del gioco). Come l’Editor di mod, gira offline nel tuo browser, direttamente dal file.

  1. Ogni stringa traducibile è elencata: inglese a sinistra, la tua traduzione a destra. La traduzione francese è mostrata come seconda referenza — nascondila con l’interruttore se ti dà fastidio.
  2. Compila l’intestazione: il nome della lingua mostrato nel gioco, il codice del file (pl → pl.txt) e il codice della bandiera.
  3. Traduci. L’editor colora una riga di rosso quando i suoi segnaposto non corrispondono più alla chiave inglese: è l’unico errore che vale la pena intercettare, perché un segnaposto rotto si vede nel gioco.
  4. Salva pacchetto (Ctrl+S) in mods/lang/. Chrome ed Edge riscrivono direttamente il file; Firefox lo scarica.
  5. Nel gioco: Impostazioni → Lingua → la tua bandiera.

Solo non tradotte e il contatore di avanzamento seguono ciò che manca. Riaprire un pacchetto esistente riprende da dove ti eri fermato, e le stringhe provenienti da un’altra versione del gioco vengono conservate in fondo al file invece di essere scartate.


Tradurre senza l’editor

L’elenco delle stringhe è un semplice file di testo, il che rende immediata la traduzione in blocco, anche con un’IA. Lavora a blocchi di 200–300 voci con una sola regola:

Compila le righe =, non toccare mai le righe >.

La chiave inglese viene confrontata byte per byte a runtime. Una chiave ribattuta — uno spazio in più, un accento cambiato — non è un errore: è un’operazione silenziosamente inutile che lascia quella stringa in inglese per sempre. Mantieni ogni {segnaposto} esattamente com’è.


Cosa un pacchetto non può fare

  • Non può coprire una lingua integrata. Le sei incorporate vincono sempre; un pacchetto deve portare un codice nuovo.
  • Non traduce i nomi propri. Piloti, team, sponsor e circuiti sono contenuti generati e restano come sono.
  • Il parlato del tutorial resta in inglese. Viene tradotto solo il suo testo a schermo.
  • Le mail conservano la lingua in cui sono arrivate. Una mail viene tradotta quando viene scritta e salvata così, quindi cambiare lingua a metà carriera lascia la posta vecchia com’era.

Alfabeti e font

I font di visualizzazione del gioco coprono il latino e, tramite un ripiego automatico, il latino esteso e il cirillico: quando una lingua caricata usa lettere che mancano al font scelto, il gioco sostituisce quel font con uno che le copre e rimette l’originale quando cambi. Così i pacchetti polacco, ceco, turco, russo o ucraino si visualizzano correttamente senza lavoro aggiuntivo.

Cinese, giapponese e coreano non sono ancora supportati: richiedono un font che il gioco non include. Un pacchetto CJK si caricherà, ma i glifi non verranno disegnati.


Condividere

Manda il file .txt e finisce nel mods/lang/ di chi lo riceve. Per pubblicarlo come oggetto a cui iscriversi, vedi la guida al Workshop: un pacchetto lingua va nella radice dell’oggetto (come <codice>.txt) oppure in una cartella lang/ al suo interno. Il tuo file vince sempre su un’iscrizione con lo stesso codice — ed è così che provi una modifica senza disiscriverti.