Un guide sur comment télécharger et installer des mods dans Hot Dogs, Horseshoes & Hand Grenades (H3VR) sur PC.
H3VR est un jeu de tir bac à sable exclusivement en VR avec l'une des scènes de mods les plus anciennes en VR, et la quasi-totalité vit sur Thunderstore. Les mods sont des plugins BepInEx, et les mods d'armes que tout le monde recherche reposent sur une petite pile de bibliothèques partagées.
Notre exemple est Meats ModulAR, un gros pack d'AR modulaires. Ce n'est délibérément pas un mod simple, car les packs d'armes de H3VR le sont rarement, et la chaîne de dépendances est justement ce qu'il vaut la peine de comprendre.
Prérequis
- Un PC sous Windows 10 ou version ultérieure. Linux via Proton fonctionne, avec une option de lancement supplémentaire abordée plus bas.
- H3VR sur Steam.
- Un casque VR et un runtime fonctionnels. H3VR prend en charge les casques SteamVR ainsi que les appareils Oculus et Windows Mixed Reality via celui-ci.
- Plusieurs Go d'espace libre. Les gun packs embarquent beaucoup de modèles, textures et audio, et une liste de mods H3VR sérieuse grossit vite.
- 7-Zip ou équivalent si vous installez à la main.
H3VR est un jeu solo sans anti-triche, donc il n'y a rien à craindre de ce côté-là.
VR uniquement, pas de mode écran plat
À dire clairement avant tout le reste. H3VR est un exclusif VR sans mode écran plat, et les mods ne changent rien à cela. Si vous n'avez pas de casque, rien de tout ceci ne s'applique.
Il n'y a pas non plus de versions console, donc tout ce qui suit concerne uniquement le PC.
Ce qui est installé
BepInEx
BepInExPack H3VR est le loader. Il s'installe dans le dossier du jeu, s'accroche au jeu au lancement, et charge les plugins depuis BepInEx/plugins.
Utilisez le pack spécifique à H3VR plutôt que le BepInEx générique. Il est figé à la version 5.4.1700 et préconfiguré pour ce jeu, et la communauté développe en se basant dessus.
OtherLoader et ses amis
C'est là que H3VR diffère de la plupart des jeux sous BepInEx. Un gun pack n'est pas vraiment du « code », c'est un ensemble d'objets, et faire entrer ces objets dans le spawner de H3VR et ses systèmes de progression nécessite une infrastructure partagée.
Meats ModulAR dépend de quelques-uns d'entre eux :
| Dépendance | Ce qu'elle fait |
|---|---|
| OtherLoader | Charge les bundles d'objets personnalisés dans le jeu et gère les entrées du spawner correspondantes. |
| H3VRUtilities | Une bibliothèque partagée de longue date sur laquelle repose une énorme partie de la scène. |
| OpenScripts | Des scripts de comportement génériques que les auteurs de mods attachent à des pièces personnalisées. |
| FTW Arms AFCL | Une bibliothèque partagée d'accessoires et de pièces pour les mods d'armes modulaires. |
| Meats ModulARpt2 | La seconde moitié du mod lui-même, séparée à cause des limites de taille des paquets Thunderstore. |
Chacun d'entre eux doit être présent, dans une version compatible, avant que le pack d'armes ne fonctionne. C'est tout l'argument en faveur de l'utilisation d'un gestionnaire de mods plutôt que du téléchargement manuel des fichiers.
NOTE - Le découpage des gros packs en packages partie 1 et partie 2 est normal sur le Thunderstore de H3VR. Si vous n'installez que la première moitié, attendez-vous à des armes manquantes plutôt qu'à une erreur propre.
Installation avec r2modman
r2modman est la recommandation habituelle pour H3VR et celle que la plupart des pages de mods supposent.
- Téléchargez r2modman depuis Thunderstore ou depuis les releases GitHub.
- Lancez-le et choisissez H3VR.
- Créez un profil. Vu la taille que peuvent atteindre les listes de mods H3VR, avoir un profil par thème de loadout est réellement utile, pas juste une question d'ordre.
- Cliquez sur Online, recherchez Meats ModulAR, et ouvrez le résultat de Meat_banono.
- Cliquez sur Download, puis sur Download with dependencies.
- Attendez. Cela télécharge plusieurs centaines de Mo et inclut OtherLoader, H3VRUtilities, OpenScripts, la bibliothèque de pièces FTW et ModulAR part 2.
- Vérifiez l'onglet Installed. Tout doit être listé sans icône d'avertissement.
- Cliquez sur Start modded.
Lancer H3VR depuis Steam le démarre en version vanilla à la place. Les mods sont rattachés par le gestionnaire au moment du lancement, donc le lancement doit se faire depuis r2modman.
Installation avec Thunderstore Mod Manager
Thunderstore Mod Manager est construit sur r2modman et fonctionne de la même façon derrière un wrapper Overwolf.
- Installez-le et choisissez H3VR.
- Choisissez un profil.
- Cliquez sur Get mods, trouvez Meats ModulAR, et cliquez sur Download.
- Acceptez la liste des dépendances.
- Cliquez sur Start modded.
Les deux gestionnaires font l'affaire. r2modman est le meilleur choix sous Linux, et le seul à proposer une version macOS, bien que H3VR lui-même n'ait pas de sortie macOS.
Installation manuelle
Possible, et une vraie corvée pour un mod comme celui-ci. Le faire une fois pour un petit mod est instructif ; le faire pour un gun pack complet n'est pas la meilleure façon de passer une soirée.
Trouvez le dossier de votre jeu en faisant un clic droit sur H3VR dans Steam, puis Gérer et Parcourir les fichiers locaux :
C:\Program Files (x86)\Steam\steamapps\common\H3VR
- Téléchargez BepInExPack H3VR avec Manual Download et extrayez-le.
- Copiez le contenu du dossier
BepInExPack_H3VRdans le dossier H3VR, afin queBepInEx,doorstop_config.inietwinhttp.dllse trouvent à côté deh3vr.exe. - Lancez le jeu une fois puis quittez, ce qui crée
BepInEx/plugins. - Téléchargez chaque dépendance listée sur la page Thunderstore du mod, aux versions exactes indiquées, ainsi que tout ce dont elles dépendent à leur tour.
- Extrayez chacune et copiez son contenu dans
BepInEx/plugins, en gardant chaque mod dans son propre sous-dossier pour pouvoir les distinguer plus tard. - Faites de même pour Meats ModulAR et ModulAR part 2.
ATTENTION - Gardez chaque mod dans son propre dossier sous plugins. Les mods H3VR livrent des asset bundles avec des noms génériques, et regrouper plusieurs packs dans un seul dossier est un moyen sûr de les faire s'écraser mutuellement.
ASTUCE - OtherLoader lit les item bundles depuis les dossiers de plugins qu'il scanne. Si un gun pack s'installe correctement mais qu'aucune nouvelle arme n'apparaît dans le spawner, une structure de dossiers mal faite lors d'une installation manuelle est la première chose à vérifier.
Installation avec l'application TMC
Une dernière option, et c'est la nôtre. The TMC App est un gestionnaire de mods et navigateur de serveurs que nous développons. Ses sandboxes sont des profils de mods nommés par jeu, chacun avec son propre ordre de chargement et sa méthode de déploiement, et passer de l'un à l'autre ne retélécharge rien. Pour un jeu où les gens gardent des listes séparées pour des loadouts différents et où chaque liste met une éternité à charger, c'est une fonctionnalité qui a un attrait évident.
H3VR ne figure pas encore dans sa liste de jeux pris en charge. Ajouter un jeu revient à créer quatre fichiers JSON plutôt que du code, ce n'est donc pas un gros travail.
Avant de vous emballer : l'application est en tout début de développement. Son README le dit, et nous aussi. Une grande partie n'est que partiellement testée, et pour une pile de mods aussi chargée en dépendances que celle de H3VR, r2modman reste l'outil sur lequel s'appuyer. Essayez l'application en parallèle si vous le souhaitez, et si vous le faites, dites-nous comment ça s'est passé. Les retours précoces valent presque plus que tout le reste pour nous à ce stade.
Elle est open source sous licence GPL-3.0 sur github.com/modcommunity/tmc-app. Le suivi des problèmes accueille les bugs et demandes de fonctionnalités, les pull requests sont les bienvenues, et le dépôt documente comment un jeu est ajouté si vous souhaitez contribuer au support de H3VR.
Installation :
- Linux : une seule ligne, sans root et sans gestionnaire de paquets.
curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh
- Windows : le
setup.exeousetup.msidepuis la page des releases. Il existe aussi une version portable, bien qu'elle n'enregistre pas l'entrée du lanceur ni le gestionnaire de lienstmc://. - macOS : le
.dmgdepuis la même page des releases.
Trouver les armes moddées en jeu
Les mods d'armes installés ne remplacent rien. Ils apparaissent aux côtés de l'arsenal vanilla.
Chargez n'importe quelle scène bac à sable et ouvrez l'Item Spawner. Les armes moddées apparaissent dans les mêmes listes de catégories que les armes de base, généralement avec les propres tags du mod ou sur une page séparée selon la manière dont l'auteur l'a configuré. Meats ModulAR ajoute des récepteurs AR modulaires ainsi qu'un grand nombre de pièces, donc attendez-vous à des entrées à la fois dans les catégories armes à feu et attachements.
Si le jeu démarre avec les mods chargés mais que le spawner a l'air vanilla, c'est un problème d'OtherLoader plutôt que de BepInEx, et la console BepInEx le mentionnera généralement.
Gérer les mods dans le temps
r2modman affiche un badge de mise à jour à côté de tout ce qui a une nouvelle version sur Thunderstore, et Update all s'occupe de la liste. Comme les gun packs de H3VR dépendent de bibliothèques partagées, mettre à jour un mod peut entraîner une bibliothèque plus récente sur laquelle un pack plus ancien n'a pas été construit. Cloner un profil avant une grosse vague de mises à jour est une assurance bon marché ici.
Désactiver un mod dans la liste installée laisse ses fichiers intacts. La désinstallation les supprime.
Pour revenir entièrement au vanilla, supprimez BepInEx, doorstop_config.ini et winhttp.dll du dossier du jeu. La vérification des fichiers de Steam ne les supprimera pas, car Steam ne les a pas installés.
Dépannage
Le jeu se lance sans mods. Vous l'avez démarré depuis Steam. Utilisez Start modded.
Pas de console BepInEx. BepInEx ne se charge pas. Vérifiez que winhttp.dll se trouve directement à côté de h3vr.exe.
Les mods se chargent mais aucune nouvelle arme dans le spawner. OtherLoader est manquant, obsolète, ou les item bundles sont mal placés. Réinstallez le mod avec ses dépendances via votre gestionnaire.
Temps de chargement longs et saccades. Normal au-delà d'un certain nombre de mods. H3VR charge chaque item bundle au démarrage, et les grandes listes prennent effectivement du temps. Répartir les mods entre plusieurs profils plutôt que de tout faire tourner en même temps aide beaucoup.
Textures manquantes ou modèles roses. Généralement un pack installé à moitié, le plus souvent un package part 2 qui a été oublié.
Crash au démarrage après une mise à jour du jeu. H3VR se met à jour par blocs assez conséquents et les mods cassent avec. Déplacez BepInEx/plugins de côté pour confirmer, puis attendez les auteurs.
Linux et Proton. Réglez les options de lancement Steam de H3VR sur WINEDLLOVERRIDES="winhttp=n,b" %command%. r2modman gère cela lui-même quand vous lancez le jeu depuis lui.
Conclusion
Les installations de mods pour H3VR sont simples tant que vous laissez un gestionnaire de mods résoudre la chaîne de dépendances. Installez r2modman, choisissez H3VR, téléchargez avec les dépendances, et lancez en mode moddé.
Les deux points spécifiques à H3VR à retenir : les gun packs ont besoin d'OtherLoader et de ses compagnons pour apparaître dans le spawner, et les gros packs sont divisés en plusieurs packages Thunderstore qu'il faut tous installer.
Si vous avez du temps à consacrer, TMC App est open source, en début de développement, et les retours à son sujet seraient sincèrement appréciés.
Voir aussi
- H3VR sur Thunderstore
- H3VR Modding Wiki - Le wiki communautaire de modding actuel.
- H3VR Modding Discord
- Official H3VR Wiki - Le wiki du jeu plutôt qu'un wiki de modding, mais utile pour déterminer ce qui est vanilla.
- TMC App
Nous maintenons ce guide à jour dans la mesure du possible, mais H3VR, BepInEx et les bibliothèques partagées évoluent tous indépendamment. Si une instruction ici ne correspond plus à ce que vous observez, merci de le signaler ou d'ouvrir une pull request sur le dépôt GitHub de ce guide.
Rejoignez notre serveur Discord si vous avez des questions ou besoin d'aide sur tout ce qui touche au modding !

