Главная
Блог
Как устанавливать моды в BONELAB (2026)

Как устанавливать моды в BONELAB (2026)

Полное руководство по загрузке и установке модов в Bonelab, включая использование менеджеров модов, таких как Thunderstore.

September 20, 20269 мин чтенияОбновлено September 20, 2026
Как устанавливать моды в BONELAB (2026)

Руководство о том, как скачивать и устанавливать моды в BONELAB на PC и на Meta Quest.

BONELAB — необычная игра среди тех, для которых мы пишем эти руководства, потому что в ней есть две полностью независимые системы моддинга, и они выполняют разные задачи:

  • mod.io встроен прямо в игру. Он работает на PC и на автономном Quest, не требует внешних инструментов и охватывает аватары, карты и предметы для спавна.
  • MelonLoader — это загрузчик модов только для PC, предназначенный для кодовых модов, то есть тех, которые меняют реальное поведение игры. Они находятся на Thunderstore.

То, что вам нужно, полностью зависит от типа мода, который вы ищете. Мы разберём оба варианта, и в качестве наглядного примера для стороны MelonLoader используем Ragdoll Player.

Требования

Для контента mod.io:

  • BONELAB на любой поддерживаемой платформе, включая автономные Quest 2, Quest 3 и Quest Pro.
  • Бесплатный аккаунт mod.io.

Для кодовых модов MelonLoader дополнительно нужно:

  • PC с Windows 10 или новее, с BONELAB в Steam или через приложение Oculus PC. Linux через Proton работает при дополнительном параметре запуска.
  • Microsoft Visual C++ 2015-2019 Redistributable, 64-бит.
  • .NET Desktop Runtime 6.0, x64. BONELAB использует Il2Cpp, и MelonLoader требует этот компонент.
  • Несколько гигабайт свободного места, если вы планируете собирать аватары и карты — они не маленькие.

Две системы, два типа модов

Понять эту разницу заранее — значит сэкономить кучу времени.

mod.io MelonLoader
Где брать Встроен в игру, либо mod.io Thunderstore
Платформы PC и автономный Quest Только PC
Что охватывает Аватары, карты, спавнимые предметы, созданные с помощью BONELAB SDK Кодовые моды, меняющие поведение игры
Нужны доп. инструменты Нет Да, MelonLoader и обычно BoneLib
Пример Кастомный аватар или дополнительный уровень Ragdoll Player, мультиплеер Fusion

Так что если вы хотите играть за другого персонажа или загрузить карту от сообщества, mod.io — это исчерпывающий ответ, и вам никогда не придётся трогать никакие файлы. Если же вы хотите изменить работу игры — это территория MelonLoader, и игрокам на Quest не повезло.

ПРИМЕЧАНИЕ - Автономный Quest не может запускать MelonLoader. Никак это не обойти. Игроки Quest, подключённые к PC через Link или Air Link, запускают PC-версию игры, так что они относятся к стороне PC в этой таблице.

Установка модов через mod.io

Изнутри игры

Это, безусловно, самый простой опыт моддинга среди всех игр в этой подборке.

  1. Запустите BONELAB и загрузитесь в Hub.
  2. Найдите терминал mod.io в Hub и взаимодействуйте с ним.
  3. Войдите в свой аккаунт mod.io. Игра выдаст код, который нужно ввести на mod.io/connect с телефона или в браузере на PC — это избавляет от необходимости набирать пароль VR-контроллерами.
  4. Просмотрите или найдите нужное в каталоге.
  5. Выберите мод и установите его. Он скачивается прямо на устройство.

Установленные аватары появляются на терминалах аватаров, карты — в списке уровней, а спавнимые предметы — в каталоге пушки спавна. Никакой папки искать не нужно, и запускать что-либо иначе тоже не требуется.

С сайта

Вы также можете подготовить моды заранее с компьютера.

  1. Войдите на mod.io/g/bonelab.
  2. Найдите мод и нажмите Subscribe.
  3. Запустите BONELAB, войдя в тот же аккаунт.

Подписки синхронизируются при запуске игры. Это гораздо удобнее для просмотра, чем делать то же самое в шлеме.

СОВЕТ - Подписки привязаны к вашему аккаунту, а не к устройству. Подпишитесь на PC, и те же моды появятся на вашем Quest — это действительно удобно, если вы играете на обеих платформах.

Заметки по Quest

Здесь ограничением выступает объём памяти. Аватары и карты — это полноценный контент Unity, и он быстро накапливается на устройстве, где уже и так всё остальное. Отписка изнутри игры удаляет файлы.

Кроме того, Quest работает на мобильном GPU. Карты, созданные для PC, будут запускаться, но не всегда хорошо, и в описании мода обычно указано, поддерживается ли Quest. Если у мода есть отдельные сборки для PC и Quest, mod.io автоматически выдаёт нужную.

Установка кодовых модов через MelonLoader

Это половина руководства только для PC.

BoneLib

Почти каждый кодовый мод для BONELAB зависит от BoneLib — общей библиотеки, на которой построена сцена. Ragdoll Player не исключение.

Стоит знать об одной тонкости. Раньше BoneLib публиковался в пространстве имён gnonme, а затем переехал в bonelib. Старый пакет gnonme/BoneLib всё ещё существует и теперь просто зависит от нового, поэтому старые моды, ссылающиеся на старое имя, продолжают работать. Если вы видите оба пакета в списке установленных — вот почему, и это не проблема.

Менеджеры модов справляются со всем этим сами. Это имеет значение только при ручной установке.

Использование Gale или r2modman

  1. Скачайте Gale или r2modman и установите их.
  2. Откройте и выберите BONELAB.
  3. Дайте программе обнаружить установку игры, либо укажите путь к папке игры вручную.
  4. Найдите Ragdoll Player и нажмите Install или Download with dependencies.
  5. MelonLoader и BoneLib подтянутся автоматически.
  6. Запустите игру через Launch game (modded) или Start modded.

Запуск BONELAB через Steam или приложение Oculus вместо этого запускает игру без модов.

Установка MelonLoader вручную

Сначала найдите папку игры. В Steam кликните правой кнопкой по BONELAB, затем Управление и Просмотреть локальные файлы:

C:\Program Files (x86)\Steam\steamapps\common\BONELAB

Проще всего воспользоваться MelonLoader Installer. Запустите его, выберите BONELAB из списка обнаруженных игр, выберите стабильную версию и нажмите Install. Если BONELAB не обнаружена, используйте Add Game Manually и укажите путь к BONELAB.exe.

Чтобы сделать это полностью вручную:

  1. Скачайте MelonLoader.x64.zip.
  2. Распакуйте папку MelonLoader в папку BONELAB.
  3. Распакуйте version.dll также в папку BONELAB.
  4. Запустите игру один раз и выйдите — это создаст папки Mods и UserData.

ВНИМАНИЕ - Не включайте nightly-сборки в установщике. Они собираются из последних коммитов и регулярно ломаются. Моды собираются под стабильные релизы.

Установка Ragdoll Player вручную

  1. Скачайте BoneLib и Ragdoll Player через Manual Download.
  2. Распакуйте оба архива.
  3. Скопируйте каждый .dll в папку Mods в директории BONELAB.

Моды MelonLoader кладутся в Mods, а не в папку plugins. Если вы пришли из игры на BepInEx, это то различие в структуре, которое стоит запомнить.

Ragdoll Player при первом запуске создаёт конфиг в UserData, где можно настроить кнопку, запускающую рэгдолл.

Установка через TMC App

Есть и третий путь, о котором стоит знать, хотя он применим только к половине этого гайда, связанной с MelonLoader. TMC App — это наш собственный менеджер модов и браузер серверов, с установкой в один клик и песочницами (sandboxes): именованными профилями модов для каждой игры, каждый со своим порядком загрузки и способом развёртывания, переключаемыми без повторной загрузки.

BONELAB пока нет в списке поддерживаемых игр. Добавление игры сводится к четырём JSON-файлам, а не к коду, так что это не большая работа.

Стоит уточнить два момента. Приложение будет управлять только код-модами; контент mod.io обрабатывается внутри самой игры, и никакой внешний инструмент этого не изменит. И приложение находится на очень раннем этапе разработки, о чём прямо говорится в его собственном README. Многое протестировано лишь частично, поэтому пока используйте его наряду с Gale, а не вместо него. Если попробуете — нам действительно интересно узнать, как всё прошло.

Оно с открытым исходным кодом под лицензией GPL-3.0, на github.com/modcommunity/tmc-app. Отчёты об ошибках и запросы функций — в трекере задач, pull request'ы приветствуются, а в репозитории описан формат для каждой игры, если вы хотите сами добавить поддержку BONELAB.

Установка:

  • Linux: одна строка, без root и без пакетного менеджера.
curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh
  • Windows: setup.exe или setup.msi со страницы релизов. Есть и портативная сборка, хотя она не регистрирует запись в меню и обработчик ссылок tmc://.
  • macOS: .dmg с той же страницы релизов.

Мультиплеер с Fusion

Стоит упомянуть, поскольку это мод, который в итоге хочет большинство. Fusion добавляет полноценный мультиплеер в BONELAB и с большим отрывом является одним из самых скачиваемых модов для игры.

Это мод для MelonLoader, поэтому только для ПК, и он должен быть установлен у всех участников сессии. Поскольку также нужно, чтобы у всех совпадал контент mod.io, есть сопутствующий мод ModioModNetworker, который синхронизирует аватары и карты mod.io между игроками в сессии.

Устанавливайте Fusion так же, как и всё остальное на стороне Thunderstore, и делитесь профилем менеджера модов с тем, с кем играете.

Проверка загрузки модов

Контент mod.io: просто посмотрите. Аватары появляются на терминалах аватаров, карты — в выборе уровня. Если чего-то из подписок не хватает, проверьте, что вы вошли в тот же аккаунт в игре.

Моды MelonLoader: рядом с игрой открывается окно консоли, которое выводит строку для каждого загружаемого мода с именем, версией и автором. Полный лог записывается здесь:

BONELAB\MelonLoader\Latest.log

Этот лог — первое, что стоит проверить, если мод не работает, и первое, что попросит показать любой, кто вам помогает.

Linux

BONELAB запускается через Proton. MelonLoader требует переопределения DLL, поэтому задайте параметры запуска игры в Steam так:

WINEDLLOVERRIDES="version=n,b" %command%

Это version, а не winhttp. MelonLoader и BepInEx используют разные хук-DLL, и перепутать параметры запуска — легко.

Также есть Linux-сборка установщика MelonLoader. Gale и r2modman сами задают переопределение при запуске через них.

Контенту mod.io на Linux ничего особого не требуется, поскольку он полностью обрабатывается внутри игры.

Удаление

mod.io: отпишитесь в игре или на сайте. Файлы будут удалены с устройства.

Отдельный мод MelonLoader: удалите его через ваш менеджер модов, либо удалите его .dll из папки Mods.

MelonLoader полностью: удалите папку MelonLoader, файл version.dll, папки Mods и UserData из директории игры, либо используйте опцию удаления в MelonLoader Installer. Проверка файлов Steam этого не сделает, поскольку ничего из этого не пришло через Steam.

Решение проблем

Терминал mod.io говорит, что я не вошёл в систему. Войдите снова через mod.io/connect, используя код, который показывает игра.

Подписанные моды не появляются. Перезапустите игру. Подписки синхронизируются при запуске, а не в реальном времени.

На Quest не хватает места. Отпишитесь от того, что не используете. Карты и аватары большие.

Консоль MelonLoader вообще не появляется. MelonLoader не загружается. Проверьте, что version.dll находится прямо рядом с BONELAB.exe, и что вы запускали игру через ваш мод-менеджер.

MelonLoader загружается, но мод не работает. Прочитайте MelonLoader\Latest.log. Отсутствующая или несовпадающая версия BoneLib — самая частая причина.

MelonLoader вылетает при запуске. Установите VC++ 2015-2019 x64 redistributable и .NET Desktop Runtime 6.0 x64.

Мод с Thunderstore ничего не делает. Убедитесь, что это действительно мод для BONELAB. Некоторые пакеты выложены сразу для BONEWORKS, а моды для BONEWORKS зависят от ModThatIsNotMod, а не от BoneLib.

После обновления всё сломалось. Патчи Stress Level Zero ломают моды на MelonLoader. Очистите папку Mods, чтобы убедиться, что игра запускается без модов, и подождите, пока авторы обновят свои моды.

Заключение

Главное, что нужно решить — какая система вам нужна. Аватары, карты и спавнящиеся предметы — это mod.io, они работают на Quest, и вы устанавливаете их, не выходя из игры. Код-моды — это MelonLoader, они только для PC, и мод-менеджер вроде Gale делает их установку делом двух кликов.

Если у вас автономный Quest, mod.io — это вся история целиком, и история хорошая.

Если у вас есть свободная минута, TMC App — это открытый исходный код на очень ранней стадии разработки, и обратная связь по нему будет очень ценна.

См. также

Мы стараемся поддерживать это руководство в актуальном состоянии, но игра, mod.io и MelonLoader меняются независимо друг от друга. Если вы заметили, что какая-то инструкция больше не соответствует тому, что вы видите, пожалуйста, сообщите об этом или откройте pull request в GitHub-репозитории этого руководства.

Присоединяйтесь к нашему Discord-серверу, если у вас есть вопросы или нужна помощь с чем-либо, связанным с моддингом!

Комментарии (0)

Войдите, чтобы комментировать.

Загрузка…

Открыть больше

Обновления поста

Загрузка…

Недавняя активность

Загрузка…
Перейти в сообщество
Play