由于中国连接其他国家的国际带宽不够，经常发生拥塞，所以有时候会因为网络不好导致下不动。
在Mod安装完毕，但游戏中找不到Mod时，才可按本篇教程操作。
如果你的ModAssistant压根就不给装Mod，请看“为什么加载下载Mod缓慢甚至报错？”
如果你在2022年3月以前安装的Mod能生效，只有在这之后才无法生效 (1.20以上)，请先查看上一条解答。
安装Mod之前需要确保以下几项：
1. 确保游戏安装路径中不存在任何中文或特殊字符，否则将导致绝对装不上Mod（不是盘符 ，你需要确保ModAssistant的“选项”界面中显示的游戏安装路径的整个框中不得存在任何中文字符）；
2. 确保ModAssistant左下角选择的游戏版本，以及设置的游戏目录与你的游戏相同；
3. 安装Mod前至少要启动过一次安装/更新后的游戏，退出后才能安装Mod，显示安装完成再启动游戏；
4. ModAssistant如果是增强版则推荐使用默认的国际源。
如果Mod就是不生效，请尝试以下解决方法：
1. 进入游戏安装目录，右键以管理员身份运行IPA(.exe)。
如果Mod仍然没有生效，请尝试以下解决方法：
1. 按照本网页中的“如何彻底重装游戏并恢复数据？”的步骤来足够彻底地重装一次游戏。
卸载重装很可能解决不了问题，因为不够彻底，请按教程给出的重装步骤来才做，这样才能保证解决问题。
不要惧怕重装，教程给出的是最快、最彻底的备份重装并恢复所有数据的方案，不会损失任何数据。
如果仍然遇到问题装不上Mod，请在上方导航栏中找到群号，加群提问。
只有在Mod安装完成之后出现问题，或者是游戏自身的问题，才能按照这篇教程操作。
如果你的ModAssistant报错，或者是网页报错，重装游戏是解决不了的！
如果你安装了第三方杀软，建议在重装前将其更换为系统自带杀软（Windows Defender），
以下是最快且最彻底的重装游戏并恢复全部数据方案：
1. 退出正在运行的ModAssistant（如未打开请忽略）；
2. 找到游戏目录，进入安装路径的上一级文件夹，将游戏安装文件夹的名字改掉，随便改，有变化就行；
3. 在Steam中找到Beat Saber，右键、属性、本地文件、验证游戏完整性，此时将会重新下载安装；
4. 等待安装完成后，先运行一次游戏然后再退出游戏；
5. 打开ModAssistant安装Mod；
6. 启动游戏看看，如果仍然有问题，试试在ModAssistant的选项界面中找到游戏存档，备份后删除；
7. 如果一切正常，退出游戏，接下来开始恢复数据：
8. 从原来更名文件夹中删除该文件："Beat Saber\UserData\Beat Saber IPA.json"；
9. 将以下目录从原来更名文件夹中移动到现在的游戏目录
Beat Saber \ Beat Saber_Data \ CustomLevels (自定义歌曲)
Beat Saber \ CustomAvatars (人物模型)
Beat Saber \ CustomNotes (方块模型)
Beat Saber \ CustomPlatforms (场景模型)
Beat Saber \ CustomSabers (光剑模型)
Beat Saber \ UserData (Mod设置)
（注：移动比复制快很多；千万不要将Beat Saber_Data整个移动回去，只能移动它里面的CustomLevels）
【新降级方案】（限1.29.1版本，暂时有效）
降级教程：
0. 关闭ModAssistant
1. 在Steam中找到Beat Saber
2. 右键 → 属性 → 测试版
3. 将「参与测试」右侧的「无」切换至「legacy1.29.1_unity_ver2019.4.28f1 - pre unity upgrade b……
4. 等待下载完成，即可完成降级
注：请不要填写测试代码，也不要点击「检查代码」。
理论来说，你无需再按传统方案的繁琐步骤来恢复数据，
如果以前给1.29.1打过Mod，切换测试分支后应该会恢复。
如果你没打过Mod，降级完成后即可按教程来安装Mod。
这不是测试版，只是利用该功能提供了引擎更新前的正式版
【传统降级方案】
下载方法：
1. 点我进入网盘
2. 选择任意一个网盘，点击【进入下载】
3. 进入【游戏备份与懒人包】文件夹
4. 找到1.29.1的原版备份
5. 对着找到的文件右键，点击下载
降级教程：
0. 确保已经通过Steam更新了游戏
1. 对着下载的原版备份右键
2. 点击解压至单独文件夹
3. 通过Steam打开游戏目录
4. 点击游戏目录的上一级目录
5. 更改游戏目录文件夹名称，随便改
6. 将原版备份解压出的文件夹移动过来
7. 将原版备份文件夹名称重命名为Beat Saber
恢复数据教程：
1. 打开降级教程第⑤步改名的游戏目录
2. 删除UserData文件夹内的Beat Saber IPA
3. 复制以下文件夹
UserData（Mod设置）
CustomSabers（光剑模型）
CustomPlatforms（场景模型）
CustomAvatars（人物模型）
CustomNotes（方块模型）
4. 进入新的游戏目录
5. 粘贴复制的那些文件夹
6. 在弹出的提示中，选择【替换】
7. 打开降级教程第⑤步改名的游戏目录
8. 进入Beat Saber_Data文件夹
9. 剪切CustomLevels文件夹
10. 进入新的游戏目录
11. 进入Beat Saber_Data文件夹
12. 粘贴剪切的那个文件夹
13. 在弹出的提示中，选择【替换】
降级后安装Mod教程：
0. 确保降级后至少打开过一次游戏
1. 退出游戏与降级以前打开的ModAssistant
2. 按正常流程打开ModAssistant就可以安装Mod了
（其实这一套步骤做下来，就是把游戏文件整个更换为旧版备份，不包含任何残留的Mod或游戏文件，只恢复以前的设置与资源文件）
以前23年6月出过该问题，经Pico工程师排查是串流与Mod抢占GPU资源造成，早已推送更新进行了修复。
但是，后来又逐渐有用户反馈出现类似的问题，最近10月份出现该问题的Pico用户也是越来越多。
SteamVR崩溃后，需点击“管理加载项”、取消屏蔽所有加载项后，才能恢复使用串流。
2023/10/16更新：有Pico用户报告称按此步骤操作可以解决该问题
1. 启动并连接Pico串流，让Pico串流助手启动SteamVR
2. Pico串流助手中点击左上角的“返回”，让其断开连接，但不要退出SteamVR
3. 启动Beat Saber，等待游戏载入完成
4. Pico串流助手重新连接串流，即可正常进入游戏
2023/10/16更新：另一位Pico用户报告了一份不同的解决方法
1. 启动并连接Pico串流，让Pico串流助手启动SteamVR
2. 点按头显电源键，让其进入息屏状态，并确认SteamVR中头显图标处于灰色待机状态
3. 启动Beat Saber，等待游戏载入完成
4. 点按头显电源键、点亮并戴上头显，即可正常进入游戏
2023/10/01更新：有用户报告清除Pico串流助手的应用数据后暂时解决了该问题。
如果没有解决，可以试试按“如何彻底重装游戏并恢复数据？”的步骤来彻底重装游戏。
如果仍然没有解决该问题，你可以试试切换游戏版本，将【最新版 / 1.29.1】这两个版本各试一遍，
如需降级至1.29.1，你可以点我打开降级教程，或者也可以点我打开降级教程。
如果仍然没有解决该问题，也可以咨询VR设备厂商客服，
或者暂时不要安装Mod，目前看来很可能是Pico串流与Mod之间产生的冲突造成的问题。
注：如果你遇到的不是断连或卡死，而是在降级后Pico手柄扳机键不能点，请点我打开手柄问题解决方法
首先需要注意，Mod需要匹配游戏版本，如果你安装了版本不匹配的Mod，请卸载掉对应不匹配的Mod。
如果你的游戏是最新版，请先尝试降级至1.29.1，你可以点我打开降级教程，或者也可以点我打开降级教程。
如果你装了SmartSongSuggest这个Mod，打开游戏就黑屏未响应，试试将其卸掉。
请确保不要直接在文件夹中双击exe启动游戏，请通过Steam或Steam创建的快捷方式来启动游戏。
如果仍然没有解决这个问题，请按“如何彻底重装游戏并恢复数据？”来彻底重装游戏。
（注意：卸载重装可能解决不了，按教程给出步骤重装才足够彻底，请务必将游戏安装至纯英文路径）
如果你的游戏目录中自动出现了“游侠热门单机游戏”的快捷方式，可能是系统中毒导致的，被病毒修改过的文件与Mod不兼容从而无法启动，如果遇到该情况建议重装系统，不要运行以前的任何exe可执行文件。
注：本条解答无法解决因VR端软件问题或者SteamVR问题而导致的黑屏现象。
首先需要注意，Mod需要匹配游戏版本，如果你安装了版本不匹配的Mod，请卸载掉对应不匹配的Mod。
如果你的游戏是最新版，可以试试降级至1.29.1，你可以点我打开降级教程，或者也可以点我打开降级教程。
请首先检查BeatSaber安装路径，如果安装路径中存在中文，请更换到英文路径重新安装BeatSaber。
如果你装了SmartSongSuggest这个Mod，打开游戏就黑屏未响应，请先将其卸掉试试。
请确保不要直接在文件夹中双击exe启动游戏，请通过Steam或Steam创建的快捷方式来启动游戏。
如果重新以正常方式启动游戏后仍然报错，请按“如何彻底重装游戏并恢复数据？”来彻底重装游戏。
（注意：请务必将游戏安装至纯英文路径，首次安装时最少化Mod数量，只装默认勾选试试能不能用）
如果你的游戏目录中自动出现了“游侠热门单机游戏”的快捷方式，可能是系统中毒导致的，被病毒修改过的文件与Mod不兼容从而无法启动，如果遇到该情况建议重装系统，不要运行以前的任何exe可执行文件。
注：本条解答无法解决因VR断开连接或拔掉VR而造成的游戏画面静止(不跟着头动)。
请尝试按照下方“如何彻底重装游戏并恢复数据？”的步骤重装BS来解决。
请按教程提供的方案来重装，卸载重装删的不干净。
请尝试在按教程方案彻底重装以后再重新安装Mod，目前遇到的案例我觉得有可能是游戏目录存在版本不匹配的Mod导致的。
如果无法解决，请在上方导航栏中找到群号，加群提问。
如果你还在用win7系统，请先升级到win10，目前我见过的所有win7用户，100%都不兼容mod，不用折腾游戏了，先升级系统吧，下面都专门有过win7装mod黑屏的解答，你却还找到这里，说明没仔细看。
1. 使用ModAssistant卸载BSIPA（ModAssistant的“选项”界面中有这个按钮）
2. Steam验证游戏文件
3. 使用ModAssistant安装Mod
4. 启动游戏，然后退出游戏
5. 再次使用ModAssistant安装Mod
1. 使用ModAssistant卸载BSIPA（ModAssistant的“选项”界面中有这个按钮）
2. Steam验证游戏文件
3. 使用ModAssistant安装Mod
4. 启动游戏，然后退出游戏
5. 再次使用ModAssistant安装Mod
如果你的游戏仍然装不上Mod，请按“为什么我装的Mod不生效？”的方法来解决。
说明Mod还没有更新到正式版。（不是说正版不支持，[正式版/测试版]与[正版/盗版]不是一个意思）
着急用的话可以先手动安装测试版Mod，常用mod一般会有人维护更新的，可以在【BS新手教程】中找到手动安装Mod教程。
一些Mod更新没那么快，游戏更新也经常会出现新Mod，可以每隔一段时间打开安装器看看。
启动过一次新版游戏后，退出游戏使用ModAssistant重新安装Mod即可。
注：游戏刚刚更新的几小时内可能识别不到最新的游戏版本，此时建议等待一会再安装Mod。
我们反对禁用更新。现在Mod开发者都在紧随游戏最新版，
虽然在游戏刚刚更新的几小时内，有可能没有Mod，但通常在一天内Mod就都会更新。
更何况，现在更新的很多游戏版本，Mod直接完全兼容，都不用等直接就有，重装Mod就行。
如果部分Mod暂未更新正式版，可以按【BS新手教程】中的手动安装Mod教程来安装。
以下每行的游戏版本，Mod互相兼容，不同行之间不兼容。"游戏版本": ["Mod与上一版兼容的游戏版本"]
（手机需点击此处加载）
该问题是由于系统版本过低导致的。
Win7现在已经和XP是一个地位了，请升级到Windows10。
如果你使用ModAssistant安装Mod之前，切换过ModAssistant的游戏版本，
那说明是由于你安装了版本不匹配的Mod，把游戏搞坏了导致无法运行。
安装版本匹配的Mod一般不会有问题，版本不匹配的Mod才会导致游戏运行不正常。
请按照上方“如何彻底重装游戏并恢复数据？”的方案，彻底重装游戏。
如果你遇到的不是这个情况，请加群提问，可在顶部导航栏中找到群号。
安装Mod后运行一次游戏，才算完整安装，Mod相关文件才会出现在他该出现的位置。
在这之前，Mod相关文件会保存在Beat Saber\IPA\Pending
另外，新版Mod已不再附带远古格式歌曲转换工具songe-converter，如有需要可进入BS游戏资源网盘中的工具目录下载。
目前我见到的该问题都是由于安装Mod的过程遭到拦截导致的。
我一般推荐使用系统自带杀软（Windows Defender），一般不会有这种问题，查杀率也很高，
而部分第三方杀软经常无提示误拦截，所以可能会出现这种情况。
如果更换杀软不能解决问题，可以尝试在右上角加群提问。
如果你在使用包子源（左下角Mod下载源），请切换为国际源，包子源有时会出问题。
如果游戏刚刚发布更新、过去还不到12小时，那就是Mod还不支持这个版本，稍微等等再重新打开ModAssistant。
如果你的情况到现在还没有解决，请在网页右上角加群反馈。
说明软件正在运行自动更新，旧版将被更名为.old备份，正在下载新版。
如果迟迟没有出现软件界面，很可能是由于网络问题导致更新下载失败，
可重新下载最新版ModAssistant。
大概率是自动更新失败导致的，请先尝试重新下载最新版ModAssistant。
如果重新下载解决不了，请尝试将软件移动到不同文件路径（挪到不同的文件夹中），然后重新打开。
（如果你是Windows10系统，请前往这里查看版本：设置 → 系统 → 关于 → Windows规格 → 版本号）
ModAssistant需要.NET Framework 4.7.2，缺失会导致无法联网，
Windows 10 1803及以上版本的系统已自带.NET Framework 4.7.2或更高版本，
Windows 7、8.1、10 (1607/1703/1709)可手动安装.NET Framework 4.7.2。
请将你的系统更新功能恢复为启用状态，它会自动更新到最新版Windows 10，这将会解决该问题。
如果更新失败，可尝试升级工具：https://www.microsoft.com/zh-cn/software-download/windows10
如果你的系统无法更新，且你的系统是Windows 7、8.1、10 (1607/1703/1709)，
则可以通过手动安装.NET Framework 4.7.2或更高版本来解决该问题。
如果你的系统版本不在范围内（例如Windows 10 1511），则无法安装.NET Framework 4.7.2，
建议备份好数据重装系统，直接安装最新版Windows 10或11以解决该问题。
由于过低版本的Windows 10几乎没人用（都自动更新到新版了），所以兼容性会有很严重的问题。
.NET Framework的兼容性可以查看下方网页：
https://learn.microsoft.com/zh-cn/dotnet/framework/migration-guide/versions-and-dependencies
表格中的✔️代表内置，➕代表可手动安装。
只有在所有下载源都报错时才可查看本条解答，
如果你还没尝试切换下载源，请先查看下方的“为什么ModAssistant报错“版本列表下载失败”？”。
ModAssistant需要.NET Framework 4.7.2，缺失会导致无法联网，请先检查你的系统版本。
（如果你是Windows10系统，请先前往这里查看版本：设置 → 系统 → 关于 → Windows规格 → 版本号）
如果你的系统版本不低于Windows 10 1803，则可以排除.NET Framework版本过低这一原因，
可能是网络原因导致的。
如果你的系统版本低于Windows 10 1803，则是由于.NET Framework版本过低导致的。
请将你的系统更新功能恢复为启用状态，它会自动更新到最新版Windows 10，这将会解决该问题。
详情请查看这条解答：为什么ModAssistant无法在低于Windows 10 1803版本的系统中正常运行？
显示这个提示是因为你在点击同意的时候，软件还没有获取到游戏版本。
通常来说，只会有两种原因：
1. 你没看完就点了同意，再等几秒看完了再点同意，或者重新打开等10秒再点同意；
2. 网络太差加载不出版本列表，按上面“为什么加载下载Mod缓慢甚至报错？”的方法切换下载源解决。
但是，如果你已经试过切换下载源、所有下载源都报错，请看上方这条解答：
“为什么ModAssistant无法联网、所有下载源都报错“版本列表下载失败”？”
可能是ModAssistant的设置文件出现了异常，
请尝试将ModAssistant挪动到不同的文件路径（挪动到不同的文件夹），然后再重新打开软件。
ModAssistant的设置文件会跟随其所在的文件路径保存，换个文件路径（文件夹）就会将ModAssistant恢复默认设置。
大概率是游戏文件损坏导致的该报错。
（可能是由于降级后更新（覆盖了版本错误的增量包）或降级操作错误导致文件损坏）
如果你正打算降级游戏，请尝试以下解决方法：
1. 按照本网页中的“如何降级到指定的游戏版本？”的步骤来重新对游戏做一次降级。
如果你不打算降级游戏，请尝试以下解决方法：
1. 按照本网页中的“如何彻底重装游戏并恢复数据？”的步骤来足够彻底地重装一次游戏。
如果这没有解决问题，请在右上角加群，反馈给WGzeyu。
如果在打开后报错，很大概率是自动更新失败导致的，请重新下载最新版ModAssistant。
极大概率是你的网络问题导致的，前面“为什么加载下载Mod缓慢甚至报错？”的解答中有解决方法。
说明你打开了远古版本ModAssistant自动更新前创建的旧版备份。
.old结尾的是在自动更新前创建的旧版备份，如果只有.old说明是由于网络原因，自动更新下载失败。
旧版有个小问题是，旧版备份打开也会尝试更新，然后依然会尝试创建旧版备份，于是已在运行的旧版备份尝试再创建一个旧版备份，无法写入，就报错了。
这是操作系统导致的问题，可以尝试谷歌搜索“ 此实现不是Windows平台FIPS验证的加密算法的一部分 ”来寻找解决方案，或者也可以尝试下方链接中提供的解决方案。
https://www.cnblogs.com/bsjbk/p/11316670.html
https://blog.csdn.net/song_jiang_long/article/details/54172711
https://freesilo.com/?p=617
可能是你给其他游戏安装的Mod或者汉化什么的东西产生了冲突导致的。
以前见到过有人遇到这种问题，把报错的东西（其他游戏的Mod）删掉以后就能用了。
如果这没有解决问题，请在网页右上角加群，然后带上截图提问（并说明一下你尝试过哪些操作）。
由于中国连接其他国家的网络带宽较低，经常发生拥塞，所以有时候会因为网络不好导致下不动。
可以尝试以下任意方案解决网络问题：
1. 更换不同运营商的网络（可尝试手机热点）；
2. 施魔法；
3. 过段时间再试，避开高峰期。
请尝试按上方 “如何彻底重装游戏并恢复数据？”的步骤来足够彻底地重装Beat Saber。
很可能是Mod装坏了导致的无法正常加载歌曲，例如安装了版本不匹配的Mod。
游戏本身虽已支持自定义歌曲，但在安装Mod后仍会修改歌曲加载方式，Mod出错可能会导致加载不正常。
卸载重装很可能解决不了问题，因为不够彻底，请按教程给出的重装步骤来才做，这样才能保证解决问题。
不要惧怕重装，教程给出的是最快、最彻底的备份重装并恢复所有数据的方案，不会损失任何数据。
通常是缺少某个Mod导致的，点击右上角的“ ？”按钮可以查看具体原因。
（如果缺失的是Chroma，除了可能没安装Chroma，还可能是安装了Chroma但是在Chroma的设置中禁用了Chroma，Chroma的设置可以从选歌界面左侧面板顶部的Mod栏中进入，几乎全是用来禁用功能的选项，建议全部都不要勾选，默认设置就是都没有勾选）
请先一键安装基础Mod（就是默认勾选Mod），有些歌曲用到了特殊效果需要Mod才能读取。
如果你想知道如何判断基础Mod是否生效，请点我查看新手教程。
对于使用了特殊效果的歌曲，如果连最基础的Mod都没有安装，就是会一直转圈加载无法读取的，装完最基础的Mod以后，如果还缺失Mod，至少可以在右上角问号按钮显示具体缺失哪个Mod，不会一直转圈。
如果你的游戏版本低于1.20.0，也可能是游戏版本过低导致的，部分歌曲用到了新格式的新音符类型，将导致游戏版本低于1.20.0则无法读取。歌曲格式在1.20.0以后没有发生改变，1.20.0与1.31.0的歌曲格式是相同的
注：如果你完全没装Mod，疑惑为什么有的版本能加载有的版本不能，我只想说：你™装一下Mod能死吗？不同版本之间解析有差别很正常啊，有的版本遇到未知内容解析不了，有的版本硬把他读出来但解析错误，这有啥问题？你就那么愿意玩解析错误？没了Mod去玩Mod歌曲，好点的情况只是效果出不来，歌曲还能正常玩，差一点的情况就是在错误的地方额外增加一些音符或墙壁等物体导致不能玩，或者可能有其他问题。
首先确认一下是不是正在加载歌曲，歌曲加载中的时候顶部会有行彩字，如果不是：
请尝试进入游戏目录，备份后删除游戏目录下的UserData文件夹。
（该文件夹存储的是Mod的设置信息，删除后会将Mod恢复为默认设置，所有Mod都需要重新设置、
通过BSSFM添加的曲包文件夹需要重新拖入添加；如果删除后没有解决问题，可将该文件夹恢复回去）
如果没有解决，说明是Mod装出了问题导致的，例如给游戏安装了版本不匹配的Mod，
可以先尝试卸载版本不匹配的Mod、重新安装版本匹配的Mod。
如果仍然没有解决，又或者你不知道哪些是版本不匹配的Mod，请按“如何彻底重装游戏并恢复数据？”
的步骤来重装游戏，这个是最快并且最彻底的备份重装并恢复数据的方案。
如果你不按教程来重装，而是直接卸载重装，那么大概率解决不了这个问题，因为不够彻底。
按教程方案来重装游戏不会损失任何数据，且足够彻底、几乎能解决一切问题，也用不了多少时间。
不要惧怕重装！不要惧怕重装！不要惧怕重装！不要惧怕重装！不要惧怕重装！不要惧怕重装！
按教程方案来重装游戏不会损失任何数据，且足够彻底、几乎能解决一切问题，也用不了多少时间。
除非你不完整按照教程操作（例如重装以后不装Mod或不恢复数据）才会造成数据等内容缺失！
如果你在试过上方所有步骤后依然没有解决问题，请在网页右上角加群，
然后带上截图提问（并说明一下你尝试过哪些操作）。
使用我制作的歌曲路径管理器（可在【BS新手教程】中的“添加歌曲（合集曲包）”中找到），点击导出收藏即可。
如果你的游戏是1.28.0、已经安装了【社区翻译SiraLocalizer】，那么请尝试重新从网盘下最新版的【社区翻译SiraLocalizer】覆盖安装；
旧版本的社区翻译装在1.28.0版本的游戏中就会导致该问题，最新修复后的社区翻译现在已经上传至网盘中。
可能是你还没有使用ModAssistant注册OneClick，或者以前注册的OneClick由于ModAssistant挪位置/改文件名/改文件夹名导致已失效导致的。
重新注册OneClick即可解决（取消勾选后，重新勾选回来）。
具体操作请查看：【BS新手教程】
在Beat Saber刚刚发布测试版的时候，官方还不支持自定义歌曲，此时有玩家制作了Mod来实现自定义歌曲并定义了歌曲格式，这就是远古版本的歌曲格式，谱面文件为 .json 后缀。
后来没多久，游戏官方就发布了支持自定义歌曲的更新并由官方定义了一个不一样的自定义歌曲格式，
这就是现在使用的歌曲格式，谱面文件为 .dat 后缀。
在官方定义了歌曲格式以后，即使是通过Mod来加载歌曲也都使用官方格式，远古格式早已被弃用。
在游戏更新至1.20.0版本之后增加了新的音符类型，格式依然为 .dat ，
含有新音符类型的谱面无法被老版本游戏读取。
请不要通过音频文件来识别歌曲格式，游戏支持读取ogg格式音频文件，但游戏才不管文件名和后缀名，只会照着info中记录的文件名去读文件，而一些歌曲网站为了一定程度上的规避版权问题，将音频文件改了后缀名来防止你双击播放，这才导致音频文件存在不同的“格式”（只是后缀名不一样，格式是一样的）。
如果你愿意，音频文件后缀名可以改成任意名称，只要连info中的信息也一起改掉就行。
旧版转新版：
安装基础Mod之后，按照以下动图操作即可完成转换（手机请点击此处加载图片）：
新版的基础Mod已不再自带转换工具songe-converter.exe，请从BS游戏资源网盘的工具目录中下载。
由于这些歌曲实在太过远古，基本是游戏刚刚发布测试版时最初的歌曲，很多谱面的方块排布都不够合理，数量也不多，所以Mod社区那边决定在最新版里已不再提供转换工具，就像是现在的电脑已经没有光驱一样，我个人也不是很推荐使用，不过如果你想使用，还是可以从我们网盘下载转换工具。
新版转旧版：
我不打算为远古旧版提供该教程。
如果你有正当理由不是为盗版添加歌曲，可以加群@WGzeyu(785777793)，我有办法转换。
这个是由于你连不上ScoreSaber排行榜导致的。
首先，必须确保你的游戏是正版，版本不能太低，低到一定程度会被ScoreSaber禁止使用排行榜。
如果仍然连不上，可能是由于网络不好导致的，ScoreSaber使用的是国外服务器。
BeatSaber支持的自定义歌曲，不光是要有音乐，还要在里面定义每个方块摆哪。
只有音乐，没有方块要怎么玩？所以游戏不支持添加纯音乐文件，要有人作谱才行。
所以，需要到BeatSaver下载包含谱面的自定义歌曲才能添加到游戏中。
如果没有人为你喜欢的歌曲做过谱，可以尝试自己作谱，可加群学习作谱或委托群友作谱。
如果不想作谱也不愿意委托，可以试试自动生成：https://beatsage.com/
不过自动生成的谱面效果会差很多，一般不推荐使用，不好玩。
BeatSaver暂时不支持Edge和IE浏览器，可尝试更换为使用Chromium内核的浏览器，如Chrome。
目前大多数浏览器都在使用Chromium内核，很多双核浏览器也是将Chromium作为极速内核默认使用。
（而那些双核浏览器的兼容内核通常是IE，也就是说不兼容兼容模式，兼容极速模式）
请把网页拉宽一些。因为页面太窄，也就显示成了手机版页面。
BeatSaver和这个解答页的手机版都不太好用。如果可以，别把浏览器调太窄。
（手机版页面的导航栏菜单可以点击右上角按钮打开）
如果不打算调整宽度，请点击网页右上角的“三”
由于zip不支持边下载边解压边播放，所以试听是整首歌下载完成之后，才会开始播放。
而至于为啥下载缓慢，可以看前面的这条解答：为什么下歌没反应或报错、下不动？
请先检查你有没有安装SongBrowser与SongDataCore这俩Mod。
这是老的歌曲排序Mod，目前不是很推荐安装，推荐安装的是新排序Mod（BetterSongList），
新排序Mod已经在增强版ModAssistant中默认勾选，如果新老都装，则老的不生效。
目前我猜测是老的排序Mod出了什么问题，阻止了歌曲继续加载，导致的该问题，
你可以在ModAssistant中卸载这俩Mod，也可以打开Plugins文件夹删除这俩Mod的文件（注意别删错）
如果排除了老排序Mod的问题还是解决不了，请确保你添加的歌曲文件夹无误，
如果文件夹改名或挪动位置则需要重新拖入添加。
如果仍然解决不了，可以在右上角加群反馈。
由于中国连接其他国家的国际带宽不够，经常发生拥塞，所以有时候会因为网络不好导致下不动。
如果你是最新版BS，请在左侧选项面板关闭“Zen Mode”。
如果你是1.13.2及以前的版本，在游戏选择歌曲的菜单中，左侧面板可在上方切换 Mods → Chroma 进入设置，取消勾选灯光秀Lightshow Mode，即可正常游玩。
如果你在左侧打开了修改项，请先关闭所有修改项再重试。
如果你确认没有打开修改项，那么有可能是由于分辨率或抗锯齿设的太高导致的，GeForce Experience有时候会擅自修改这些设置导致出现这种情况，请尝试更改或降低画质。
（实际被设置的数值可能非常高，但游戏设置有个显示最大值限制，即使实际以远超限制的分辨率在渲染，依然只会显示限制的最大值，所以不一定非得降多少，可能更改一下就好了）
如果没有解决，请尝试在ModAssistant的“选项”页面中找到“游戏存档”，备份后删除游戏存档再启动游戏。
【这条解答可能过期，记得应该是以前SongBrowser时期的解答】
PP排序前需下载2MB的歌曲信息列表，通常半秒钟就能下完。但服务器在国外，中国国际线路经常拥塞，
慢到下不动也很正常。
无法排序大概率还是因为列表没下下来，小概率是缓存问题。
4. 打开游戏后多等会再使用PP排序。
也可以尝试使用以下方案清空缓存：
1. 打开Beat Saber\Logs\SongDataCore\_latest.log；
2. 找到[WebRequestCaching] WebCachePath :后面的路径；
3. 打开刚才找到的路径；
4. 删除缓存文件。
（如果懂些英语，可以在这个日志中确认是否为网络问题）
如果在结算页面中，红字显示Score submission disabled by xxxxxx，那么xxxxxx就是不能传分的原因；
如果没有显示该文字，那么就是由于你连不上ScoreSaber排行榜导致的。
首先，请先确保Beat Saber是最新版本，版本旧到一定程度会被禁止使用排行榜；
如果是最新版仍然出现该情况，很可能是网络问题导致的。
由于该版本的游戏存在计分BUG，统计的成绩存在问题，被ScoreSaber禁止传分了。
进入ScoreSaber网站，右上角搜索你的ID找到个人页面，点击头像旁边的刷新图标。
从原理上来说，直连VR相当于你的显示器，而串流VR就相当于平板全屏播放直播画面来充当显示器，
不管你是用Wi-Fi看直播，还是用有线、连网线看直播，直播他就是直播，和直连显示的设备比不了。
串流会对画面进行有损编码和网络传输，而目前的编码与解码，带来的画面延迟高到以至于不适合音游，
目前异步扭曲只能补偿头显旋转，画面内容及内容的位置延迟并不能补偿，会让人误以为是手柄有延迟。
1. 在Steam找到BeatSaber，右键，属性
2. 在启动选项内填写：-vrmode oculus
3. 在Oculus的PC客户端中进入 设置 → 通用
4. 将OpenXR设为Oculus
如果你是Quest2，请尽可能使用Oculus Link串流。
可以尝试以下操作：
1. 游戏设置中修改VR分辨率倍数（不是显示器画面分辨率），随便改，有变化就行，然后保存；
2. 在ModAssistant的“选项”页面中找到“游戏存档”，备份后删除游戏存档再启动游戏；
注意！存档没有保存在游戏目录里！删掉游戏重装并不会重置存档！必须要按刚才的说明操作才有效！
3. 在Win10设置 - 系统 - 显示 - 图形设置中关闭可变刷新率；
4. 如果你在使用串流（USB或Wi-Fi）而不是直连（DP或HDMI），请尝试更换一种串流方式；
5. 如果你在使用笔记本电脑，请检查Beat Saber是否运行在独显上；
6. 如果你在使用N卡，请检查WHISPER MODE设置，这个设置可能会限制游戏帧率；
7. Oculus设备可以尝试在Steam - Beat Saber - 设置启动选项，输入“-vrmode oculus”（不含引号）；
8. 如果你使用的是串流（USB/WiFi）而不是直连（DP/HDMI），可尝试关闭Windows的游戏模式；
9. 如果你在使用N卡的同时使用串流（USB/WiFi），而不是直连，可尝试关闭NVIDIA的即时回放。
如果你用的是Oculus设备并且仍未解决问题，可尝试使用Oculus TrayTool来关闭ASW。
如果仍然没有解决问题，请尝试按上方“如何彻底重装游戏并恢复数据？”的步骤来重装BS。
进入游戏设置（Setting），选择画面（Graphics），
将渲染分辨率倍数（Rendering Scale）降低至1.2或1.0，
降低抗锯齿（Antialiasing(MSAA)）至2X或关闭，
降低桌面视角分辨率（Non VR Resolution）
进入SteamVR设置，选择通用，将渲染分辨率改为自定义，并将单眼分辨率设置为100%
如果你使用的VR是通过串流来连接的，请在串流软件中将分辨率降至100%
如果你在使用MSIAfterburner的性能监测，请尝试将其关闭，有可能会影响到性能。
首先，检查是否是画质调太高或者Mod装太多导致的，建议在SteamVR左上角菜单中打开性能图，如果平时游戏过程的渲染耗时远低于中间横线，才说明性能够用，可以尝试按以下方法解决。
Process Lasso可以减少Beat Saber游戏过程中的卡顿，具体使用方法：
1. 进入Process Lasso官网，点击Download下载并安装（所使用到的功能免费版都有，无需购买）
2. 确保勾选启用以下功能：(左上角)主菜单 → 启用ProBalance
3. 打开Beat Saber，对着所有BS和VR进程：右键 → 优先级(CPU Priority) → 总是 → 高
如果你需要运行一些直播相关应用，建议降低直播相关进程的优先级，必要时可以绑定不同CPU核心使用（右键，CPU亲和力）
如果你的游戏是最新版，请先尝试降级至1.29.1，你可以点我打开降级教程，或者也可以点我打开降级教程。
如果你的系统版本低于Windows 10（如Windows 7），请先升级你的Windows系统
（或者可以试试将游戏降级至1.29.1，也许能解决）。
如果系统版本没问题也打不开，
试试按“如何彻底重装游戏并恢复数据？”的步骤来重装一次游戏，按教程重装才足够彻底。
如果还是没有解决，请尝试清空该注册表：
计算机\HKEY_CURRENT_USER\SOFTWARE\Hyperbolic Magnetism\Beat Saber
如果无法解决，请在上方导航栏中找到群号，加群提问。
如果你的游戏是最新版，请先尝试降级至1.29.1，你可以点我打开降级教程，或者也可以点我打开降级教程。
如果你装了SmartSongSuggest这个Mod，打开游戏就黑屏未响应，试试将其卸掉。
请确保不要直接在文件夹中双击exe启动游戏，请通过Steam或Steam创建的快捷方式来启动游戏。
如果仍然没有解决这个问题，请按“如何彻底重装游戏并恢复数据？”来彻底重装游戏。
（注意：卸载重装可能解决不了，按教程给出步骤重装才足够彻底，请务必将游戏安装至纯英文路径）
如果你的游戏目录中自动出现了“游侠热门单机游戏”的快捷方式，可能是系统中毒导致的，被病毒修改过的文件与Mod不兼容从而无法启动，如果遇到该情况建议重装系统，不要运行以前的任何exe可执行文件。
注：本条解答无法解决因VR端软件问题或者SteamVR问题而导致的黑屏现象。。
Beat Saber在23年5月发布的1.29.4版本更新了Unity引擎并更改为了OpenXR，对底层带来了很大的更新。
有的设备对新版兼容性还不太好（也不知道是设备还是游戏问题），将游戏降级至1.29.1版本即可解决。
有的设备 (如Pico) 串流助手更新后只兼容新版游戏，要想兼容旧版，请查看对应的解决方法：Pico串流助手
如果你想要降级至1.29.1，你可以点我打开降级教程，或者也可以点我打开降级教程。
如果纯粹只是手柄角度不对，在游戏设置里调整手柄偏移也能调回来，只是目前新版游戏的Mod还不全，
所以不如降级解决，Mod还更丰富，还不会被自动更新导致Mod失效。
如果仍然没有解决，请按“如何彻底重装游戏并恢复数据？”中的方法来彻底重装Beat Saber
（请不要卸载重装，卸载重装不够彻底、可能解决不了问题）
如果纯粹只是扳机键不管用，你在很久以前装过Beat Saber的人物Mod，那么可以试试下面的老方法，
如果不是扳机键问题，又或者没有在很久以前装过人物Mod，那么请无视下面的解决方法。
如果你曾经安装过人物Mod、旧版完整版联机Mod或者网易旧版节奏空间，请按以下步骤操作：
1. 进入Beat Saber安装目录；
2. 删除以下文件：beatsaber.vrmanifest；
3. 如果曾经在其他的目录也安装过Beat Saber，进入这些目录，并删除上一步的文件；
4. 重启SteamVR。
（需要将这个文件从所有曾经装过BeatSaber的目录中彻底删干净，然后重启SteamVR）
这极有可能是旧版人物Mod导致的问题。
完整版联机和网易版本身没有问题，但他们包含人物Mod，所以……
可以通过修改游戏存档来解决。
首先，退出游戏，打开ModAssistant，切换到“选项”页面，点击“打开游戏存档”，即可找到游戏存档
建议先对修改前的游戏存档进行备份，以防出现失误丢失数据，将整个文件夹打包为压缩包即可完成备份；
找到存档中的PlayerData.dat文件，双击打开，可以选择通过记事本或代码编辑器打开，
按Ctrl+F键打开搜索窗口，输入"didSelectRegionVersion"然后点击“查找”，在存档中找到这段文本后，将后面的数字0改为1，然后保存，即可解决该问题。
注：
修改前：e,"didSelectRegionVersion":0,"playerAgreements":{"
修改后：e,"didSelectRegionVersion":1,"playerAgreements":{"
除了那一个数字，其他的任何文本、符号都不要进行修改，改错格式将导致存档无法使用
如果没搜到这段内容，请先滚动鼠标滚轮，查看存档最顶部的内容，然后将光标点击到存档最开头的位置，这时候在搜索窗口中将方向设置为“向下”，然后再点击“查找下一个”
请尝试按上方 “如何彻底重装游戏并恢复数据？”的步骤来足够彻底地重装Beat Saber。
极有可能是Mod装坏了导致的这种问题，例如安装了版本不匹配的Mod。
重装以后，在安装Mod前一定要检查版本是否匹配！先尽可能少装Mod，试试只安装ModAssistant默认勾选那些会不会有问题，如果没问题再继续装别的，等装到哪个Mod出了问题，就找到原因了。
卸载重装很可能解决不了问题，因为不够彻底，请按教程给出的重装步骤来才做，这样才能保证解决问题。
不要惧怕重装，教程给出的是最快、最彻底的备份重装并恢复所有数据的方案，不会损失任何数据。
大多数Mod的设置，选项在游戏的主界面左边，
一些针对不同歌曲设置的Mod，选项在选择歌曲的左侧面板上方。
少部分在游戏设置的旁边MOD SETTINGS
极少部分在游戏设置SETTINGS里面
某些Mod可能需要修改Beat Saber\UserData中的配置文件来手动修改设置。
使用ModAssistant安装该Mod之后，在游戏主菜单左侧的Mod选项中，可以找到“CAMERA2”选项，点击该选项即可进入Mod设置。
左侧面板为相机管理，可以新增 / 删除相机，也可以调整不同相机所在的层级；
中间面板为相机的各种各样的详细设置，比如类型（第一/第三人称），FOV，分辨率，或者是在某些场景隐藏等等；
在VR中使用手柄拖动相机模型即可移动第三人称视角位置、角度；
在PC端使用鼠标拖动游戏画面右下角可以调整画面大小，缩小画面后直接拖动画面即可移动相机。
也就是说，如果你需要设置第三人称，需要按以下步骤操作：
1. 安装Camera2这个Mod，并在游戏中进入Camera2的设置；
2. 将相机类型改为第三人称（或直接新建一个第三人称相机）；
3. VR中使用手柄拖动相机模型来移动相机位置；
4. PC端使用鼠标拖动画面右下角来调整大小、移动位置。
目前我猜测是游戏文件损坏导致的该报错。
（可能是由于降级后更新（覆盖了版本错误的增量包）或降级操作错误导致文件损坏）
如果你正打算降级游戏，请尝试以下解决方法：
1. 按照本网页中的“如何降级到指定的游戏版本？”的步骤来重新对游戏做一次降级。
如果你不打算降级游戏，请尝试以下解决方法：
1. 按照本网页中的“如何彻底重装游戏并恢复数据？”的步骤来足够彻底地重装一次游戏。
如果这没有解决问题，请在右上角加群，反馈给WGzeyu。
该问题不一定出在Beat Saber，请先检查是否连接了其他的输入设备，例如游戏手柄、方向盘、踏板等，
如果有，请先尝试拔掉这些设备。
如果没有解决，可以再尝试重新安装SteamVR等VR工具，以及彻底重装Beat Saber。
如果你是在Steam更新后，每次首次启动Beat Saber能运行，再次启动不能运行，请尝试先重启或退出SteamVR之后再启动Beat Saber，我也遇到了这个情况，似乎是新版SteamVR的BUG，或者是新版SteamVR与旧版的LIV之类插件不兼容。
如果游戏界面显示为上图这样，很可能是游戏文件被你安装的杀软删除了导致的，
请尝试退出杀软后在Steam中验证本地文件，
如果没有解决，请退出杀软后按“如何彻底重装游戏并恢复数据？”中的方法来彻底重装BS。
一般我们推荐使用系统自带的Windows Defender，通常不会有这些误删，
此问题是我在帮别人装Mod时发现的，那台电脑装有第三方杀软。
如果你装过人物Mod、完整版联机Mod或网易版节奏空间，
可以先删除BeatSaber安装目录的beatsaber.vrmanifest，再重启SteamVR来解决。别忘了重启SteamVR！
（若装过网易版则删除网易版BS目录下的文件）
这极有可能是旧版人物Mod导致的问题。
完整版联机和网易版本身没有问题，但他们带人物Mod，所以。。
如果仍然没有解决，请按“如何彻底重装游戏并恢复数据？”中的方法来彻底重装BS。
如果你确定从没用过人物Mod，可以尝试在ModAssistant的选项界面中找到游戏存档，备份后删除。
如果还是没有解决，可以尝试安装[震动调整|RumbleMod]并进入调整。
可以尝试关闭Windows的“硬件加速GPU计划”。
设置 → 显示 → 最下方高级设置中可以找到该选项。
感谢群友闪闪提供该问题解决方法。
用的是LIV+绿幕+摄像头，LIV可以在Steam中下载。
例如这个链接：如何安装Mod？
这是本页面中的内容锚点，内容已在本页中，点击链接后电脑版页面会滚动到对应位置。
如果网页剩余内容还够长，滚动后，可视区域的顶部内容即为链接的目标内容。
如果网页剩余内容不够长，则会直接滚动到底部，这时候内容会出现在可视区域中的某个位置。
请加入社区Q群，私聊管理员WGzeyu(785777793)反馈。
WGzeyu 版权所有 本教程采用 CC BY-NC-SA 进行授权
感谢MicroBlock为该页面提供的一些前端制作
根据规定，微信/支付宝对静态收款码的远程付款做了限制，如果付款失败请换为另一种，还是不行请在下方反馈给我。
联系作者：
QQ 785777793(若无回复请加好友),Discord WGzeyu#7287
BeatSaber中文社区③：820726281（较冷清）
BeatSaber中文社区②：810303476（较活跃，推荐）
BeatSaber中文社区①：639959292（较活跃）
BeatSaber的QQ频道：w9dyu18qa0
BeatSaber谱面制作群：1101964663
BeatSaber打分新手群：941873202
我们已配置自动审核，如果你的加群申请没有立即通过，很可能是遭到了腾讯风控被屏蔽，请尝试通过其他设备重新加群。
【新降级方案】（限1.29.1版本）
降级教程：
0. 关闭ModAssistant
1. 在Steam中找到Beat Saber
2. 右键 → 属性 → 测试版
3. 将「参与测试」右侧的「无」切换至「legacy1.29.1…
4. 等待下载完成，即可完成降级
注：请不要填写测试代码，也不要点击「检查代码」。
理论来说，你无需再按传统方案的繁琐步骤来恢复数据，
如果以前给1.29.1打过Mod，切换测试分支后应该会恢复。
如果你没打过Mod，降级完成后即可按教程来安装Mod。
这不是测试版，只是利用该功能提供了引擎更新前的正式版
【传统降级方案】
下载方法：
1. 点我进入网盘
2. 选择任意一个网盘，点击【进入下载】
3. 进入【游戏备份与懒人包】文件夹
4. 找到1.29.1的原版备份
5. 对着找到的文件右键，点击下载
降级教程：
0. 确保已经通过Steam更新了游戏
1. 对着下载的原版备份右键
2. 点击解压至单独文件夹
3. 通过Steam打开游戏目录
4. 点击游戏目录的上一级目录
5. 更改游戏目录文件夹名称，随便改
6. 将原版备份解压出的文件夹移动过来
7. 将原版备份文件夹名称重命名为Beat Saber
恢复数据教程：
1. 打开降级教程第⑤步改名的游戏目录
2. 删除UserData文件夹内的Beat Saber IPA
3. 复制以下文件夹
UserData（Mod设置）
CustomSabers（光剑模型）
CustomPlatforms（场景模型）
CustomAvatars（人物模型）
CustomNotes（方块模型）
4. 进入新的游戏目录
5. 粘贴复制的那些文件夹
6. 在弹出的提示中，选择【替换】
7. 打开降级教程第⑤步改名的游戏目录
8. 进入Beat Saber_Data文件夹
9. 剪切CustomLevels文件夹
10. 进入新的游戏目录
11. 进入Beat Saber_Data文件夹
12. 粘贴剪切的那个文件夹
13. 在弹出的提示中，选择【替换】
降级后安装Mod教程：
0. 确保降级后至少打开过一次游戏
1. 退出游戏与降级以前打开的ModAssistant
2. 按正常流程打开ModAssistant就可以安装Mod了
（其实这一套步骤做下来，就是把游戏文件整个更换为旧版备份，不包含任何残留的Mod或游戏文件，只恢复以前的设置与资源文件）