# Модификация Beat Saber

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2Fgit-blob-ddbbe5fb52843169a555c29358f476da3b8aa1fd%2Fmbfthumbnail.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

Хотите играть в тысячи пользовательских треков, использовать катаны, или кардинально изменить визуальные эффекты? В этом гайде мы рассмотрим модифицирование игры как на Автономной версии, так и на ПК.

### Предисловие

* Этот гайд актуален для шлемов: Meta Quest 2, Quest Pro и Quest 3 \ 3S.
* На данный момент <mark style="color:$warning;">**никого ещё не забанили**</mark>, однако стоит помнить, что **моддинг формально нарушает Условия использования Meta Quest (ToS)**

{% hint style="danger" %}
🛑 **Отказ от ответственности** 🛑

Решая использовать моды, вы должны понимать следующее:

* **Вы можете столкнуться с проблемами**, которых нет в обычной игре без модов. 99.9% всех багов, лагов, и вылетов происходят именно из-за модов.
* **Моды ломаются после обновлений игры**, и это нормально. Будьте терпеливы и уважайте чужой труд. Моды делают волонтеры в своё свободное время.
* **Разработчики из Beat Games не ломают моды специально**, они просто обновляют кодовую базу игры. Иногда это приводит к несовместимости модов. У них нет цели "убить" моддинг.
  {% endhint %}

{% hint style="warning" %}
**Посмотрел гайд на YouTube, но ничего не работает. В чем дело?**

**Мы настоятельно не рекомендуем** использовать видео-гайды для моддинга. Очень часто они устаревшие, либо содержат неполную, ошибочную, или откровенно неверную информацию.
{% endhint %}

{% hint style="info" %}
[Кстати, у нас есть **Telegram-чат**, где можно **спросить помощи и пообщаться**](https://t.me/MetaQuestRUS)
{% endhint %}

***

## Автономная версия игры

#### Требования:

Перед началом убедитесь что у вас есть:

1. **Шлем:** Quest 2, Quest Pro или Quest 3 \ 3S
2. **Режим разработчика:** Он должен быть активирован и включен. ([Как включить режим разработчика](https://meta-quest-ru-wiki.gitbook.io/start/welcome/developer-mode))
3. **Игра:** Потребуется **лицензионная копия игры** последней версии, либо установленная версия игры **1.37.0** (:skull:)

* :skull: **Последняя 100% рабочяя пиратская версия это 1.37.0, иные на ваш страх и риск**

4. **Устройство:** Компьютер **(Windows\Mac\Linux)** с браузером **Chrome\Edge**.
5. **Кабель:** Хороший USB-кабель для передачи данных, чтобы ПК увидел шлем.

***

<details>

<summary>Установка через ModsBeforeFriday (<mark style="color:$success;">Лицензия</mark> \ <mark style="color:$warning;">Пиратка</mark>)</summary>

**Это браузерный установщик**. Он автоматически откатит до самой последней модифицируемой версии игры и установит Базовые моды. Никаких сложных программ скачивать не потребуется.

1. [Перейдите](https://mbf.bsquest.xyz/) на сайт ModsBeforeFriday (MBF)
2. Подключите шлем к ПК и нажмите "**Connect to Quest":**

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2Fgit-blob-25f18f662e5945dd1827c93b6baff9e60f106138%2Fmbf1.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

3. В открывшемся окне выберите свой шлем и нажмите "**Подключиться**":

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2Fgit-blob-48826c80b7b68c628850e982f42006424b44c15d%2Fmbf2.png?alt=media" alt="" width="461"><figcaption></figcaption></figure>

4. Наденьте шлем и разрешите **Отладку по USB** (*Если потребуется*):

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2Fgit-blob-bf75ef28c2d5da08f4c1eb81a8affc22bd0ce7d1%2Fadbdebug.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

***

<h4 align="center">Процесс проверки установленной игры:</h4>

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2Fgit-blob-09571de1edbf6a4a654f16a7bb6288a1b917efd0%2Fmbf3.png?alt=media" alt=""><figcaption></figcaption></figure>

***

5. **MBF проверит** версию вашей игры. Если она слишком новая, **MBF** предложит понизить версию игры которая будет совместима с модами. Поэтому смело нажимаем <kbd>Mod The App</kbd>, тем самым соглашаясь на патч игры:

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2Fgit-blob-5f7f70f8113234a4e6309488ae9c59c26e4d3b92%2Fmbf5.png?alt=media" alt=""><figcaption></figcaption></figure>

***

<h4 align="center">Процесс патчинга:</h4>

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2Fgit-blob-bf5ba27c3b7896cca3966ad44bd425991c85dc62%2Fmbf4.png?alt=media" alt=""><figcaption></figcaption></figure>

***

6. Если вы увидите сообщение **App is modded**, значит у вас всё получилось!

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2Fgit-blob-784a18e18027d942306b3e123ec11ca4d5bd2c80%2Fmbf6.png?alt=media" alt="" width="563"><figcaption><p>Список модов которые можно загрузить. Модификация успешно пройдена!</p></figcaption></figure>

<p align="center"><mark style="color:$success;">Процесс модификации завершён!</mark></p>

<h4 align="center">Можете запускать игру! В главном меню игры проверьте наличие вкладки <code>Mods</code>. Если вкладка <code>Mods</code> на месте, бегом качать пользовательские песни! Загрузить их можно нажав на <code>Songdownloader</code>:</h4>

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2Fgit-blob-449273bee0ed4591f1aed0c365860d8926bf8636%2Fbsmods.jpg?alt=media" alt="" width="563"><figcaption></figcaption></figure>

</details>

<details>

<summary>Памятки после модификации игры</summary>

<h4 align="center">Пользовательские песни находятся во вкладке <strong>Custom Levels:</strong></h4>

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2Fgit-blob-77f534f59a29ba24e6d15e9ddaac2092773cdd11%2Fplaycustom.jpg?alt=media" alt="" width="375"><figcaption></figcaption></figure>

***

<h4 align="center">Дополнительные моды в один клик можно установить прямо с ModsBeforeFriday в браузере, подключив шлем к ПК:</h4>

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2Fgit-blob-07f8ad3192c803f268d3f2328859126943cb423c%2Fmbfmods.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

***

<h4 align="center">Для улучшенного поиска пользовательских песен, рекомендуем <mark style="color:$success;">BetterSongSearch</mark>. Многофункциональный поиск песен!</h4>

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2FGhfhAFL1L7TQCN9OQOAx%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%20(924).png?alt=media&#x26;token=2722bbde-3964-42f1-9912-1f7b3ce8c065" alt=""><figcaption></figcaption></figure>

</details>

***

## ПК Версия игры

#### Требования:

Перед началом убедитесь что у вас есть:

1. Шлем
2. **Компьютер**
3. **Игра:** Потребуется лицензионная копия игры, либо пиратская (:skull:)

* (:skull:) **Пиратская версия** игры должна быть **той версии**, которую хотите модифицировать. Загрузите необходимую версию игры заранее. (:skull:)
* Рекомендуемая версия игры для модификации является <mark style="color:$success;">1.29.1</mark>

{% hint style="info" %}
**Steam Версия:**

**Необходимую версию игры можно переключить в библиотеке, нажав на ПКМ мыши по игре, затем выбрать "Свойства" -> Вкладка "Версии игры и бета-версии".**
{% endhint %}

<details>

<summary>Установка через BSmanager (<mark style="color:$success;">Лицензия</mark>) | <mark style="color:purple;">Рекомендуемый способ</mark></summary>

Достаточно функциональный лаунчер для Beat Saber, который позволяет держать несколько версий игры одновременно (*например одну версию для игры без модов, другую - старую с модами*)

1. [Перейдите](https://github.com/Zagrios/bs-manager/releases) на страницу GitHub и загрузите [**BSmanager**](#user-content-fn-1)[^1]**:**

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2FyfezMkIT9NZ3IvruKelR%2Fbsmanager1arrow.png?alt=media&#x26;token=26339f0d-bbff-4a6a-bd3e-b0b345ad4be8" alt="" width="563"><figcaption></figcaption></figure>

2. **Запускаем** **BSmanager.exe** и ждём установку:

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2FE17dZrSN7iGw7TjT0QA9%2Fbsmanager2crop.png?alt=media&#x26;token=a61682b8-f721-4af6-9e7c-03c63e514de4" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2Fp7e6ebCVocRuUoy3m9ag%2Fbsmanager3crop.png?alt=media&#x26;token=f68c92fb-be19-4477-8791-924c6f3c5a41" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="success" %}
**Выберите желаемую папку и нажмите "Подтвердить".**
{% endhint %}

4. **В верхней части** окна выберите год (***например, 2024***), а ниже найдите нужную вам версию. Для стабильной работы большинства модов часто рекомендуются версии вроде **1.29.1** или **1.34.2**

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2Fc9u5liW4v1KBq6EsX8az%2Fbsmanager4_1_crop.png?alt=media&#x26;token=52a05bba-4452-487b-ab49-b0056b67abec" alt="" width="563"><figcaption></figcaption></figure>

***

<h4 align="center"><mark style="color:$warning;">Ознакомьтесь с предупреждением</mark>, что на старых версиях некоторые моды могут не работать, и нажмите "Продолжить".</h4>

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2Fl0lP7yrh5dvhY9VmJOia%2Fbsmanager5_crop.png?alt=media&#x26;token=4e45f87d-2f44-43d5-9a57-28af58e0713f" alt="" width="563"><figcaption></figcaption></figure>

***

5. **Выберите платформу** гду у вас **куплена** игра.

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2FEpRh2Yr89ccZG6e18XGf%2Fbsmanager6_crop.png?alt=media&#x26;token=f508d915-293e-46dc-8d18-3c3ffd11dea9" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="success" %}
**BSManager работает как надстройка над официальными магазинами, поэтому вам нужно подтвердить владение игрой**
{% endhint %}

6. **В зависимости** от выбранной платформы, **войдите** в свой аккаунт

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2F6AFwMGKLhN2z07LF1Yu6%2Fbsmanager7_crop.png?alt=media&#x26;token=c71abbdd-394a-4ff8-be80-13eaf1998e40" alt=""><figcaption></figcaption></figure>

7. После успешного входа, <mark style="color:$success;">игра начнёт автоматически загружаться</mark>!

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2FLormmDSHeIwQk4hfZE0h%2Fbsmanager8_crop.png?alt=media&#x26;token=13c7f757-80a1-4e7a-ae34-444b6c067e89" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
**Терпим и ожидаем окончания загрузки**
{% endhint %}

8. После успешной загрузки, выбираем нашу версию в левой вкладке и попадаем в лаунчер запуска игры. Переходим во вкладку Моды

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2FC4PKfKpk3QIMlG0ztxaW%2FbsmanagerGAME_crop.png?alt=media&#x26;token=82c32503-457e-4f02-8eab-781da81d343e" alt="" width="563"><figcaption></figcaption></figure>

***

<h4 align="center"><mark style="color:$warning;">Внимательно читаем и соглашаемся с предупреждением.</mark></h4>

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2F8x3eiIjT084t20FJ1F6y%2FbsmanagerWARNING_crop.png?alt=media&#x26;token=18a482a6-fd25-495b-b984-fb5a0bf9f8f8" alt="" width="563"><figcaption></figcaption></figure>

***

9. Перед нами появляется окно со списком различных модов. Самые необходимые моды уже по умолчанию выбраны, поэтому можем смело нажимать "Установить или обновить"

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2FOrFuX97qi8qccS0yyBsH%2FbsmanagerMODS_crop.png?alt=media&#x26;token=ed13b21f-89c7-4668-a9f0-fc1a609198ec" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="success" %}
Совет: Рекомендуем так же установить мод <mark style="color:blue;">BetterSongSearch</mark>. Поиск пользовательских песен в нём куда лучше реализован, нежели во встроенном SongDownloader&#x20;
{% endhint %}

***

<h4 align="center">Ждём загрузки модов.</h4>

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2FLormmDSHeIwQk4hfZE0h%2Fbsmanager8_crop.png?alt=media&#x26;token=13c7f757-80a1-4e7a-ae34-444b6c067e89" alt=""><figcaption></figcaption></figure>

***

<h4 align="center">После окончания установки, переходим во вкладку "Запустить" иии..<mark style="color:$success;">Запускаем игру!</mark></h4>

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2FC4PKfKpk3QIMlG0ztxaW%2FbsmanagerGAME_crop.png?alt=media&#x26;token=82c32503-457e-4f02-8eab-781da81d343e" alt=""><figcaption></figcaption></figure>

***

10. **Мы в игре**. Поверните голову в левую сторону и вы должны будете увидеть вкладку Mods. Значит моды установились, замечательно!

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2FGE7lcTYfCfly1FXKTOco%2FbsmanagerMODS_v2.png?alt=media&#x26;token=1f0a843f-aff7-4f22-8188-b79e9a55bcdc" alt=""><figcaption></figcaption></figure>

<h4 align="center"><mark style="color:$success;">Модификация игры успешно выполнена!</mark></h4>

</details>

<details>

<summary>Установка через ModAssistant (<mark style="color:$success;">Лицензия</mark> \ <mark style="color:$warning;">Пиратка</mark>)</summary>

{% hint style="info" %} <mark style="color:$warning;">Внимание пиратам:</mark>&#x20;

У ModAssistant встроена защита от пиратства, вам необходимо использовать специальный патч, который убирает проверку на лицензию.

[Пиратам Сюда](https://github.com/Slied1961/ModAssistantPatched/releases) *(**GitHub**)*
{% endhint %}

{% hint style="danger" %}
Внимание!

**Запустите игру хотя бы один раз, прежде чем пытаться её модифицировать.** Это касается и переустановки игры!
{% endhint %}

1. [Переходим](https://github.com/bsmg/ModAssistant/releases/tag/v1.1.35) на страницу Github и загружаем <kbd>ModAssistant.exe</kbd>

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2F2CCJ7pjwjaEwQnKDsv8C%2FmodassistantGithub_crop.png?alt=media&#x26;token=e8a46cc9-a47f-4772-8271-df6f2115f7ed" alt="" width="563"><figcaption></figcaption></figure>

2. Запустите ModAssistant
3. **После запуска**, появится окно с предупреждением. Внимательно читаем и нажимаем "**Я согласен**"

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2Fi0BNa5vmlZd3cM51Mfts%2FmodassistantAgree_crop.png?alt=media&#x26;token=8bcbc6a4-b575-461e-ac94-8b33ab94d38a" alt="" width="563"><figcaption></figcaption></figure>

4. Открываем вкладку Модификации

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2FiQYuhYhEn603kFRfbH2y%2FmodassistantMods_crop.png?alt=media&#x26;token=51318eb6-1644-4e6f-b788-ad4a51f31572" alt="" width="269"><figcaption></figcaption></figure>

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

<h4 align="center">Нажимаем "<mark style="color:$success;"><strong>Установить или обновить</strong></mark>" и ждём окончания загрузки.</h4>

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2Fo0zkmPRXKA79HNfWG4rP%2FmodassistantModinstall_crop.png?alt=media&#x26;token=85ec92cc-8e6b-4ec8-b5d8-84057dab617d" alt=""><figcaption></figcaption></figure>

***

6. Запускаем игру

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2F3C7Vq6F8KW8xaP0Wbx11%2FmodassistantLAUNCH.png?alt=media&#x26;token=1a8b45c9-ab79-4e46-b3be-b742fd86376b" alt=""><figcaption></figcaption></figure>

***

<p align="center"><mark style="color:$success;"><strong>Процесс модификации завершён!</strong></mark></p>

<h4 align="center">В главном меню игры проверьте наличие вкладки <code>Mods</code>. Если всё месте, бегом качать пользовательские песни!</h4>

<figure><img src="https://2519126751-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FlAghHQAzTV4lAeuAbHIX%2Fuploads%2FRC5xyzVgCdz5a3sTI9Wc%2FBeatSaberMODS.png?alt=media&#x26;token=4230c14d-1554-4abc-a67c-235c4aed1155" alt=""><figcaption></figcaption></figure>

</details>

[^1]: BSManager-Setup-1.5.4.exe