NobleMod

Mod BepInEx / Harmony pour R.E.P.O. — remplacement audio configurable, overrides optionnels du mob principal par niveau, et réglages in-game (nécessite MenuLib).

Auteur : Raisery

---

Français

Dépendances

• BepInEx (pack Thunderstore recommandé pour REPO)
• MenuLib (nickklmao) — menu NobleMod Settings dans les paramètres du jeu

Fonctionnalités principales

Contenu par défaut du paquet (Thunderstore)

• Sons : le paquet inclut déjà un mapping qui remplace certains sons du Huntsman par des extraits de vidéos d’Hervé Reigner (fichiers audio + CustomSounds/replacements.json fournis). Tu peux tout modifier ou supprimer selon tes goûts.
• Spawn : le SpawnConfig fourni (ex. level_enemy_overrides.json) configure le Huntsman comme mob principal pour le niveau 1. Ce mapping s’applique lorsque l’option EnableSpawnOverrides est activée dans BepInEx/config/raisery.noblemod.cfg (elle est désactivée par défaut).

Avertissement : les sons par défaut sont extraits de vidéos au langage grossier (contenu vulgaire). Prudence en stream, en public ou avec des mineurs : désactive les remplacements audio ou remplace les fichiers par du contenu adapté.

Sons personnalisés (CustomSounds)

• Remplacement des clips audio vanilla par tes fichiers .ogg, décrits dans CustomSounds/replacements.json (fourni avec le paquet ou éditable après installation).
• Correspondance par nom exact de clip vanilla, ou règles contains: / exact: sur le nom du clip.
• Tirages pondérés : pour une même règle, tu peux définir plusieurs variantes (fichiers custom et/ou conservation du son vanilla avec { "vanilla": true, "weight": … }). Les poids sont normalisés automatiquement.
• Filtre optionnel sur la hiérarchie Unity (AudioSourceHierarchyFilter dans la config) pour ne traiter que certaines sources (sinon : tout le jeu).
• Découverte : en jeu, le mod peut enregistrer les noms de clips rencontrés dans un JSON hiérarchique pour t’aider à compléter ton mapping (voir options dans raisery.noblemod.cfg).

Overrides de spawn (SpawnConfig, optionnel)

• Fichier JSON (par défaut SpawnConfig/level_enemy_overrides.json) : associe un numéro de niveau à l’identifiant du mob principal à forcer.
• Désactivé par défaut (EnableSpawnOverrides) ; une fois activé, le mod applique le mapping si le mob existe pour le niveau, sinon fallback vanilla avec log.

Menu in-game

• Entrée dédiée (NobleMod Settings / NOBLEMOD selon version) dans les paramètres du jeu.
• Permet notamment d’activer ou désactiver à chaud les sons personnalisés et les overrides de spawn, avec sauvegarde dans la config BepInEx.

Configuration avancée

• Fichier généré automatiquement : BepInEx/config/raisery.noblemod.cfg.
• Nombreuses options : logs de remplacement, découverte de clips, debug audio, logs des choix pondérés, etc. (sections General, Spawning, Debug).

Installation (Thunderstore)

Avec le Thunderstore Mod Manager / app Thunderstore, les dépendances sont installées avec le paquet. Le gestionnaire extrait le contenu du zip (DLL + dossiers à la racine du paquet) dans le profil du jeu : tout ce qui se trouve à côté de NobleMod.dll (CustomSounds, SpawnConfig, …) est utilisé par le mod.

Notes

• Pour éditer replacements.json ou les overrides après installation, ouvre les fichiers dans le dossier du mod créé par ton gestionnaire (même répertoire que la DLL).
• Le dépôt du projet contient une documentation développeur plus longue (mapping JSON détaillé, spawn, build).

---

English

Dependencies

• BepInEx (Thunderstore pack recommended for REPO)
• MenuLib (nickklmao) — NobleMod Settings entry in the game’s settings menu

Main features

Default package content (Thunderstore)

• Audio : the package ships with a mapping that replaces certain Huntsman sounds with excerpts from Hervé Reigner’s videos (audio files + supplied CustomSounds/replacements.json). You are free to edit or remove any of it.
• Spawn : the included SpawnConfig (e.g. level_enemy_overrides.json) sets the Huntsman as the main mob for level 1. This mapping applies when EnableSpawnOverrides is turned on in BepInEx/config/raisery.noblemod.cfg (it is off by default).

Warning: the default sounds are taken from videos with crude / vulgar language. Use discretion when streaming, in public, or around minors—turn off custom sound replacement or swap the files for content that fits your context.

Custom sounds (CustomSounds)

• Replace vanilla audio clips with your .ogg files, declared in CustomSounds/replacements.json (shipped with the package or editable after install).
• Match clips by exact name, or use contains: / exact: rules on clip names.
• Weighted picks: one rule can list several variants (custom files and/or keep vanilla with { "vanilla": true, "weight": … }). Weights are normalized automatically.
• Optional Unity hierarchy filter (AudioSourceHierarchyFilter) so only certain AudioSource paths are processed (default: game-wide).
• Discovery: while playing, the mod can write encountered clip names to a hierarchical JSON to help you extend your mapping (see raisery.noblemod.cfg).

Spawn overrides (SpawnConfig, optional)

• JSON file (default SpawnConfig/level_enemy_overrides.json) maps a level index to a main mob id to force.
• Off by default (EnableSpawnOverrides); when enabled, applies the mapping when valid, otherwise vanilla fallback with logging.

In-game menu

• Dedicated entry (NobleMod Settings / NOBLEMOD depending on build) under the game settings.
• Toggle custom sounds and spawn overrides at runtime; changes are saved to the BepInEx config file.

Advanced configuration

• Auto-generated config: BepInEx/config/raisery.noblemod.cfg.
• Many toggles: replacement logs, clip discovery, audio debug, weighted-pick logging, etc. (General, Spawning, Debug sections).

Installation (Thunderstore)

With Thunderstore Mod Manager / the Thunderstore app, dependencies install with the package. The manager extracts the zip (DLL + folders at package root) into your game profile; anything next to NobleMod.dll (CustomSounds, SpawnConfig, …) is what the mod loads.

Notes

• To edit replacements.json or spawn overrides after install, use the files in your manager’s mod folder (same directory as the DLL).
• The project repository has fuller developer docs (JSON mapping details, spawn rules, build steps).