The Undercut è moddabile su tre fronti, e tutti e tre seguono la stessa regola: metti un file nella cartella giusta e il gioco lo trova all’avvio. Non si installa nulla, non si applica nessuna patch, e cancellare il file rimette tutto com’era.
I tre canali sono indipendenti: una mod può usarne uno solo, oppure tutti e tre insieme.
| Cosa | File | Creato con | Compare in |
|---|---|---|---|
| Pacchetto di contenuti — team, piloti, sponsor, fornitori, calendario della stagione | un .db in mods/ | l’Editor di mod (app da browser fornita col gioco) | Nuova carriera → Mod personalizzate |
| Circuito — un tracciato disegnato a mano | <nome>.circuit in mods/circuits/ | l’Editor di circuiti integrato nel gioco | Configurazione carriera (Personalizzato / pool di circuiti) e calendari dei pacchetti mod |
| Lingua — una traduzione completa | <codice>.txt in mods/lang/ | l’Editor di lingue (app da browser fornita col gioco) | Impostazioni → Lingua |
Come il gioco trova i tuoi file
Dove vanno i file
Le tue mod vivono nella tua cartella utente, non nella cartella di installazione del gioco: su Windows un’installazione Steam sta in Program Files, dove non hai il permesso di scrivere. Il gioco crea la cartella all’avvio:
| Il tuo sistema | Cartella |
|---|---|
| Windows | %APPDATA%\TheUndercut\mods\ — incollala nella barra degli indirizzi di Esplora file |
| macOS | ~/Library/Application Support/TheUndercut/mods/ |
| Linux | ~/.local/share/TheUndercut/mods/ |
mods/
my_pack.db ← un pacchetto di contenuti
circuits/
monaco_1994.circuit ← un tracciato disegnato a mano
lang/
pl.txt ← un pacchetto lingua
.cache/ ← loghi estratti dal gioco (gestita, si può cancellare)Una cartella mods/ accanto all’eseguibile del gioco viene comunque letta, quindi tutto ciò che avevi installato prima continua a funzionare — e se lo stesso nome di file esiste in entrambe, vince quello nella tua cartella utente. I due editor, invece, stanno accanto all’eseguibile (mod-editor/index.html, lang-editor/index.html): il gioco li apre per te e ti dice in quale cartella salvare.
mods/.cache/ la scrive il gioco stesso: un pacchetto porta i suoi loghi dentro il .db, e vengono estratti lì la prima volta che il pacchetto viene usato. Non la modifichi mai, e cancellarla costa solo una nuova estrazione.
Gli strumenti
Menu principale → Strumenti di modding:
- Editor di circuiti — disegna un tracciato, guardalo in anteprima con il vero renderer di gara, analizza un giro, provalo al volante, salvalo in
mods/circuits/. - Editor di mod — apre
mod-editor/index.htmlnel tuo browser. Crea e modifica pacchetti di contenuti, completamente offline. - Editor di lingue — lo stesso tipo di app da browser offline, per le traduzioni.
Entrambi gli strumenti da browser girano da file://: nessuna installazione, nessun server, nessun account. All’apertura sono contrassegnati come sperimentali — l’avviso riguarda quanto sono giovani gli strumenti, non un rischio per il tuo salvataggio.
Scegliere un pacchetto
Un pacchetto di contenuti si sceglie quando inizi una carriera, non in un’impostazione globale:
- Menu principale → Nuova carriera
- Nell’elenco delle serie, scegli Mod personalizzate (ultima riga)
- Compare l’elenco di tutti i pacchetti trovati in
mods/e nelle tue iscrizioni al Workshop — scrivi per filtrare, poi scegline uno - Un pacchetto Nuova serie prosegue con la normale configurazione della carriera; un pacchetto Imposto apre invece una schermata di scelta del team
Due conseguenze da tenere a mente:
- Un pacchetto influisce solo sulla carriera creata con esso. Un salvataggio esistente conserva il mondo con cui è stato generato: installare, aggiornare o cancellare un pacchetto non cambia nulla in una carriera già avviata.
- Iniziare una carriera nel modo normale è sempre vanilla. Un pacchetto che sta in
mods/non si applica mai a una carriera avviata dall’elenco delle serie standard; devi passare da Mod personalizzate.
Circuiti e pacchetti lingua si comportano diversamente: non si «scelgono» una volta per tutte, compaiono semplicemente come opzioni in più — negli elenchi dei circuiti della configurazione carriera e nel selettore della lingua.
I file locali battono le iscrizioni
mods/ viene sempre scansionata prima delle tue iscrizioni al Workshop, e a parità di nome vince il primo file. È così che provi una modifica a un oggetto che hai già pubblicato: tieni la copia modificata nella tua cartella mods/ e l’oggetto a cui sei iscritto resta da parte finché non la togli.
Quando qualcosa non compare
Il gioco può stampare esattamente ciò che vede. Dalla cartella del gioco:
the_undercut --list-modsStampa la cartella dei contenuti Workshop risolta, ogni directory di oggetto e ogni pacchetto, circuito e pacchetto lingua raccolto da ciascuna scansione. Se il tuo file non è in quell’elenco, il gioco non l’ha mai visto: controlla prima cartella ed estensione.
Cause frequenti:
| Sintomo | Causa |
|---|---|
| Il pacchetto non è nell’elenco Mod personalizzate | Estensione sbagliata (deve essere .db), oppure il file non è direttamente in mods/ |
| Manca un oggetto a cui sei iscritto | Steam non ha finito di scaricarlo — controlla la pagina Download |
| Il circuito manca nella configurazione carriera | Il file deve finire con .circuit e stare in mods/circuits/ (oppure, in un oggetto Workshop, nella radice dell’oggetto o in circuits/) |
| Manca la lingua | Il nome del file deve essere il codice lingua (pl.txt), e non può essere una delle sei lingue integrate: un pacchetto non può mai coprirle |
| Niente di niente, nella demo | La demo e le build del Next Fest escono senza supporto alle mod; è escluso in compilazione, non disattivato |
Dove andare adesso
- Pacchetti mod — cosa può cambiare un pacchetto di contenuti, sezione per sezione, e la struttura del file stesso.
- Editor di mod — l’editor che li scrive.
- Modding dei circuiti — disegnare un tracciato e inserirlo in una stagione.
- Pacchetti lingua — tradurre il gioco.
- Pubblicare sullo Steam Workshop — trasformare uno qualsiasi dei precedenti in un oggetto a cui iscriversi.