Universal Modder + Claude Code : la configuration complète

Pourquoi Claude Code est l’agent de référence

L’auteur du projet a construit la boîte à outils à partir de vraies sessions Claude Code, et le dépôt fournit un câblage propre à Claude : une marketplace de plugins (.claude-plugin/), des skills copiés dans .claude/skills, le serveur MCP fal dans .mcp.json, et un hook SessionStart qui ajoute la CLI um au PATH à chaque démarrage ou reprise de session. Les autres agents fonctionnent aussi (voir le guide d’installation multi-agents), mais Claude Code bénéficie du parcours le plus testé.

1. Installer Claude Code

Passez cette étape si claude --version fonctionne déjà.

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

Créez ensuite un dossier de travail pour vos mods (par exemple ~/mods ou C:\mods), lancez claude dedans et connectez-vous. Il vous faut un abonnement Claude Pro, Max, Team ou Enterprise, ou un compte Console avec facturation API. Si quelque chose semble anormal, lancez claude doctor.

Installez aussi les prérequis de la boîte à outils : Git, Python 3.10+, ffmpeg et uv (installation en une ligne).

2. Ajouter le plugin Universal Modder

/plugin marketplace add rehan-remade/universal-modder
/plugin install universal-modder@universal-modder

• Choisissez la portée utilisateur (user scope) pour que le plugin soit disponible dans tous vos dossiers de projet.
• Lancez /reload-plugins si Claude Code le demande, ou redémarrez la session.
• Vous préférez le shell ? La même chose fonctionne avec claude plugin marketplace add … et claude plugin install ….
• Une erreur SSH ? Voir le dépannage.

Ce que le plugin installe

3. Connecter fal pour les graphismes, la 3D et l’audio

Le serveur MCP fal lit FAL_KEY dans l’environnement où Claude Code démarre. Créez une clé sur fal.ai/dashboard/keys, exportez-la et relancez claude.

export FAL_KEY="votre-cle"     # macOS / Linux / WSL
setx FAL_KEY "votre-cle"       # Windows, puis ouvrez un nouveau terminal

Vérifiez avec /mcp dans Claude Code : le serveur fal doit apparaître comme connecté. Les prix par asset sont sur la page des coûts.

Appeler les skills

Il est rarement nécessaire de nommer un skill : une demande comme « modde Stardew Valley pour que… » charge mod-any-game, qui fait appel aux autres selon les besoins. Pour en forcer un, tapez sa commande slash :

Ce que contient chaque skill →

Des prompts qui marchent

Un bon prompt nomme le jeu, un résultat concret et ce à quoi ressemble « terminé ». Exemples tirés du README du projet :

Modde Terraria : ajoute un lance-missiles à tête chercheuse et une bombe nucléaire tactique qui creuse un cratère dans le monde. Fais les sprites avec fal.

Crée une nouvelle civilisation pour Age of Empires II avec une unité unique rendue à partir de la 3D.

Mets le vrai Minecraft dans le mode histoire de GTA V. La caméra de Minecraft doit suivre celle de GTA, et sa TNT doit faire exploser les voitures de GTA.

Quel est le moteur de C:\Games\Foo, et quelqu’un l’a-t-il déjà moddé ?

Des astuces qui économisent tokens et argent :

• Reconnaissance d’abord, construction ensuite. Demandez le plan avant toute modification ; il est écrit dans MODDING_PLAN.md.
• Une tranche à la fois. Une seule arme qui marche vaut mieux que dix à moitié faites.
• Des visuels provisoires avant fal. Ne générez les visuels finaux qu’une fois la mécanique fonctionnelle en jeu.
• Demandez le prix. « Vérifie um fal price avant de générer le modèle 3D. »
• Ne touchez à rien pendant les tests. N’utilisez pas le PC pendant qu’il pilote le jeu ou enregistre.

Projets longs et limites de contexte

Le skill tient un journal dans MODLOG.md (chemins, identifiants, formats, ce qui a échoué, l’étape suivante), pour que rien d’important ne se perde quand Claude Code compacte la conversation. Démarrez une nouvelle session avec :

Lis MODLOG.md et MODDING_PLAN.md et reprends à l’étape suivante.

Quand le mod fonctionne, demandez-lui de rédiger une note de terrain avec le skill share-field-notes. Il n’ouvre une pull request vers la base de connaissances partagée qu’après votre accord.

Ce que Claude Code a construit avec

• Age of Empires II: Definitive Edition: San Franciscans: a new civilization for Age of Empires II DE with units rendered from 3D
• Baldur's Gate 3: Act 2 never loads (hang at 50% or crash): one modded NPC on a bad level layer, found by bisecting a pak
• Baldur's Gate 3: A generated wardrobe mod: 260 clothing mods sorted by race and body type into containers summoned by reusable scrolls
• Baldur's Gate 3: Custom outfits from cloned mod and vanilla meshes: visuals, materials, body masks, cloth, LODs, icons and the Blender GR2 round trip
• Baldur's Gate 3: Gameplay and compatibility patches in stats and Osiris: level-gated armour tiers, Extra Attack on a modded cantrip, crit immunity, stacking damage reduction, feats from items, removing equipment glow, a class vs starting-equipment fix
• Baldur's Gate 3: Running a 500+ mod load order by hand: modsettings.lsx rules, recovering a wiped order from a save, mod.io re-subscribes, game-folder files and conflict diagnosis
• Baldur's Gate 3: Weapons: porting a Skyrim dagger and scabbard, fixing a modded sword's sheath height with a Dummy_Sheath bone, and visible stowed shields for modded shields
• Borderlands 2: BL3 weapons and movement in Borderlands 2 (Willow2 SDK mods)
• Darkest Dungeon: A seeded randomizer (trinkets, heroes, monsters, curios, quirks, quests) as a Darkest Dungeon data mod
• Dragon's Dogma 2: Blink Strike teleports behind the target (REFramework Lua skill rework)
• Dragon's Dogma 2: Dimension Door: aimed teleport spell with a scripted arrival camera (REFramework Lua)
• Elden Ring: CS2 conversion of Elden Ring offline: native Rust DLL via me3 (fall death, spirit springs, 3D inspect, params)

Parcourir tous les jeux →