> For the complete documentation index, see [llms.txt](https://meta-quest-ru-wiki.gitbook.io/start/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://meta-quest-ru-wiki.gitbook.io/start/vr-games/mods/beatsabermods.md).

# Модификация 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.md))
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%2Fgit-blob-941b6f61b326e6a3576d32dbb90a9938311c26df%2FBettersongsearch.png?alt=media" 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%2Fgit-blob-839ce6429970a82b4af6577aeb0b5f56aabcf9ed%2Fbsmanager1arrow.png?alt=media" 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%2Fgit-blob-2eef6ee0860076fddc274d004780b9980f0e4f11%2Fbsmanager2crop.png?alt=media" 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%2Fgit-blob-2aeacfd0f43e78e6a8405714a30538880bb6ef66%2Fbsmanager3crop.png?alt=media" 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%2Fgit-blob-a34caf722d4c6f9cd0f03213717f8604dd27092e%2Fbsmanager4_1_crop.png?alt=media" 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%2Fgit-blob-16fb4105ecb1391c66bc2f43ac23898db9b585a8%2Fbsmanager5_crop.png?alt=media" 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%2Fgit-blob-d48a8fac72adeebc85c228e2393d34215797f0d9%2Fbsmanager6_crop.png?alt=media" 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%2Fgit-blob-57f4a71a0482b19b357722da4d721d23b4d91ef9%2Fbsmanager7_crop.png?alt=media" 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%2Fgit-blob-66decec5fbf9806144e2eced5d525e2fbaf93f02%2Fbsmanager8_crop.png?alt=media" 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%2Fgit-blob-0896451f64cdb91758d2ebb856cc70a105a79b64%2FbsmanagerGAME_crop.png?alt=media" 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%2Fgit-blob-3d72a8bd902a1da803773af8d3de7f69649b10bf%2FbsmanagerWARNING_crop.png?alt=media" 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%2Fgit-blob-23a4f85edc2abe6fd5a32d9f41b58071010d4bf2%2FbsmanagerMODS_crop.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="success" %}
Совет: Рекомендуем так же установить мод <mark style="color:blue;">BetterSongSearch</mark>. Поиск пользовательских песен в нём куда лучше реализован, нежели во встроенном SongDownloader
{% 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%2Fgit-blob-66decec5fbf9806144e2eced5d525e2fbaf93f02%2Fbsmanager8_crop.png?alt=media" 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%2Fgit-blob-0896451f64cdb91758d2ebb856cc70a105a79b64%2FbsmanagerGAME_crop.png?alt=media" 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%2Fgit-blob-5fcf49af0b0740b3e18771e9ce375281099eaa7b%2FbsmanagerMODS_v2.png?alt=media" 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>

У 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%2Fgit-blob-7f724a4ca2d08e52b67db4d672dbc420ffe41c7f%2FmodassistantGithub_crop.png?alt=media" 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%2Fgit-blob-661b7aa371020ef47bc1027d183f70017bd34e08%2FmodassistantAgree_crop.png?alt=media" 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%2Fgit-blob-0896010dc64e033ad34b8f14e1b5f6a3e68c4d8b%2FmodassistantMods_crop.png?alt=media" 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%2Fgit-blob-f7bfcad0274aca82fa7962930cddc21df13de34d%2FmodassistantModinstall_crop.png?alt=media" 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%2Fgit-blob-1184368ee02ef8770dacc97c257d6b40d3ba9bbe%2FmodassistantLAUNCH.png?alt=media" 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%2Fgit-blob-38ff5598a8e4327b792c93d37f2742fd953ec71b%2FBeatSaberMODS.png?alt=media" alt=""><figcaption></figcaption></figure>

</details>

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