Руководство о том, как скачивать и устанавливать моды в Hot Dogs, Horseshoes & Hand Grenades (H3VR) на ПК.
H3VR — это VR-only песочница-шутер с одной из самых долгоживущих модерских сцен в VR, и практически всё это живёт на Thunderstore. Моды представляют собой плагины BepInEx, а моды на оружие, ради которых все сюда приходят, строятся поверх небольшого стека общих библиотек.
Наш пример — Meats ModulAR, большой модульный пак AR. Это намеренно не простой мод, потому что оружейные паки для H3VR редко бывают простыми, и именно цепочку зависимостей стоит понимать.
Требования
- ПК с Windows 10 или новее. Linux через Proton тоже работает, с дополнительным параметром запуска, о котором ниже.
- H3VR в Steam.
- Рабочая VR-гарнитура и рантайм. H3VR поддерживает SteamVR-гарнитуры, а также Oculus и Windows Mixed Reality через него.
- Несколько ГБ свободного места. Оружейные паки содержат много моделей, текстур и звука, и серьёзный список модов для H3VR быстро разрастается.
- 7-Zip или аналог, если устанавливаете вручную.
H3VR — однопользовательская игра без античита, так что по этому поводу переживать не о чем.
Только VR, без плоского режима
Стоит сказать прямо с самого начала. H3VR — это VR-эксклюзив без плоского (flatscreen) режима, и моды это не меняют. Если у вас нет гарнитуры, всё нижесказанное неприменимо.
Консольных версий тоже нет, так что всё написанное ниже касается только ПК.
Что устанавливается
BepInEx
BepInExPack H3VR — это загрузчик. Он ставится в папку игры, подключается к игре при запуске и загружает плагины из BepInEx/plugins.
Используйте специфичный для H3VR пак, а не обычный BepInEx. Он закреплён на версии 5.4.1700 и предварительно настроен под эту игру, и сообщество собирает моды именно под него.
OtherLoader и его друзья
Вот здесь H3VR отличается от большинства игр с BepInEx. Оружейный пак — это не совсем «код», это набор предметов, и чтобы эти предметы попали в спавнер H3VR и в его системы прогрессии, нужна общая инфраструктура.
Meats ModulAR зависит от нескольких из них:
| Зависимость | Что делает |
|---|---|
| OtherLoader | Загружает пользовательские бандлы предметов в игру и обрабатывает записи для них в спавнере. |
| H3VRUtilities | Давняя общая библиотека, на которой строится огромная часть модов сцены. |
| OpenScripts | Общие скрипты поведения, которые авторы модов прикрепляют к кастомным деталям. |
| FTW Arms AFCL | Общая библиотека креплений и деталей для модульных оружейных модов. |
| Meats ModulARpt2 | Вторая половина самого мода, разделённая из-за ограничений на размер пакета Thunderstore. |
Каждый из них должен присутствовать в совместимой версии, прежде чем оружейный пак вообще заработает. Это и есть главный аргумент в пользу использования менеджера модов вместо ручной загрузки файлов.
ПРИМЕЧАНИЕ — Разделение больших паков на пакеты part 1 и part 2 — обычное дело на Thunderstore для H3VR. Если установить только первую половину, стоит ожидать отсутствия части оружия, а не чёткой ошибки.
Установка через r2modman
r2modman — обычная рекомендация для H3VR, и именно его подразумевает большинство страниц модов.
- Скачайте r2modman с Thunderstore или из релизов на GitHub.
- Запустите его и выберите H3VR.
- Создайте профиль. Учитывая, насколько большими становятся списки модов для H3VR, иметь по одному профилю на тему сборки — это по-настоящему полезно, а не просто аккуратно.
- Нажмите Online, найдите Meats ModulAR и откройте результат от Meat_banono.
- Нажмите Download, затем Download with dependencies.
- Подождите. Это скачает несколько сотен МБ и включит OtherLoader, H3VRUtilities, OpenScripts, библиотеку деталей FTW и ModulAR part 2.
- Проверьте вкладку Installed. Всё должно быть в списке без значков предупреждений.
- Нажмите Start modded.
Запуск H3VR из Steam вместо этого запустит её без модов. Моды подключаются менеджером в момент запуска, так что запускать нужно именно из r2modman.
Установка через Thunderstore Mod Manager
Thunderstore Mod Manager построен на r2modman и работает так же, но под оболочкой Overwolf.
- Установите его и выберите H3VR.
- Выберите профиль.
- Нажмите Get mods, найдите Meats ModulAR и нажмите Download.
- Примите список зависимостей.
- Нажмите Start modded.
Оба менеджера подходят. r2modman — лучший выбор на Linux и единственный с версией под macOS, хотя сама H3VR не имеет релиза для macOS.
Установка вручную
Возможно, и для мода вроде этого — настоящая морока. Проделать это один раз для небольшого мода — познавательно; делать то же самое для полноценного оружейного пака — не лучшее занятие на вечер.
Найдите папку игры, кликнув правой кнопкой по H3VR в Steam, затем Manage и Browse local files:
C:\Program Files (x86)\Steam\steamapps\common\H3VR
- Скачайте BepInExPack H3VR через Manual Download и распакуйте его.
- Скопируйте содержимое папки
BepInExPack_H3VRв папку H3VR так, чтобыBepInEx,doorstop_config.iniиwinhttp.dllоказались рядом сh3vr.exe. - Запустите игру один раз и выйдите — это создаст
BepInEx/plugins. - Скачайте все зависимости, указанные на странице мода на Thunderstore, точно тех версий, что там названы, плюс всё, от чего зависят они сами.
- Распакуйте каждую и скопируйте содержимое в
BepInEx/plugins, держа каждый мод в отдельной подпапке, чтобы потом можно было их различить. - Проделайте то же самое с Meats ModulAR и ModulAR part 2.
ПРЕДУПРЕЖДЕНИЕ - Держите каждый мод в отдельной папке внутри plugins. Моды H3VR поставляются с asset bundle с общими названиями, и если свалить несколько паков в одну папку, они с высокой вероятностью перезапишут файлы друг друга.
СОВЕТ - OtherLoader считывает бандлы предметов из папок плагинов, которые он сканирует. Если пак с оружием установился без ошибок, но новых стволов в спавнере нет, первым делом стоит проверить неправильную структуру папок после ручной установки.
Установка через TMC App
Ещё один вариант, и это наш собственный. The TMC App — это менеджер модов и браузер серверов, который мы разрабатываем. Его sandboxes — это именованные профили модов для каждой игры, у каждого свой порядок загрузки и способ развёртывания, и переключение между ними ничего заново не скачивает. Для игры, где люди держат отдельные списки под отдельные сборки и где каждый список загружается целую вечность, это функция с очевидной привлекательностью.
H3VR пока нет в списке поддерживаемых игр. Добавление игры — это четыре JSON-файла, а не код, так что это не такая уж большая работа.
Прежде чем радоваться раньше времени: приложение находится на очень ранней стадии разработки. Об этом сказано в его README, и мы повторим то же самое. Многое в нём протестировано лишь частично, и для такого зависимого от цепочки библиотек мод-стека, как в H3VR, r2modman всё ещё остаётся инструментом, на который стоит полагаться. Обязательно попробуйте приложение параллельно с ним, и если попробуете — расскажите нам, как всё прошло. Ранняя обратная связь для нас сейчас ценнее почти всего остального.
Это открытый исходный код под лицензией GPL-3.0 на github.com/modcommunity/tmc-app. Трекер issue принимает баги и предложения по фичам, pull request'ы приветствуются, а в репозитории описано, как добавляется игра, если вы хотите внести поддержку H3VR.
Установка:
- Linux: одна строка, без root и без пакетного менеджера.
curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh
- Windows:
setup.exeилиsetup.msiсо страницы релизов. Есть и портативная сборка, хотя она не регистрирует запись лаунчера или обработчик ссылокtmc://. - macOS:
.dmgс той же страницы релизов.
Поиск модифицированного оружия в игре
Установленные оружейные моды ничего не заменяют. Они появляются рядом с ванильным арсеналом.
Загрузитесь в любую песочницу и откройте Item Spawner. Модифицированное оружие отображается в тех же категориях, что и стандартное, обычно с собственными тегами мода или на отдельной странице — в зависимости от того, как это настроил автор. Meats ModulAR добавляет модульные ресиверы AR и большой набор деталей, так что ждите записей и в категории оружия, и в категории обвесов.
Если игра запускается с загруженными модами, но спавнер выглядит как в ванили, это проблема OtherLoader, а не BepInEx, и консоль BepInEx обычно об этом сообщает.
Управление модами со временем
r2modman показывает значок обновления рядом с любым модом, у которого вышел новый релиз на Thunderstore, и Update all обновляет весь список. Поскольку оружейные паки H3VR зависят от общих библиотек, обновление одного мода может подтянуть более новую библиотеку, под которую старый пак не был собран. Клонирование профиля перед большим раундом обновлений — дешёвая страховка в этом случае.
Отключение мода в списке установленных не трогает его файлы. Удаление же убирает их.
Чтобы полностью вернуться к ванили, удалите BepInEx, doorstop_config.ini и winhttp.dll из папки с игрой. Проверка файлов Steam их не удалит, потому что Steam их не устанавливал.
Решение проблем
Игра запускается без модов. Вы запустили её из Steam. Используйте Start modded.
Нет консоли BepInEx. BepInEx не загружается. Проверьте, что winhttp.dll находится прямо рядом с h3vr.exe.
Моды загружаются, но новых стволов в спавнере нет. OtherLoader отсутствует, устарел, либо бандлы предметов лежат не там. Переустановите мод вместе с зависимостями через ваш менеджер.
Долгая загрузка и подтормаживания. Нормальное явление после определённого количества модов. H3VR загружает каждый бандл предметов при старте, и большие списки действительно занимают время. Разделение модов по профилям вместо запуска всего сразу сильно помогает.
Отсутствующие текстуры или розовые модели. Обычно означает наполовину установленный пак, чаще всего пропущенный package part 2.
Краш при запуске после обновления игры. H3VR обновляется довольно крупными кусками, и моды из-за этого ломаются. Уберите BepInEx/plugins в сторону, чтобы это подтвердить, и подождите, пока авторы всё поправят.
Linux и Proton. Установите параметры запуска H3VR в Steam на WINEDLLOVERRIDES="winhttp=n,b" %command%. r2modman делает это самостоятельно при запуске через него.
Заключение
Установка модов для H3VR проста, если позволить менеджеру модов разрешить цепочку зависимостей. Установите r2modman, выберите H3VR, скачайте с зависимостями и запустите с модами.
Две специфичные для H3VR вещи, которые стоит запомнить: паки с оружием нуждаются в OtherLoader и его спутниках, чтобы вообще появиться в спавнере, а крупные паки разбиваются на несколько пакетов Thunderstore, которые все нужно устанавливать.
Если у вас есть свободное время, TMC App — с открытым исходным кодом, находится на ранней стадии разработки, и обратная связь по нему будет по-настоящему ценна.
Смотрите также
- H3VR on Thunderstore
- H3VR Modding Wiki - Актуальная вики сообщества по моддингу.
- H3VR Modding Discord
- Official H3VR Wiki - Вики самой игры, а не по моддингу, но полезна для того, чтобы понять, что относится к ванильной версии.
- TMC App
Мы стараемся поддерживать это руководство в актуальном состоянии, но H3VR, BepInEx и общие библиотеки развиваются независимо друг от друга. Если какая-то инструкция здесь больше не соответствует тому, что вы видите, пожалуйста, сообщите об этом или откройте pull request в GitHub-репозитории этого руководства.
Присоединяйтесь к нашему серверу Discord, если у вас есть вопросы или нужна помощь с чем-либо, связанным с моддингом!

