Cyberpunk 2077: in quale cartella va ogni mod, cosa sono CET, RED4ext e redscript, e perché l’ordine è alfabetico

Cyberpunk 2077 non ha un unico sistema di mod, ma diversi livelli che convivono: archivi che sostituiscono risorse, script, modifiche al database di gioco, plugin che si agganciano all’eseguibile. Ognuno ha la sua cartella. Mettere un file nel posto sbagliato non produce errori: semplicemente il mod non fa nulla. È una causa frequente dei mod che “non funzionano”.

La fonte di riferimento per questa guida è la wiki di modding mantenuta dalla comunità (wiki.redmodding.org), che documenta struttura e regole in modo molto dettagliato. Le versioni dei framework le abbiamo prese dalle pagine ufficiali delle release su GitHub.

La mappa delle cartelle

Tutti i percorsi sono relativi alla cartella principale del gioco, quella che contiene le sottocartelle archive, bin ed r6. La wiki propone come regola generale una tabella “per estensione del file”, da seguire salvo istruzioni diverse dell’autore del mod. Questa è la nostra sintesi:

La wiki segnala anche una cartella da evitare: archive\pc\patch era usata prima della versione 1.3 del gioco. Oggi gli archivi vanno in archive\pc\mod.

I framework, uno per uno

Molti mod non funzionano da soli: richiedono uno o più framework, cioè componenti che aggiungono al gioco funzioni che il motore non offre. La pagina di ogni mod li elenca tra i requisiti. I cinque più diffusi:

Una data di release vecchia non significa che il framework sia abbandonato: se il gioco non cambia, non serve aggiornarlo. Conta che la versione che usi sia compatibile con la versione del gioco installata, cosa che le pagine dei framework indicano.

La sezione di troubleshooting della wiki segnala un caso ricorrente: cybercmd non serve più. Da RED4ext 1.13, pubblicato a maggio 2023, le sue funzioni sono incluse in RED4ext, e i due non vanno usati insieme.

L’ordine di caricamento: alfabetico, ma in ASCII

Due mod che modificano lo stesso file entrano in conflitto. La wiki spiega come il gioco li ordina: prima tutti i file .archive in archive\pc\mod, in ordine alfabetico ASCII; poi le cartelle REDmod in mods, anch’esse in ordine ASCII. Per gli archivi, quando due file contengono la stessa risorsa vince quello caricato per primo.

“Ordine ASCII” significa che il confronto avviene sul codice numerico dei caratteri, non sull’alfabeto come lo intendiamo di solito. Nella pratica:

• alcuni simboli, come ! e #, vengono prima delle cifre (non tutti: _ e ~, per esempio, vengono dopo le maiuscole);
• le cifre vengono prima delle lettere;
• le lettere maiuscole vengono prima delle minuscole: MyMod.archive si carica prima di myMod.archive.

Per far vincere un archivio basta quindi rinominarlo in modo che venga prima. Attenzione però: secondo la wiki, se in archive\pc\mod c’è un file modlist.txt, il gioco segue l’ordine scritto in quel file invece di quello alfabetico, e la wiki consiglia di eliminarlo. La wiki avverte però di non farne un’abitudine: aggiungere simboli all’inizio dei nomi funziona in Cyberpunk ma può rompere i percorsi in altri giochi o sistemi. Il suo consiglio di fondo è più netto: in condizioni normali non dovresti dover gestire i conflitti, e se serve è perché due mod toccano davvero la stessa risorsa, per esempio i modelli del corpo.

REDmod o “legacy”?

Molti mod sono pubblicati in due formati: REDmod, il sistema ufficiale di CD Projekt RED che usa la cartella mods, e il formato tradizionale con gli archivi in archive\pc\mod. La wiki suggerisce: nel dubbio, installa il formato non REDmod. Le ragioni indicate dalla wiki: REDmod ha avuto vari problemi di compatibilità e non si è mai davvero affermato, la maggior parte degli autori pubblica versioni “legacy”, e i REDmod vengono caricati dopo tutto il resto, cosa che li rende inadatti ai mod che devono caricarsi in un punto preciso.

La wiki spiega anche come convertire un mod REDmod che contiene solo archivi: si spostano i file dalla sottocartella archives del mod direttamente in archive\pc\mod.

Gli aggiornamenti del gioco

La pagina della wiki dedicata agli aggiornamenti si apre con un consiglio diretto: aggiorna il gioco solo quando tutti i framework sono stabili sulla nuova versione. Quando una patch cambia l’eseguibile, RED4ext, CET e gli altri devono essere aggiornati, e fino ad allora i mod che li usano non funzionano.

Il trucco di Steam non è una funzione ufficiale. Funziona finché il file resta di sola lettura: ricordati di togliere il blocco, altrimenti il gioco non riceve nessun aggiornamento. La stessa pagina segnala che, dalla versione 2.2 del gioco, Steam permette di tornare alle versioni 1.63, 2.13, 2.21 o 2.3 dalle proprietà del gioco.

Se il gioco si chiude

La procedura della wiki parte da un controllo semplice: disattiva tutti i mod e avvia il gioco. Se il problema resta, è il gioco (o i driver), non i mod. Se sparisce, riattiva i mod a gruppi finché il problema non ricompare: è la tecnica della bisezione, che spieghiamo con i numeri nella guida dedicata. Il rapporto di crash del gioco contiene un file stacktrace.txt che a volte indica la direzione giusta, ma la wiki avverte che spesso non basta da solo a individuare il colpevole.