Skip to content

Add Quest 1 instructions for 1.40.8 #673

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
FrozenAlex wants to merge 1 commit into
base: master
Choose a base branch
from
+32 −11
Open

Add Quest 1 instructions for 1.40.8 #673

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 9 additions & 2 deletions wiki/quest-modding.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,9 +64,9 @@ You will need to temporarily remove any secondary accounts before modding.
:::

::: danger Quest 1 Users
Modding on Quest 1 is only possible on version 1.28 or below of Beat Saber.
Quest 1 can be upgraded to **Beat Saber v1.40.8** and modded, but **only** using
**ModsBeforeFriday (MBF)** because it requires a special compatibility patch.

Visit the [Modding Quest 1 page](./quest/modding-quest1.md) for modding instructions.
:::

## Preparations
Expand Down Expand Up @@ -166,6 +166,13 @@ Android users should visit [Modding with Android](./quest/modding-with-android.m

QuestPatcher is a GUI based mod installer for any il2cpp unity app on the Oculus Quest that runs on Windows, Linux, or macOS.

:::warning Quest 1 Users
Quest 1 can be upgraded to **Beat Saber v1.40.8** and modded, but **only**
using **ModsBeforeFriday (MBF)** because it requires a special compatibility patch.

Use: [Modding with ModsBeforeFriday](./quest/modding-with-mbf.md)
:::

If you have not already, go to [Preparations](./quest-modding.md#preparations) and follow those steps.
You should now have Developer Mode enabled and SideQuest Advanced installed on your PC.

Expand Down
11 changes: 5 additions & 6 deletions wiki/quest/modding-quest1.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,12 +10,11 @@ description: Learn how to mod Beat Saber on your Quest 1!

**This guide is for Quest 1 only!** Head back to the [Quest Modding](../quest-modding.md) page for other headsets!

:::danger Quest 1 is No Longer Supported!
The last vanilla game version that supports Quest 1 was `1.36.2`. Additionally since the unity engine update, the Quest 1
uses its own, unique build of the game, different from what modding tools are targeting. This means the latest and last version
of the game you can mod your Quest 1 to is `1.28.0`.
:::danger Legacy guide (QAVS)
This guide is **legacy/outdated** and only covers modding Quest 1 to **Beat Saber `1.28.0`** using QAVS.

This guide walks you through how to mod the game to `1.28.0` on your Quest 1.
For most users, Quest 1 can be upgraded to **`1.40.8`** and modded using **ModsBeforeFriday** instead:
[Modding with ModsBeforeFriday](./modding-with-mbf.md)
:::

If you have not already, go to [Preparations](../quest-modding.md#preparations) and follow those steps.
Expand All @@ -25,7 +24,7 @@ This prevents it from going into sleep mode during the modding process. Alternat
up the sensor between the lenses.

:::warning
Make sure you do not have multiple accounts an your Quest!
Make sure you do not have multiple accounts on your Quest!

Modding currently does not work with multiple accounts.
You will need to temporarily remove all secondary accounts before modding the game.
Expand Down
21 changes: 18 additions & 3 deletions wiki/quest/modding-with-mbf.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,9 +6,7 @@ description: Learn how to mod Beat Saber on your Quest using ModsBeforeFriday!

# Quest Modding using ModsBeforeFriday

This guide is for Quest 2, 3, and Pro headsets only!

Quest 1 Users should follow the [Quest 1 modding](./modding-quest1.md) guide.
This guide is for Quest 1, 2, 3, 3S and Pro headsets only!

:::warning
Installing MBF and modding your game will disable Official Multiplayer as well as viewing and uploading scores on the
Expand All @@ -34,6 +32,23 @@ To begin, make sure that you have the latest version of (vanilla) Beat Saber on

MBF will automatically downgrade this version to the latest moddable version.

:::danger Quest 1
Copy link
Copy Markdown
Member

@bloodcloak bloodcloak Apr 28, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This danger section does not seem clear.

Is this noting that if people with a Q1 and modded the last official version needs to leave the legacy release channel before using MBF?

Copy link
Copy Markdown
Contributor Author

@FrozenAlex FrozenAlex Apr 28, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yeah, they need to leave the legacy channel before modding because MBF requires the latest (1.37.101) for quest 1 to be on the quest. It's also how it knows when to upgrade.


Quest 1 requires a different flow: **ModsBeforeFriday (MBF)** can update/patch
Quest 1 up to **Beat Saber `1.40.8`** (last officially supported Quest 1 version is `1.37.101`).

If you previously modded (or switched release channels) and
your version doesn’t match what MBF expects, make sure you are **not on the legacy release channel**.

**How to leave the legacy release channel:**

1. Go to [Beat Saber store page](https://www.meta.com/experiences/beat-saber/2448060205267927/)
2. Log in with the account used on your headset.
3. Scroll down to **Version + release notes** (you can use Ctrl+F on the page to find it)
4. Open the version dropdown and select **LIVE**.
5. Reinstall Beat Saber on your headset, then return to this guide.
:::

:::warning Browser Support

MBF needs an up-to-date Chromium browser to work. For example:
Expand Down