NobleMod

NobleMod ajoute pour R.E.P.O. :

• un panneau d’options accessible depuis les paramètres du jeu (réglages du mod, dont le spawn) ;
• un pack de sons personnalisés, compatible loaforcsSoundAPI (installé à part via ton gestionnaire de mods).

Auteur : Raisery — dépôt : GitHub

Dépendances

Le gestionnaire installe en général les dépendances du manifest. En résumé : BepInEx, REPOLib, loaforcsSoundAPI, MenuLib (menu in-game). Pour les boucles avec plusieurs sons pondérés (humming chasseur), NobleMod inclut une option documentée dans le README du dépôt.

Historique des versions

Liste des changements : CHANGELOG.md sur le dépôt (le même fichier est aussi inclus à la racine du zip Thunderstore pour alimenter la page du mod sur le site).

Documentation technique

Build depuis les sources, arborescence du pack, spawn, scripts : tout est décrit dans le README.md à la racine du dépôt GitHub.

Changelog

[1.1.1] - 2026-05-13

Ajouté

• Interrupteurs ON/OFF par fichier replacer (menu NobleMod, section « Replacer : … »), modifiables en pleine partie. Un ConfigEntry<bool> par fichier sous [Replacers] (Enable_<nom_fichier>, défaut true).
  • Filtrage runtime : postfix Harmony sur SoundReplacementHandler.TryGetReplacementClip — si le toggle du fichier source est OFF, le remplacement est annulé (__result = false) et le son vanilla s’applique aux prochains déclenchements.
  • Coupure locale : passage OFF → AudioSource.Stop() sur les sources suivies pour ce fichier ; pas de réplication réseau (le pool multijoueur continue de tourner pour les autres joueurs).
• Sound pack : extension des replacers (headman.json, hunter.json, noblemod.json, object-destroy.json, player.json dans replacers/) — chaque fichier apparaît automatiquement comme toggle au prochain démarrage après installation.

Technique

• Découverte fiable : SoundAPI ne remplit pas SoundPack.ReplacementCollections pour les JSON sous replacers/ ; le scan parcourt le dictionnaire interne SoundPackDataHandler.SoundReplacements et regroupe par SoundReplacementCollection.FilePath sous le dossier de NobleMod.dll.
• Correctifs : réflexion LoadedPacks avec getter interne ; postfix AddLoadedPack avec type SoundPack qualifié (conflit de namespace NobleMod.SoundPack) ; reconstruction de la popup menu si des replacers sont découverts après la première construction du cache.

[1.1.0] - 2026-05-13

Ajouté

• Cohérence multijoueur des sons aléatoires : tous les joueurs entendent désormais la même variante quand un son a plusieurs candidats. Le master diffuse un pool d'entiers partagé via REPOLib NetworkedEvent (Photon, EventCaching.AddToRoomCacheGlobal pour que les joueurs qui rejoignent en cours de partie reçoivent immédiatement le dernier pool), chaque client l'indexe localement via une clé stable (matches du groupe + ViewID du PhotonView le plus proche + clip vanilla + occurrence temporelle quantifiée sur PhotonNetwork.Time) — pas de trafic réseau par tirage, juste un broadcast initial + topup périodique. Couvre :
  • Les tirages NobleMod:random_slot (mode plage R et mode slot, sticky et non-sticky).
  • Les tirages internes SoundAPI (UnityEngine.Random.Range dans SoundReplacementHandler.TryGetReplacementClip : choix du groupe quand plusieurs matchent + choix pondéré du son). Patch Harmony qui sauvegarde/restaure Random.state autour d'un InitState déterministe — couvre par exemple noblemod_headman.json où chacarron / smash-mouth étaient tirés indépendamment chez chaque joueur.
• Config (fichier seul, pas de toggle menu) section [Multiplayer] :
  • EnableMultiplayerSoundSync (défaut true).
  • MultiplayerSoundPoolSize (défaut 256, borne [16..4096]).
  • MultiplayerSoundPoolRefreshIntervalSeconds (défaut 300, 0 = jamais après init / changement de niveau).
  • LogMultiplayerSoundSync (défaut false) — log VERBEUX par évaluation. Les événements critiques (broadcast pool, réception, transitions room/master/player count, heartbeat 15 s) sont toujours loggés.
• Architecture :
  • Driver de polling branché via Harmony postfix sur Photon.Pun.PhotonHandler.LateUpdate plutôt que sur BaseUnityPlugin.Update (non invoqué de façon fiable dans le contexte BepInEx / REPO observé).
  • Patch SoundAPI installé manuellement (résolution TryGetReplacementClip par nom, sans contrainte de signature) pour rester silencieusement no-op si une future version de loaforcsSoundAPI change l'API — pas d'exception qui casserait Harmony.PatchAll.
• Fallback automatique : si la sync est OFF, pas en room, room solo (≤ 1 joueur), pool pas encore reçu, ou clé non identifiable → retour à UnityEngine.Random.Range local (comportement actuel, aucune régression).
• Validé en multijoueur réel (2 PC, master + client distant) : même eventCode négocié, génération de pool alignée, sons synchronisés sans latence perceptible.

[1.0.3] - 2026-05-12

Ajouté

• Ce fichier CHANGELOG.md pour suivre les changements entre releases.
• Condition SoundAPI NobleMod:random_slot : mode slot (slot, count, slot_weights optionnel pour pondération), mode plage (random_match / random_number, syntaxe value-range SoundAPI, tirage R uniforme 1..1000 partagé, .. et normalisation ... → ..), option sticky ; Harmony sur loaforcsSoundAPI.Core.AudioSourceAdditionalData.Update pour le contexte d’évaluation + clamp AudioSource.time après swap de clip.
• Config : EnableNobleModSoundPackConditions ([SoundPack], défaut true) + toggle menu « Conditions pack NobleMod (SoundAPI) » ; LogRandomSlotRange (défaut false) — log R = … -> son ….ogg uniquement quand R change par source ; LogStickyAttachDetach (défaut false) — logs Sticky plage|slot : branché / débranché (premier attache, nouveau clip, boucle) ; LogSoundPickEachMatch (défaut false) + toggle « Log chaque son selectionne (random_slot) » — à chaque évaluation où la ligne matche, log du nom du fichier sound (très verbeux avec update_every_frame).
• Sound pack : replacers/noblemod_hunter_hum.json avec update_every_frame, conditions plage + sticky: true pour le clip enemy hunter humming loop.

Modifié

• Audio : délégation à loaforcsSoundAPI (sound pack) ; suppression de l’ancien reshuffle humming côté DLL au profit de update_every_frame dans le JSON.
• Dépôt : arborescence src/, content/ (sound-pack, spawn, samples), build/ ; code C# déplacé hors racine (anciens Plugin.cs, SoundBank, patches audio internes, parseurs remplacements, etc. supprimés au profit du sound pack) ; BepInDependency me.loaforc.soundapi ; référence de build me.loaforc.soundapi.dll (copie via build/Copy-RepoRefs.ps1).
• Spawn : helper RunLevel.TryGetCurrentLevelNumber() (src/RunLevel.cs) partagé avec les patches d’override pour lire le niveau courant via RunManager / levelsCompleted.
• .gitignore : ignore les assets lourds ou locaux (content/sound-pack/sounds/, content/spawn/, refs/, dist/, bin/, obj/, thunderstore/, .cursor/, etc.) pour garder le dépôt léger.
• Thunderstore : description du manifest.json courte ; détails dans le README ; pas de dépendance au paquet deprecated loaforcsSoundAPI_REPO (BepInEx + REPOLib + loaforcsSoundAPI + MenuLib) ; REPOLib en dépendance BepInEx dure côté plugin et Zehs-REPOLib-4.0.2 épinglé dans le manifest.
• Sound pack : matches au format trois segments *:*:nom du clip.

Corrigé

• Audio (clamp) : le clamp sur chaque écriture de AudioSource.time et la marge sous la fin du clip coupaient souvent le son avant la fin et perturbaient le début ; désormais correction seulement si la position est hors clip (< 0, ≥ length, NaN). Patch du setter time retiré.
• LogSoundPickEachMatch : résolution du nom du fichier via SoundInstance.Sound ou réflexion sur Parent (propriétés/champs courants) ; si introuvable, log du type Parent pour diagnostic.
• Retrait du cycle « hold après débranchement + une frame de latch » sur le sticky plage : il forçait des conditions à false trop longtemps et provoquait des sons qui ne démarrent pas au début et coupures avant la fin avec SoundAPI.
• NobleMod:random_slot (sticky) : si isPlaying était faux un court instant, le code retirait un nouveau R (coalesced) au lieu de garder ChosenPick → coupure de son ; réutilisation de ChosenPick avec le même clip ; seuil de saut arrière 0.18s. Idem mode slot sticky. Warmup par groupe : tant que la source n’est pas prête (null / pas de clip / !isPlaying sans état pause), un même R (ou slot) est figé par SoundReplacementGroup au lieu du tirage coalescé par frame, pour éviter plusieurs changements de tirage avant le premier play réel. Anti-churn : pendant 64 frames après un attache complet, une empreinte qui fluctue encore trop vite ne déclenche pas refresh de R/logs. Anti-faux « boucle » : 40 frames après attache, pas de détection boucle ; jumpedBack exige en plus une position inférieure à 0,4 s. Identité logique : nom normalisé (sans préfixe NobleMod ) ⇒ empreinte = hash du nom seul (les copies vanilla / pack ne divergent plus sur la durée) ; clip au nom vide ⇒ même empreinte si longueur à ≤ 0,35 s près du dernier nom vu ; sinon hash longueur/fréquence/canaux ; reset d’ancre sur vrai changement de clip.
• Packaging : zip Thunderstore via ZipArchive et chemins relatifs explicites.

Note

• L’expérimentation reshuffle humming en DLL a été retirée au profit du sound pack SoundAPI documenté ci-dessus.

[1.0.2] - 2026-05-09

Modifié

• Audio : délégation à loaforcsSoundAPI (sound pack : sound_pack.json, replacers/, sounds/). Suppression du remplacement audio Harmony interne (SoundBank, patches dédiés).
• Dépôt : arborescence src/, content/ (sound-pack, spawn, samples), build/ (scripts PowerShell).
• Thunderstore : archive avec chemins BepInEx/plugins/NobleMod/... (aligné sur les paquets REPO courants).

Corrigé

• Génération du zip Thunderstore via ZipArchive et chemins relatifs explicites (évite les soucis de Compress-Archive selon les versions PowerShell).

[1.0.1] - 2026-05-08

Modifié

• Itérations sur le packaging Thunderstore et les scripts d’installation profil (voir 1.0.2 pour la forme stabilisée).

[1.0.0]

Ajouté

• Première base publique du mod : plugin BepInEx, intégration menu (MenuLib), config spawn, remplacements audio (format interne, remplacé en 1.0.2 par un sound pack SoundAPI).