> 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/mods/beatsabermods.md).

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

<figure><img src="/files/GV6KW7VBcnqEWhItREEv" 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. **Режим разработчика:** Он должен быть активирован и включен. ([Как включить режим разработчика](/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="/files/0VaQ8heHoUrNFtPfGUFd" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/5HItuUeFlH4hKtdc5tR1" alt="" width="461"><figcaption></figcaption></figure>

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

<figure><img src="/files/lA7RT3MY6B96kNJhwwxN" alt="" width="563"><figcaption></figcaption></figure>

***

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

<figure><img src="/files/yhGiBYKUrBh5aFcRcj0F" alt=""><figcaption></figcaption></figure>

***

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

<figure><img src="/files/6uEakBikcPkZQEHerNNp" alt=""><figcaption></figcaption></figure>

***

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

<figure><img src="/files/lxGR8fBOqWrQzZ1wneqw" alt=""><figcaption></figcaption></figure>

***

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

<figure><img src="/files/T0zEeiZv6zPYe2SyrKKS" 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="/files/0z66qZB8ZxGsKHLkCH1i" alt="" width="563"><figcaption></figcaption></figure>

</details>

<details>

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

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

<figure><img src="/files/DSyins4oK7HcTSCJdKb4" alt="" width="375"><figcaption></figcaption></figure>

***

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

<figure><img src="/files/cXKW7sODWz3iEwQQ3UiA" alt="" width="563"><figcaption></figcaption></figure>

***

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

<figure><img src="/files/qyrdGXjsjCwajernYPF0" 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="/files/BCFE7uaMyeIJkcFhMhbU" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/E2m8J4dY2hkq4MljdZV4" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/klHUhzcdtkLSMyn2dCg4" alt="" width="563"><figcaption></figcaption></figure>

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

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

<figure><img src="/files/lQFB8mVhdyTZyQc8gg4q" alt="" width="563"><figcaption></figcaption></figure>

***

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

<figure><img src="/files/7Lj1IPhA42TQTFYwKu6I" alt="" width="563"><figcaption></figcaption></figure>

***

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

<figure><img src="/files/ZJWWIOASIH6cSsAdU0Ka" alt="" width="563"><figcaption></figcaption></figure>

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

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

<figure><img src="/files/t1OIGXogUM8u8tvXH10W" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/BQnzBTq9vKs0cV7zELBB" alt=""><figcaption></figcaption></figure>

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

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

<figure><img src="/files/vTscvtxmWfjO9TZCHCPL" alt="" width="563"><figcaption></figcaption></figure>

***

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

<figure><img src="/files/sMEEZ9gaCbVCFyKE4XvQ" alt="" width="563"><figcaption></figcaption></figure>

***

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

<figure><img src="/files/xOQgVfXFyUSeTtAQEX4B" 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="/files/BQnzBTq9vKs0cV7zELBB" alt=""><figcaption></figcaption></figure>

***

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

<figure><img src="/files/vTscvtxmWfjO9TZCHCPL" alt=""><figcaption></figcaption></figure>

***

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

<figure><img src="/files/NowRP5Ic9ZubA0Vwjt5n" 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="/files/IhCJDELCuRkxJsYXUlvA" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/12vMBlbDjxHapvNgOQij" alt="" width="563"><figcaption></figcaption></figure>

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

<figure><img src="/files/gE3UtGIsE4tKPc7D22cC" alt="" width="269"><figcaption></figcaption></figure>

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

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

<figure><img src="/files/TIHsZhwtGyHAX0iJTaRg" alt=""><figcaption></figcaption></figure>

***

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

<figure><img src="/files/gUkK3oSYL5c2CLF7Ruwg" 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="/files/D5jhntxSxp8DFSADOSrz" alt=""><figcaption></figcaption></figure>

</details>

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