Quest模组

前言

• 此指南适用于 Quest 1 ，Quest 2 ，Quest Pro 以及 Quest 3（s） 。

• 目前暂无因安装模组被封号的案例，但添加模组确实违反了 Meta 的服务条款。

免责声明

在使用模组之前，你应当先理解:

• 安装模组后，可能会遇到原版游戏中不会出现的问题。游戏中的 bug 、崩溃或卡顿有 99.9% 都是因安装模组而引起的。
• 模组可能会因更新而失效，这是正常现象。当这种情况发生时，请保持耐心。因为模组作者都是为爱发电的志愿者，而并非全职开发者。
• 游戏厂商 Beat Games 并非故意让模组失效。他们致力于优化游戏代码，在此过程中可能会让模组无法正常工作，他们的目的不是封杀模组。

不要因为模组有问题而去攻击游戏厂商与模组作者。请保持理性和最基本的礼貌。

我在B站看了一个视频教程，但现在卡住了/不生效，我该怎么办？

BSMG 社区强烈建议不要使用任何视频教程来安装模组。很多视频教程可能已经过时，或者包含不完整、有错误或误导他人的信息。

我们建议你使用并遵循本 Wiki 上的指南，或前往 BSMG Discord ( 英文社区 )寻求帮助。

警告

为游戏安装模组会导致你无法使用官方的联机功能，也无法浏览或上传分数至游戏的官方排行榜。

如果你有安装模组后联机的需求，请提前安装Beat Together和MultiplayerCore这两个模组

这些模组支持PC和Quest跨平台联机，并同时使用自行导入的谱面

它们并非核心模组，因此在联机前请确保这些模组兼容你当前版本的节奏光剑。

如果想要在自制谱面上获得排名，或者在 ranked 曲目中获得表现积分 ( Performance Point , PP )，
则需要安装 ScoreSaber 或者 BeatLeader 模组。

前置要求

安装模组需要通过 ADB（安卓调试桥）来访问 Quest 设备。 因此你需要一台 Windows/Mac/Linux 系统的电脑或另一部安卓设备.

请根据设备类型选择对应方案：

设备系统	操作指南
Windows 、Macos 、 Linux	使用电脑安装模组
另一部安卓设备	使用安卓设备安装模组
ios ( 需要买一块树莓派 )	使用树莓派安装模组

由于 ios 设备的浏览器不支持部分功能，所以需要购买一块树莓派。

Linux 系统的电脑也可以参考使用树莓派安装模组来安装模组，但这只在 Raspberry Pi OS ( 基于 Debian ) 上进行过测试，在其它系统上可能有区别。

( 此处仅为直译原文，以中国大陆的环境来说更建议购买一台安卓备用机。)

多账户须知

无法为同时登录多个账户的 Quest 安装模组！在添加模组前请移除全部的次要账户。

Quest 1 用户需注意

在 Quest 1 上只能给 1.28 或以下版本的节奏光剑添加模组。

前往 为 Quest 1 安装模组 阅读说明。

准备工作

开发者模式

你需要先启用 Quest 的开发者模式后才能添加模组。

如果尚未启用，请提前按照以下步骤进行操作：

1. 前往 Meta's Developer Website 并登录与你的 Quest 绑定的 Meta 账户。
2. 请提前开启开启 Meta 账户的两步验证 ( Two-Factor Authentication , 2FA ) ，这是创建组织 ( Organization ) 的必要条件。
3. 回到 Meta's Developer Website 并创建一个新的组织，再随便起个名字。
4. 打开 Quest 的手机 app ，并点开 Quest 的设备设置页面，打开里面启用开发者模式的选项。可参考下方图片指南：

SideQuest

这是一个可选步骤！

目前安装模组并不强制需要 SideQuest ，但它可以快捷管理打过模组的游戏，或管理 Quest 上的内容 — 所以装一个也不是不行。

前往 SideQuest官网 下载 SideQuest 的安装程序，然后按提示安装即可。

使用 SideQuest 备份存档数据

可选步骤

如果这是你首次安装模组，可以跳过此部分，直接前往 为节奏光剑安装模组的方案

打开SideQuest，并将Quest连接到电脑。

使用SideQuest上的文件管理器跳转到 sdcard/Android/data/com.beatgames.beatsaber/files 路径。

并把 AvatarData.dat ，PlayerData.dat ，settings.cfg 这些文件保存至电脑的某个文件夹里。

请确保不会丢失它们，这些文件里保存了你的分数和其它设置。

使用 SideQuest 恢复存档数据

可选步骤

若你在 使用 SideQuest 备份存档数据 中备份了一些数据需要恢复，则请执行这一步骤。 大多数的模组安装工具都会自动帮你恢复数据，但仍建议保留备份来以防万一。

如需恢复游戏存档，请打开SideQuest并将Quest连接至电脑。

使用SideQuest的文件管理器,将 使用 SideQuest 来备份存档数据中备份的三个文件 AvatarData.dat，PlayerData.dat和settings.cfg 拷贝至 sdcard/Android/data/com.beatgames.beatsaber/files路径。

为节奏光剑安装模组的方案

• 目前为节奏光剑安装模组，最简单的方式是使用 ModsBeforeFriday ， 这是一个运行于浏览器网页的应用，可以在几分钟内就完成模组的安装。

• 其次，若需要更高级的管理功能，也可选择 QuestPatcher ，此工具运行于Windows、Macos或者Linux系统的电脑。

  这个软件可以用来在网络不好的情况下 离线安装或者管理模组。

  注意！它无法降级节奏光剑。如果你当前游戏版本不支持安装模组的话，可能无法使用该工具。

如果你没有安装过模组，或当前版本需要降级，则请先使用 ModsBeforeFriday 完成降级操作。

BMBF 已被废弃

BMBF 已不再适用于为 Quest2 或 Quest3 上的节奏光剑安装模组！ 不要再用 BMBF 了，请使用 ModsBeforeFriday。

关于 QAVS

你可能在某些地方看到过使用QAVS进行降级操作的教程

目前，QAVS无法将节奏光剑降级至最新可安装模组的版本，也无法对其打补丁。

这是个暂时性的问题，也许未来可能恢复。

请使用 ModsBeforeFriday 来降级和安装补丁。

如果有人让你用QAVS来进行降级，请前往 Modding With QAVS。

ModsBeforeFriday

注意

在中国大陆的某些环境下，可能无法直接使用此工具。请为PC/Quest设备开启代理以访问github。

ModsBeforeFriday (MBF) 是一个运行于浏览器网页的节奏光剑模组工具。

若你正在使用电脑，请前往 使用ModsBeforeFriday添加模组。

安卓用户请参考 使用Android添加模组。

QuestPatcher

QuestPatcher 是一款运行于 Windows、Linux 或 macOS 上的模组安装程序，适用于 Quest 上任何基于 il2cpp 的 Unity 应用。

请确保你已阅读并完成 准备工作 其中的步骤后再使用此工具。

你需要提前启用开发者模式，并在电脑上安装 SideQuest 。

1. 点击这个页面 后下载并安装QuestPatcher。

   警告

   QuestPatcher 无法降级你的节奏光剑， 因此你需要确保 Quest 已经安装了支持安装模组的游戏版本。

   如果你以前用过 QuestPatcher，请先跳转到工具并点击 Quick Fix 以修复软件

2. 修补节奏光剑（若使用过此软件，请先进行修复）

   • 确保在菜单内选择了 Scotland2 作为 ModLoader。

     此处的修补是给节奏光剑添加基础模组的意思。

3. 安装核心模组，以及在 这个页面内安装其它模组。

QAVS

WARNING

由于软件更新后的限制，目前 QAVS 无法为节奏光剑添加补丁。 请使用 ModsBeforeFriday 进行替代。