Wiki en construction. De nombreux concepts décrits ici viennent de l'alpha 0.2 et peuvent encore changer. Le wiki sera finalisé pour la version 1.0 — pour l'instant il sert à aider les testeurs fermés puis, plus tard, les joueurs de l'accès anticipé à s'y retrouver. Pour les informations les plus à jour et les plus fiables, rejoignez le Discord — c'est là que les changements sont annoncés en premier et que vous pouvez poser vos questions directement.

Rejoindre le Discord pour les dernières infos

Modding — Vue d'ensemble

Les trois choses moddables — packs de contenu, circuits et langues — où vivent les fichiers, quels outils les écrivent, et comment le jeu les détecte.

Sur cette page

The Undercut est moddable sur trois fronts, et tous les trois suivent la même règle : déposez un fichier dans le bon dossier, et le jeu le trouve au lancement. Rien n’est installé, rien n’est patché, et supprimer le fichier remet tout en place.

Les trois canaux sont indépendants — un mod peut n’en utiliser qu’un seul, ou les trois à la fois.

QuoiFichierCréé avecApparaît dans
Pack de contenu — écuries, pilotes, sponsors, fournisseurs, calendrier de la saisonun .db dans mods/l’Éditeur de mods (application navigateur livrée avec le jeu)Nouvelle carrière → Mods personnalisés
Circuit — un tracé dessiné à la main<nom>.circuit dans mods/circuits/l’Éditeur de circuits intégré au jeuConfiguration de carrière (Personnalisé / pool de circuits), et calendriers des packs de mods
Langue — une traduction complète<code>.txt dans mods/lang/l’Éditeur de langues (application navigateur livrée avec le jeu)Paramètres → Langue

Comment le jeu trouve vos fichiers

mods/ dans votre dossier utilisateur my_pack.db circuits/ · lang/ Steam Workshop vos abonnements téléchargés par Steam rien à copier scan au lancement mods/ puis Workshop Nouvelle carrière → Mods perso. chaque pack .db trouvé Config. carrière · pool de circuits chaque .circuit trouvé Paramètres → Langue chaque pack de langue trouvé

Un fichier à vous dans mods/ prime sur un abonnement portant le même nom.


Où vont les fichiers

Vos mods vivent dans votre propre dossier utilisateur, pas dans le dossier d’installation du jeu — sur Windows, une installation Steam se trouve dans Program Files, où vous n’avez pas le droit d’écrire. Le jeu crée le dossier au lancement :

Votre systèmeDossier
Windows%APPDATA%\TheUndercut\mods\ — collez-le dans la barre d’adresse de l’Explorateur
macOS~/Library/Application Support/TheUndercut/mods/
Linux~/.local/share/TheUndercut/mods/
mods/
  my_pack.db            ← un pack de contenu
  circuits/
    monaco_1994.circuit ← un tracé dessiné à la main
  lang/
    pl.txt              ← un pack de langue
  .cache/               ← logos décompressés par le jeu (géré, suppression sans risque)

Un dossier mods/ placé à côté de l’exécutable du jeu est toujours lu, donc tout ce que vous aviez installé auparavant continue de fonctionner — et si le même nom de fichier existe des deux côtés, celui de votre dossier utilisateur l’emporte. Les deux éditeurs, eux, vivent à côté de l’exécutable (mod-editor/index.html, lang-editor/index.html) ; le jeu les ouvre pour vous et vous indique dans quel dossier enregistrer.

mods/.cache/ est écrit par le jeu lui-même : un pack embarque ses logos à l’intérieur du .db, et ils y sont décompressés à la première utilisation du pack. Vous n’avez jamais à l’éditer, et le supprimer ne coûte qu’une décompression.


Les outils

Menu principal → Outils de modding :

  • Éditeur de circuits — dessinez un tracé, prévisualisez-le avec le vrai moteur de rendu de course, analysez un tour, testez-le au volant, enregistrez-le dans mods/circuits/.
  • Éditeur de mods — ouvre mod-editor/index.html dans votre navigateur. Crée et édite des packs de contenu, entièrement hors ligne.
  • Éditeur de langues — le même genre d’application navigateur hors ligne, pour les traductions.

Les deux outils navigateur tournent depuis file:// : aucune installation, aucun serveur, aucun compte. Ils sont signalés comme expérimentaux à l’ouverture — l’avertissement porte sur la jeunesse des outils, pas sur un risque pour votre sauvegarde.


Choisir un pack

Un pack de contenu se choisit au démarrage d’une carrière, pas dans un réglage global :

  1. Menu principal → Nouvelle carrière
  2. Dans la liste des séries, choisissez Mods personnalisés (dernière ligne)
  3. La liste de tous les packs trouvés dans mods/ et dans vos abonnements Workshop apparaît — tapez pour filtrer, choisissez-en un
  4. Un pack Nouvelle série enchaîne ensuite sur la configuration de carrière normale ; un pack Imposé ouvre plutôt un écran de sélection d’écurie

Deux conséquences à connaître :

  • Un pack n’affecte que la carrière créée avec lui. Une sauvegarde existante conserve le monde avec lequel elle a été générée — installer, mettre à jour ou supprimer un pack ne change rien à une carrière déjà en cours.
  • Démarrer une carrière de façon normale reste toujours vanilla. Un pack posé dans mods/ ne s’applique jamais à une carrière lancée depuis la liste de séries standard ; il faut passer par Mods personnalisés.

Les circuits et les packs de langue se comportent différemment : ils ne se « choisissent » pas une fois pour toutes, ils apparaissent simplement comme des options supplémentaires — dans les listes de circuits de la configuration de carrière, et dans le sélecteur de langue.


Les fichiers locaux priment sur les abonnements

mods/ est toujours scanné avant vos abonnements Workshop, et le premier fichier l’emporte pour un nom donné. C’est ainsi que vous testez une modification d’un objet déjà publié : gardez la copie modifiée dans votre propre mods/ et l’objet auquel vous êtes abonné reste hors jeu jusqu’à ce que vous la retiriez.


Quand quelque chose n’apparaît pas

Le jeu peut afficher exactement ce qu’il voit. Depuis le dossier du jeu :

the_undercut --list-mods

Il affiche le dossier de contenu Workshop résolu, chaque répertoire d’objet, et chaque pack, circuit et pack de langue relevé par chaque scan. Si votre fichier n’est pas dans cette liste, le jeu ne l’a jamais vu — vérifiez d’abord le dossier et l’extension.

Causes courantes :

SymptômeCause
Le pack n’est pas dans la liste Mods personnalisésMauvaise extension (il faut .db), ou le fichier n’est pas directement dans mods/
Un objet auquel vous êtes abonné manqueSteam n’a pas fini de le télécharger — vérifiez la page Téléchargements
Le circuit manque dans la configuration de carrièreLe fichier doit se terminer par .circuit et se trouver dans mods/circuits/ (ou, dans un objet Workshop, à la racine de l’objet ou dans circuits/)
La langue manqueLe nom du fichier doit être le code de langue (pl.txt), et il ne peut pas s’agir de l’une des six langues intégrées — un pack ne peut jamais les masquer
Rien du tout, dans la démoLa démo et les builds Next Fest sont livrés sans support des mods ; c’est retiré à la compilation, pas désactivé

Pour aller plus loin