> 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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://meta-quest-ru-wiki.gitbook.io/start/mods/beatsabermods.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.