mirror of
https://github.com/Zagrios/bs-manager.git
synced 2026-07-03 14:08:25 +02:00
Compare commits
47 Commits
v1.5.0-alpha.9
...
v1.5.0
| Author | SHA1 | Date | |
|---|---|---|---|
 MathieuG-P
|
413996f9f3 | ||
|
MathieuG-P
|
cda4e000ee | ||
|
Zagrios
|
2e9f62d415 | ||
|
Zagrios
|
4ef821adc9 | ||
|
Zagrios
|
21f4eacefb | ||
|
Zagrios
|
72738a256b | ||
|
Zagrios
|
a54c146772 | ||
|
Zagrios
|
43a4cdfe45 | ||
|
Zagrios
|
39d481467a | ||
|
Zagrios
|
3afcf1c12e | ||
|
Zagrios
|
da140848ba | ||
|
MathieuG-P
|
288853a6cc | ||
|
MathieuG-P
|
365e251408 | ||
|
Iluhadesu
|
eaa5eccb98 | ||
|
silentrald
|
eabeae00d6 | ||
|
silentrald
|
d209d6c336 | ||
|
Zagrios
|
eff5d5728f | ||
|
GaetanGrd
|
2ee7a904d6 | ||
|
GaetanGrd
|
f477870f74 | ||
|
Shidorien
|
2ccb3d469f | ||
|
Zagrios
|
37ad1d2d19 | ||
|
Zagrios
|
88f3467882 | ||
|
GaetanGrd
|
c63b39ff01 | ||
|
Shidorien
|
4bb01146e6 | ||
|
Shidorien
|
35a476f6ab | ||
|
Shidorien
|
1744ae1dcc | ||
|
Shidorien
|
7a38bb22f1 | ||
|
Shidorien
|
b325bf2a39 | ||
|
Shidorien
|
52d1049c98 | ||
|
Shidorien
|
7caca61c1e | ||
|
Shidorien
|
3f5b5ca4a0 | ||
|
Shidorien
|
29e5b1946d | ||
|
Shidorien
|
09ffdcae32 | ||
|
Shidorien
|
7fc6ffdda9 | ||
|
Shidorien
|
0085d1e52e | ||
|
Shidorien
|
ccd36913de | ||
|
Shidorien
|
4dcc4e92a2 | ||
|
Shidorien
|
a4dab93c36 | ||
|
Shidorien
|
39adbc42f0 | ||
|
GaetanGrd
|
71da1d9484 | ||
|
Shidorien
|
989b045be7 | ||
|
Shidorien
|
bbe708b767 | ||
|
Shidorien
|
b6513fb096 | ||
|
Shidorien
|
a4d9069a3d | ||
|
GaetanGrd
|
be49f1e02b | ||
|
Shidorien
|
0417f3d4fa | ||
|
Shidorien
|
3feca3769a |
@@ -36,7 +36,6 @@
|
||||
<hr>
|
||||
</div>
|
||||
|
||||
|
||||
<!--
|
||||
----------------------------------------
|
||||
BADGES
|
||||
@@ -58,7 +57,7 @@
|
||||
src="https://img.shields.io/badge/-DISCORD-5865f2?style=for-the-badge&logo=discord&logoColor=ffffff"
|
||||
alt="discord" /></a>
|
||||
<a href="https://twitter.com/BSManager_"><img
|
||||
src="https://img.shields.io/badge/-Twitter-black?style=for-the-badge&logo=X" alt="Twitter" /></a>
|
||||
src="https://img.shields.io/badge/-Twitter-black?style=for-the-badge&logo=X" alt="Twitter" /></a>
|
||||
<a href="https://www.bsmanager.io">
|
||||
<img src="https://img.shields.io/badge/-WebSite-00649c?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAxMDAwIDEwMDAiPgogIDxnIGZpbGw9IiMzYjgyZmYiPgogICAgPHBhdGggZD0ibTYyNi43NSA0ODUuOTEgMjAuODIgMzUxLjk0YTM1LjIxIDM1LjIxIDAgMCAxLTE1LjQ5IDMxLjM2bC0xNDQuNzEgOTYuMTRoLS4wNmEzNS41NiAzNS41NiAwIDAgMS0xMS4zMSA0Ljc3IDM0Ljg1IDM0Ljg1IDAgMCAxLTIzLjUxLTIuODdMMTM2LjU4IDgwOS45YTExNS40NSAxMTUuNDUgMCAwIDEtNjMuNzUtOTYuNDlMNTIgMzYxLjQ2YTM1LjI2IDM1LjI2IDAgMCAxIDE1LjIzLTMxLjIxbDE0NS4wNS05Ni4zNmEzNS43MiAzNS43MiAwIDAgMSAxMS4yNy00LjcgMzQuODcgMzQuODcgMCAwIDEgMjMuNTEgMi44N0w1NjMgMzg5LjQyYTExNS40MSAxMTUuNDEgMCAwIDEgNjMuNzUgOTYuNDlaIi8+CiAgICA8cGF0aCBmaWx0ZXI9ImJyaWdodG5lc3MoMzAlKSIgZD0ibTYxMy43OCA0ODYuNjcgMjAuODIgMzUyYTIyLjM0IDIyLjM0IDAgMCAxLTMyLjI2IDIxLjMxTDI4Ni40IDcwMi41N0ExMDIuNDMgMTAyLjQzIDAgMCAxIDIyOS44MyA2MTdMMjA5IDI2NWEyMi4zNSAyMi4zNSAwIDAgMSAzMi4yNi0yMS4zMkw1NTcuMiA0MDEuMDVhMTAyLjQyIDEwMi40MiAwIDAgMSA1Ni41OCA4NS42MloiLz4KICA8L2c+CiAgPHBhdGggZD0iTTcxOC4yOSA3NzYuNDggNzAwIDgwNC4xOGMtNDAuNjMgMzkuNS04Ny4wNiA2Ny4yNS0xMzMuODEgOTAuNzUtODcuMzIgNDMuOS0yMDMuNjcgNzcuMTktMjQ5IDkwLjM0YTQ4IDQ4IDAgMCAxLTI2LjE3LjE2Yy02NC0xNy43Mi0xODguNjItNzItMjM2LjI4LTEyNS40OWE0LjIzIDQuMjMgMCAwIDEgNS4zLTYuNDVjMzUuNjQgMjAuODcgMTExLjIyIDU3LjY0IDE1Ni4zNyA3NC4yMiA0OS4xOCAxOC4wNiA4MS4yOSA4Ljc0IDkyLjI4LTMuMjZhNC43NyA0Ljc3IDAgMCAxIDcuMjQuMjFjMTkuNTEgMjQgMTA3LjI2IDQuNiAxNjYuNjQtMTMgNjQuMzQtMTkgMTg1Ljg1LTc2LjU2IDIzNS43Mi0xMzUuMThabS0xOTYuMiAxNTcuMzMtMTQ3LjQ1IDU1LjY4YTMuOTIgMy45MiAwIDAgMCAxLjQ0IDcuNThsNTQuNjItLjc3YTM1LjYzIDM1LjYzIDAgMCAwIDE5LTUuNzlsNzYtNDkuNTVhNCA0IDAgMCAwLTMuNjEtNy4xNVpNMjE4LjkyIDE5NS41NmMtMjEuMTQuMDctMzMuNTUgMzUuODYtMzMuMTYgODkuMDguMiAyOCAyLjU4IDkyLjc0IDQuNzkgMTQ3LjczLjIzIDUuNzEtOC4xOCA2LjQ4LTkgLjgxbC0zOC40Mi0yNzAuNzFhNC4zOCA0LjM4IDAgMCAxIDcuMTItNCA2My42MyA2My42MyAwIDAgMCAyMS45MyAxMS44NSA0LjYxIDQuNjEgMCAwIDAgNS45LTMuNzJjNC4yLTI3LjcgMTYuNjMtNTguNzQgMzcuMzUtODguNzRhNC4zNiA0LjM2IDAgMCAxIDcuNTYuNjljMTAuODYgMjMuODcgNDkgMTAzLjggOTMuMzQgMTUyLjc5YTQuNjUgNC42NSAwIDAgMS01LjYyIDcuMjJjLTM2LjU3LTE5LjM4LTgzLjAxLTQzLjAyLTkxLjc5LTQzWm0tMTUuNDcgMzg0LjhhNC41MSA0LjUxIDAgMCAxLTQuNDYtMy45MmwtMTMuODItMTA3LjI5YTQuNSA0LjUgMCAwIDEgOC45My0xLjE1bDEzLjgyIDEwNy4yOWE0LjUgNC41IDAgMCAxLTMuODkgNSAzLjg2IDMuODYgMCAwIDEtLjU4LjA3Wk01NzcuMDggNTQuNThjLTQ2Ljc5IDE1Ljg1LTExNS40NSA0MC41Ni0xNTguNzMgNjIuNzlhMzUuNSAzNS41IDAgMCAwLTE4LjU3IDI0LjUzYy0zLjk1IDE5LjQ5LTExIDU2LjA5LTE5IDEwNy4yNi0uNyA0LjQ4LTcuMzYgMy43OC03LjExLS43NWwxMC42Ni0xOTQuNzNhMy43OCAzLjc4IDAgMCAxIDcuNDYtLjY2bDMuNDkgMTQuODVhMi41NyAyLjU3IDAgMCAwIDQuNjkuNzdjNi4xOC0xMCAyMi4zNy0zMi43OSA1Ny4zMi02NWE0LjEzIDQuMTMgMCAwIDEgNi41NiA0LjcybC0zMi41NCA3Mi44OXM3OC43OC0xOS4zNyAxNDQtMzMuMDljNC4xMS0uODcgNS42OSA1LjA4IDEuNzcgNi40MloiIGZpbGw9IiNmZmYiIHN0cm9rZT0iYmxhY2siLz4KICA8ZyBmaWxsPSIjZjQ0Ij4KICAgIDxwYXRoIGZpbHRlcj0iYnJpZ2h0bmVzcyg2MCUpIHNhdHVyYXRlKDEyMCUpIiBkPSJtOTQ3LjA3IDQxMC4zNS01Ny43NSAzNDcuNzlhMzUuMTggMzUuMTggMCAwIDEtMjIuMDYgMjcuMTVsLTE2Mi40MyA2MS42NWgtLjA2YTM1LjUyIDM1LjUyIDAgMCAxLTEyLjA2IDIuMTEgMzQuODMgMzQuODMgMCAwIDEtMjIuMjktOGwtMjczLjE3LTIyMy41YTExNS40MyAxMTUuNDMgMCAwIDEtNDAuNzYtMTA4LjIybDU3Ljc1LTM0Ny44QTM1LjI1IDM1LjI1IDAgMCAxIDQzNiAxMzQuNDdsMTYyLjgzLTYxLjc5YTM1LjUxIDM1LjUxIDAgMCAxIDEyLTIuMDggMzQuODMgMzQuODMgMCAwIDEgMjIuMjkgOGwyNzMuMTkgMjIzLjUyYTExNS4zOCAxMTUuMzggMCAwIDEgNDAuNzYgMTA4LjIzWiIvPgogICAgPHBhdGggZD0iTTkzNC4yNSA0MDguMjIgODc2LjUgNzU2YTIyLjM0IDIyLjM0IDAgMCAxLTM2LjE4IDEzLjYzbC0yNzMuMTctMjIzLjVhMTAyLjQyIDEwMi40MiAwIDAgMS0zNi4xNy05Nmw1Ny43NS0zNDcuODNhMjIuMzQgMjIuMzQgMCAwIDEgMzYuMTgtMTMuNjNsMjczLjE3IDIyMy41MWExMDIuNDIgMTAyLjQyIDAgMCAxIDM2LjE3IDk2LjA0WiIvPgogIDwvZz4KICA8ZWxsaXBzZSBmaWxsPSIjZmZmIiBzdHJva2U9ImJsYWNrIiBjeD0iNzMyLjYxIiBjeT0iNDI5LjE2IiByeD0iNjIuODMiIHJ5PSIxMTAuNzMiIHRyYW5zZm9ybT0icm90YXRlKC0xNS40NSA3MzIuNzAzIDQyOS4xOTkpIi8+Cjwvc3ZnPg==" alt="Website" /></a>
|
||||
<a href="https://www.patreon.com/bsmanager"><img
|
||||
@@ -72,76 +71,64 @@
|
||||
-->
|
||||
<div>
|
||||
<hr>
|
||||
<details open>
|
||||
<details open>
|
||||
<summary><b>Table of Contents</b></summary>
|
||||
<ul>
|
||||
<li>
|
||||
<li>
|
||||
<details>
|
||||
<summary><a href="#bsmanager-your-beat-saber-assistant">BSManager: Your Beat Saber Assistant</a></summary>
|
||||
<ul>
|
||||
<summary><a href="#bsmanager-your-beat-saber-assistant">BSManager: Your Beat Saber Assistant</a></summary>
|
||||
<ul>
|
||||
<li><a href="#what-is-it">What is it?</a></li>
|
||||
<li><a href="#why-use-it">Why use it?</a></li>
|
||||
<li><a href="#built-with">Built with</a></li>
|
||||
<li><a href="#how-to-install">How to install</a></li>
|
||||
</ul>
|
||||
<li><a href="#how-to-install">How to install?</a></li>
|
||||
</ul>
|
||||
</details>
|
||||
</li>
|
||||
<li>
|
||||
</li>
|
||||
<li>
|
||||
<details>
|
||||
<summary><a href="#version-management">Version Management</a></summary>
|
||||
<ul>
|
||||
<li>
|
||||
<details>
|
||||
<summary><a href="#downloading-multiple-versions">Downloading multiple versions</a></summary>
|
||||
<ul>
|
||||
<li>via Steam account</li>
|
||||
<li>via Oculus (PCVR) account</li>
|
||||
</ul>
|
||||
</details>
|
||||
</li>
|
||||
<li><a href="#multi-version-sharing">Multi-version Sharing</a></li>
|
||||
<li><a href="#importing-an-existing-version-of-beat-saber">Importing an existing version of Beat Saber</a>
|
||||
</li>
|
||||
<li><a href="#launch-arguments">Launch arguments</a></li>
|
||||
<li><a href="#shortcut-creation">Shortcut creation</a></li>
|
||||
</ul>
|
||||
<summary><a href="#version-management">Version Management</a></summary>
|
||||
<ul>
|
||||
<li><a href="#downloading-multiple-versions">Downloading Multiple Versions</a></li>
|
||||
<li><a href="#multi-version-sharing">Multi-Version Sharing</a></li>
|
||||
<li><a href="#importing-an-existing-version-of-beat-saber">Importing an Existing Version of Beat Saber</a></li>
|
||||
<li><a href="#launch-arguments">Launch Arguments</a></li>
|
||||
<li><a href="#shortcut-creation">Shortcut Creation</a></li>
|
||||
</ul>
|
||||
</details>
|
||||
</li>
|
||||
<li>
|
||||
</li>
|
||||
<li>
|
||||
<details>
|
||||
<summary><a href="#download-and-installation">Download and Installation</a></summary>
|
||||
<ul>
|
||||
<li><a href="#maps">Maps</a></li>
|
||||
<li><a href="#playlists">Playlists</a></li>
|
||||
<li><a href="#mods">Mods</a></li>
|
||||
<li><a href="#models">Models</a></li>
|
||||
</ul>
|
||||
<summary><a href="#download-and-installation">Download and Installation</a></summary>
|
||||
<ul>
|
||||
<li><a href="#features">Features</a></li>
|
||||
</ul>
|
||||
</details>
|
||||
</li>
|
||||
<li>
|
||||
</li>
|
||||
<li>
|
||||
<details>
|
||||
<summary><a href="#customization">Customization</a></summary>
|
||||
<ul>
|
||||
<summary><a href="#customization">Customization</a></summary>
|
||||
<ul>
|
||||
<li><a href="#tool">Tool</a></li>
|
||||
<li><a href="#beat-saber-instance">Beat Saber Instance</a></li>
|
||||
</ul>
|
||||
</ul>
|
||||
</details>
|
||||
</li>
|
||||
<li>
|
||||
</li>
|
||||
<li>
|
||||
<details>
|
||||
<summary><a href="#more-information">More Information</a></summary>
|
||||
<ul>
|
||||
<summary><a href="#more-information">More Information</a></summary>
|
||||
<ul>
|
||||
<li><a href="#support">Support</a></li>
|
||||
<li><a href="#credits">Credits</a></li>
|
||||
<li><a href="#Contributing">Contributing</a></li>
|
||||
</ul>
|
||||
<li><a href="#contributing">Contributing</a></li>
|
||||
</ul>
|
||||
</details>
|
||||
</li>
|
||||
</li>
|
||||
</ul>
|
||||
</details>
|
||||
<div align="right">
|
||||
</details>
|
||||
<div align="right">
|
||||
[<a href="#readme-bot">Go to bottom</a>]
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
@@ -155,7 +142,6 @@
|
||||
<h1><b>BSManager: Your Beat Saber Assistant</b></h1>
|
||||
</div>
|
||||
|
||||
|
||||
<!--
|
||||
WHAT IS IT?
|
||||
----------------------------------------
|
||||
@@ -166,7 +152,6 @@
|
||||
Saber</a> experience by centralizing the management of mods, maps, and game versions in one place.</p>
|
||||
</div>
|
||||
|
||||
|
||||
<!--
|
||||
WHY USE IT?
|
||||
----------------------------------------
|
||||
@@ -189,7 +174,6 @@
|
||||
<video src="https://github.com/Zagrios/bs-manager/assets/40648115/012b0196-74ef-4ee5-86a4-49e835612f96"/>
|
||||
</div>
|
||||
|
||||
|
||||
<!--
|
||||
BUILT WITH
|
||||
----------------------------------------
|
||||
@@ -219,7 +203,6 @@
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
|
||||
<!--
|
||||
HOW TO INSTALL
|
||||
----------------------------------------
|
||||
@@ -231,8 +214,12 @@
|
||||
<div>
|
||||
<h3><b>Windows Installation</b></h3>
|
||||
<ul>
|
||||
<li>Download the <a href="https://github.com/Zagrios/bs-manager/releases/latest">latest release</a> from <a
|
||||
href="https://github.com/Zagrios/bs-manager/releases">Releases</a>.</li>
|
||||
<li>Download and install <a href="https://www.bsmanager.io">BSManager</a> from one of the following sources:</li>
|
||||
<ul>
|
||||
<li><a href="https://github.com/Zagrios/bs-manager/releases/latest">GitHub</a></li>
|
||||
<li><a href="https://www.bsmanager.io">Official Website</a></li>
|
||||
<li><a href="https://www.nexusmods.com/beatsaber/mods/18?tab=files">Nexus Mods</a></li>
|
||||
</ul>
|
||||
<li>Execute the installer and <a href="https://github.com/Zagrios/bs-manager">BSManager</a> will start itself.</li>
|
||||
<li>Once it's done, if you want to download a version, select a version and download it! </li>
|
||||
<li>From the version page you can choose options, launch the version, and more!</li>
|
||||
@@ -244,8 +231,8 @@
|
||||
</div>
|
||||
|
||||
<div>
|
||||
<h3><b>Linux installation</b></h3>
|
||||
<p>Refer to <a href="https://github.com/Zagrios/bs-manager/wiki/Linux">Linux wiki</a></p>
|
||||
<h3><b>Linux Installation</b></h3>
|
||||
<p>BSManager is also available on Linux! Follow the step-by-step guide in our <a href="https://github.com/Zagrios/bs-manager/wiki/Linux">Linux installation wiki</a> to set it up properly.</p>
|
||||
</div>
|
||||
|
||||
<!--
|
||||
@@ -264,48 +251,27 @@
|
||||
existing ones, provided that you own the game on a Steam or Oculus (PC) account.</p>
|
||||
</div>
|
||||
|
||||
|
||||
<!--
|
||||
DOWNLOADING MULTIPLE VERSIONS
|
||||
----------------------------------------
|
||||
-->
|
||||
<div>
|
||||
<h2>Downloading Multiple Versions</h2>
|
||||
<p><a href="https://github.com/Zagrios/bs-manager">BSManager</a> provides two authentication methods to access your
|
||||
Steam account, ensuring safe and flexible access to
|
||||
different game versions:</p>
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<img src="https://github.com/Zagrios/bs-manager/assets/40648115/09d579de-8b8e-45d3-8829-21a25cc7daf8"/>
|
||||
</div>
|
||||
|
||||
<div>
|
||||
<p><a href="https://github.com/Zagrios/bs-manager">BSManager</a> allows you to safely and easily access different versions of Beat Saber, ensuring flexibility for modding or version-specific preferences.</p>
|
||||
<p>To download a version, you can authenticate using two methods:</p>
|
||||
<ul>
|
||||
<li><strong>via Steam</strong>: Use either your credentials, which will not be stored by <a
|
||||
href="https://github.com/Zagrios/bs-manager">BSManager</a> or
|
||||
<a href="https://github.com/SteamRE/DepotDownloader">DepotDownloader</a>, or opt for a quick and secure
|
||||
authentication via QR with the Steam Guard app.</li>
|
||||
<li><strong>via Steam</strong>: Authenticate securely using your Steam credentials or by scanning a QR code with the Steam Guard app.</li>
|
||||
<li><strong>via Oculus</strong>: BSManager redirects you to the official Oculus website for authentication to retrieve your token securely. Alternatively, you can follow <a href="https://github.com/Zagrios/bs-manager/wiki/How-to-obtain-your-Oculus-Token">this guide</a> to obtain your token manually and paste it into BSManager.</li>
|
||||
</ul>
|
||||
<p>For detailed instructions on installing versions, follow this tutorial:
|
||||
👉 <a href="https://github.com/Zagrios/bs-manager/wiki/install-or-import-a-version">How to install or import a version</a>
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<img src="https://github.com/Zagrios/bs-manager/assets/40648115/26da3a19-a936-4e6b-b79b-a139d7bd55de" />
|
||||
|
||||
<img src="https://github.com/Zagrios/bs-manager/assets/40648115/09d579de-8b8e-45d3-8829-21a25cc7daf8" alt=""/>
|
||||
</div>
|
||||
|
||||
<div>
|
||||
<ul>
|
||||
<li><strong>via Oculus</strong>: For Oculus users, <a href="https://github.com/Zagrios/bs-manager">BSManager</a>
|
||||
requires you to retrieve a connection token by following the instructions in this guide: <a href="https://github.com/Zagrios/bs-manager/wiki/How-to-obtain-your-Oculus-Token">How to obtain your Oculus Token</a>. Once obtained, please insert it into the form.</li>
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<img height=450 src="https://github.com/Zagrios/bs-manager/assets/40648115/3674e629-542d-4de3-b8db-b248f25126d7" />
|
||||
</div>
|
||||
|
||||
|
||||
<!--
|
||||
MULTI-VERSION SHARING
|
||||
----------------------------------------
|
||||
@@ -320,10 +286,9 @@
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<video src="https://github.com/Zagrios/bs-manager/assets/40648115/ba39aceb-f55f-4e58-8386-51fcfaad4957"/>
|
||||
<video src="https://github.com/Zagrios/bs-manager/assets/40648115/ba39aceb-f55f-4e58-8386-51fcfaad4957"/>
|
||||
</div>
|
||||
|
||||
|
||||
<!--
|
||||
IMPORTING AN EXISTING VERSION OF BEAT SABER
|
||||
----------------------------------------
|
||||
@@ -340,49 +305,53 @@
|
||||
<video src="https://github.com/Zagrios/bs-manager/assets/40648115/cdedb951-d97a-474d-a217-2422be3919f7"/>
|
||||
</div>
|
||||
|
||||
|
||||
<!--
|
||||
LAUNCH ARGUMENTS
|
||||
----------------------------------------
|
||||
-->
|
||||
<div>
|
||||
<h2>Launch Arguments</h2>
|
||||
<p><a href="https://github.com/Zagrios/bs-manager">BSManager</a> provides efficient management of <a
|
||||
href="https://beatsaber.com/">Beat Saber</a> launch arguments, including three predefined ones to
|
||||
enhance your gaming experience:</p>
|
||||
<p><a href="https://github.com/Zagrios/bs-manager">BSManager</a> provides advanced management of launch arguments for <a href="https://beatsaber.com/">Beat Saber</a>, allowing you to customize your gaming experience.</p>
|
||||
|
||||
<h3>Predefined Arguments</h3>
|
||||
<ul>
|
||||
<li><strong>Oculus Mode</strong>: Launches the game directly in Oculus mode, avoiding the use of STEAM VR.</li>
|
||||
<li><strong>FPFC Mode</strong>: Enables "FPFC" mode, allowing you to control the game without using a VR
|
||||
headset.</li>
|
||||
<li><strong>Debug Mode</strong>: Activates debugging mode, generating Windows log outputs for IPA.</li>
|
||||
<li><strong>Oculus Mode</strong>: Allows you to use Oculus's VR composer while bypassing SteamVR, which may improve performance. (Only useful if you launch the game via Steam).</li>
|
||||
<li><strong>FPFC Mode</strong>: Enables "First Person Flying Controller" mode, allowing you to navigate menus using the keyboard (WASD) and mouse without a VR headset.</li>
|
||||
<li><strong>Debug Mode</strong>: Activates the IPA debug console, displaying logs used by mods.</li>
|
||||
<li><strong>Skip Steam</strong>: Prevents Steam from opening automatically with Beat Saber, useful if you use an alternative VR runtime like WIVRn or Monado.</li>
|
||||
<li><strong>Map Editor</strong>: Launches the official Beat Saber map editor instead of the game.</li>
|
||||
</ul>
|
||||
<p>You also have the freedom to add your own custom launch arguments by inserting them into "Advanced Launch" and
|
||||
separating them with a semicolon (;).</p>
|
||||
|
||||
<h3>Custom Arguments</h3>
|
||||
<p>You can also add your own custom launch arguments by inserting them into "Advanced Launch" and separating them with a semicolon (;).</p>
|
||||
|
||||
<h3>Pinning Arguments</h3>
|
||||
<p>You can now pin your favorite launch arguments for quick access. By default, only <strong>Oculus Mode</strong> and <strong>Debug Mode</strong> are pinned.</p>
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<img src="https://github.com/Zagrios/bs-manager/assets/40648115/1244d49f-20e1-400c-9818-528f05cfadf5" />
|
||||
<img src="https://github.com/user-attachments/assets/c247b237-9c49-4e7b-9366-aeb1dd3b7b9a" alt="" />
|
||||
</div>
|
||||
|
||||
|
||||
<!--
|
||||
SHORTCUT CREATION
|
||||
----------------------------------------
|
||||
-->
|
||||
<div>
|
||||
<h2>Shortcut Creation</h2>
|
||||
<p>Create shortcuts to easily access your different versions of <a href="https://beatsaber.com/">Beat Saber</a> with
|
||||
<a href="https://github.com/Zagrios/bs-manager">BSManager</a>. After selecting your
|
||||
version, go to the version settings, click on "Create a Shortcut", and then select your launch options. Thus,
|
||||
you can quickly and easily launch your preferred version of <a href="https://beatsaber.com/">Beat Saber</a> with the
|
||||
desired settings.</p>
|
||||
<p>Create shortcuts to easily access your different versions of <a href="https://beatsaber.com/">Beat Saber</a> with <a href="https://github.com/Zagrios/bs-manager">BSManager</a>.
|
||||
</p>
|
||||
<p>To learn how to create a shortcut, follow the tutorial available here:
|
||||
👉 <a href="https://github.com/Zagrios/bs-manager/wiki/create-a-shortcut">Shortcut Creation Guide</a>
|
||||
</p>
|
||||
<p>This allows you to quickly and easily launch your preferred version of <a href="https://beatsaber.com/">Beat Saber</a> with the desired settings.
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<video src="https://github.com/Zagrios/bs-manager/assets/40648115/bfa1e97d-6392-4dec-a1fc-bb05048cf6d2" />
|
||||
</div>
|
||||
|
||||
|
||||
<!--
|
||||
----------------------------------------
|
||||
DOWNLOAD AND INSTALLATION
|
||||
@@ -392,79 +361,30 @@
|
||||
<hr>
|
||||
<h1><b>Download and Installation</b></h1>
|
||||
</div>
|
||||
|
||||
<div>
|
||||
<p><a href="https://github.com/Zagrios/bs-manager">BSManager</a> provides centralized and organized management of
|
||||
beatmaps, mods, and models, integrating download features and sharing between <a href="https://beatsaber.com/">Beat
|
||||
Saber</a> versions.</p>
|
||||
<p><a href="https://github.com/Zagrios/bs-manager">BSManager</a> centralizes and simplifies the management of beatmaps, playlists, mods, and models, offering seamless downloads and sharing between different <a href="https://beatsaber.com/">Beat Saber</a> versions.</p>
|
||||
</div>
|
||||
|
||||
<!--
|
||||
MAPS
|
||||
----------------------------------------
|
||||
-->
|
||||
<div>
|
||||
<h2>Maps</h2>
|
||||
<p><a href="https://github.com/Zagrios/bs-manager">BSManager</a> integrates the <a href="https://beatsaver.com">Beat
|
||||
Saver</a> API to provide you with a comprehensive list of maps downloadable directly from its interface. Moreover,
|
||||
the OneClick feature allows you to download maps with one click from various sources such as <a
|
||||
href="https://beatsaver.com">Beat Saver</a>, <a href="https://bsaber.com">BeastSaber</a>, <a
|
||||
href="https://scoresaber.com">ScoreSaber</a>, and <a href="https://www.beatleader.xyz">Beat Leader</a>. To add
|
||||
maps, simply select the desired version or the "shared" tab, then click "ADD".</p>
|
||||
<h2>Features</h2>
|
||||
<p>With <a href="https://github.com/Zagrios/bs-manager">BSManager</a>, you can manage your:
|
||||
</p>
|
||||
<ul>
|
||||
<li><b>Maps:</b> Browse and download maps directly from sources like <a href="https://beatsaver.com">Beat Saver</a>, <a href="https://bsaber.com">BeastSaber</a>, <a href="https://scoresaber.com">ScoreSaber</a>, and <a href="https://www.beatleader.xyz">Beat Leader</a>.</li>
|
||||
<li><b>Playlists:</b> Search for and download playlists directly from BSManager, just like maps. 😉
|
||||
<li><b>Mods:</b> Manage and install mods via the "Mods" tab, offering the same features as Mod Assistant.</li>
|
||||
<li><b>Models:</b> Add and manage models easily with the integration of the <a href="https://modelsaber.com">Model Saber</a> API.</li>
|
||||
</ul>
|
||||
<p>For detailed instructions on each feature, check the following guides:</p>
|
||||
<ul>
|
||||
<li>👉 <a href="https://github.com/Zagrios/bs-manager/wiki/install-any-map">Install Any Map</a></li>
|
||||
<li>👉 <a href="https://github.com/Zagrios/bs-manager/wiki/install-all-playlists-you-want">Install Playlists</a></li>
|
||||
<li>👉 <a href="https://github.com/Zagrios/bs-manager/wiki/install-mods-on-your-version">Install Mods</a></li>
|
||||
<li>👉 <a href="https://github.com/Zagrios/bs-manager/wiki/modify-models-in-your-beat-saber">Manage Models</a></li>
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<video src="https://github.com/Zagrios/bs-manager/assets/40648115/3f9f9968-ac55-465e-bc28-17aebfc787ea"/>
|
||||
|
||||
</div>
|
||||
|
||||
<!--
|
||||
PLAYLISTS
|
||||
----------------------------------------
|
||||
-->
|
||||
<div>
|
||||
<h2>Playlists</h2>
|
||||
<p>Although the playlist management interface is not yet developed, <a
|
||||
href="https://github.com/Zagrios/bs-manager">BSManager</a> offers a OneClick feature for playlists from <a
|
||||
href="https://beatsaver.com">Beat Saver</a>.</p>
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<video src="https://github.com/Zagrios/bs-manager/assets/40648115/733fe6bb-c157-4c47-8a79-f8062380bcc8" />
|
||||
</div>
|
||||
|
||||
<!--
|
||||
MODS
|
||||
----------------------------------------
|
||||
-->
|
||||
<div>
|
||||
<h2>Mods</h2>
|
||||
<p>Manage your mods easily with <a href="https://github.com/Zagrios/bs-manager">BSManager</a>. After downloading a
|
||||
version, navigate to the "Mods" tab of the selected version to manage and install mods. <a
|
||||
href="https://github.com/Zagrios/bs-manager">BSManager</a> operates similarly to Mod Assistant and offers the same
|
||||
mods as this tool.</p>
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<video src="https://github.com/Zagrios/bs-manager/assets/40648115/ca8f0727-b2dd-41f3-bbea-9bcaf61a89f1"/>
|
||||
|
||||
</div>
|
||||
|
||||
<!--
|
||||
MODELS
|
||||
----------------------------------------
|
||||
-->
|
||||
<div>
|
||||
<h2>Models</h2>
|
||||
<p>Add and manage models simply via the corresponding tab on the desired version or by going to the "shared" tab. The
|
||||
<a href="https://modelsaber.com">Model Saber</a> API is integrated to provide easy and direct access to models
|
||||
available for <a href="https://beatsaber.com/">Beat Saber</a>.</p>
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<video src="https://github.com/Zagrios/bs-manager/assets/40648115/d983b34b-9f4c-4274-aee4-4c1c03dd90d0"/>
|
||||
</div>
|
||||
|
||||
|
||||
<!--
|
||||
----------------------------------------
|
||||
CUSTOMIZATION
|
||||
@@ -495,7 +415,7 @@
|
||||
</ul>
|
||||
</div>
|
||||
|
||||
<div align="center">
|
||||
<div align="center">
|
||||
<video src = "https://github.com/Zagrios/bs-manager/assets/40648115/d2c1b0ec-a2f5-41b5-99d5-c4c2cd34cbd4" />
|
||||
</div>
|
||||
|
||||
@@ -520,7 +440,6 @@
|
||||
<video src="https://github.com/Zagrios/bs-manager/assets/40648115/f66a2c99-770e-42ca-9a71-b1806946ad0c" />
|
||||
</div>
|
||||
|
||||
|
||||
<!--
|
||||
----------------------------------------
|
||||
MORE INFORMATION
|
||||
@@ -546,7 +465,6 @@
|
||||
GitHub</a>.</p>
|
||||
</div>
|
||||
|
||||
|
||||
<!--
|
||||
CREDITS
|
||||
----------------------------------------
|
||||
@@ -575,12 +493,11 @@
|
||||
href="https://github.com/Zagrios/bs-manager">BSManager</a>!</p>
|
||||
<div align="center">
|
||||
<a href="https://github.com/Zagrios/bs-manager/graphs/contributors">
|
||||
<img src="https://contrib.rocks/image?repo=Zagrios/bs-manager" />
|
||||
<img src="https://contrib.rocks/image?repo=Zagrios/bs-manager" alt="Contributor list" />
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
<!--
|
||||
----------------------------------------
|
||||
Others
|
||||
|
||||
@@ -813,5 +813,14 @@
|
||||
"ReleaseImg": "https://clan.fastly.steamstatic.com/images/32055887/65df6b24c3b8a7f415080ac01394917cedabf9fc.png",
|
||||
"ReleaseDate": "1733846128",
|
||||
"year": "2024"
|
||||
},
|
||||
{
|
||||
"BSVersion": "1.40.1",
|
||||
"BSManifest": "8655702238937650396",
|
||||
"OculusBinaryId": "8526525354113835",
|
||||
"ReleaseURL": "https://steamcommunity.com/games/620980/announcements/detail/510696972023234581",
|
||||
"ReleaseImg": "https://clan.fastly.steamstatic.com/images/32055887/5cc1ca353151ed31da2764716cdcbe89442aeeeb.png",
|
||||
"ReleaseDate": "1738144954",
|
||||
"year": "2025"
|
||||
}
|
||||
]
|
||||
@@ -144,7 +144,7 @@
|
||||
"description": "Descrição",
|
||||
"dropdown": {
|
||||
"import-mods": "Importar mods",
|
||||
"desinstalar-all": "Desinstalar todos",
|
||||
"uninstall-all": "Desinstalar todos",
|
||||
"unselect-all": "Desmarcar todos"
|
||||
}
|
||||
}
|
||||
@@ -173,7 +173,7 @@
|
||||
"verify-files": "Verificar arquivos",
|
||||
"clone": "Clonar",
|
||||
"edit": "Editar",
|
||||
"desinstalar": "Desintalar",
|
||||
"uninstall": "Desintalar",
|
||||
"create-shortcut": "Criar um atalho",
|
||||
"shared-folders": "Pastas compartilhadas"
|
||||
}
|
||||
@@ -571,7 +571,7 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"desinstalar-mod": {
|
||||
"uninstall-mod": {
|
||||
"titles": {
|
||||
"success": "Mod desinstalado 🎉"
|
||||
},
|
||||
@@ -581,7 +581,7 @@
|
||||
}
|
||||
}
|
||||
},
|
||||
"desinstalar-all-mods": {
|
||||
"uninstall-all-mods": {
|
||||
"titles": {
|
||||
"success": "Mods desinstalados 🎉"
|
||||
},
|
||||
@@ -753,7 +753,7 @@
|
||||
"submit": "Importar uma versão"
|
||||
}
|
||||
},
|
||||
"bs-desinstalar": {
|
||||
"bs-uninstall": {
|
||||
"title": "Desinstalar",
|
||||
"description": "Você tem certeza que quer desinstalar Beat Saber {version}? Você vai ter que baixar ela novamente se quiser jogá-la.",
|
||||
"buttons": {
|
||||
@@ -789,12 +789,12 @@
|
||||
"submit": "Clonar"
|
||||
}
|
||||
},
|
||||
"desinstalar-mod": {
|
||||
"uninstall-mod": {
|
||||
"title": "Desinstalar",
|
||||
"description": "Você tem certeza que quer desinstalar Beat Saber {mod}? Pode fazer com que outros mods parem de funcionar.",
|
||||
"description-bsipa": "Você tem certeza que quer desinstalar BSIPA? Depois, nenhum mod irá funcionar."
|
||||
},
|
||||
"desinstalar-all-mods": {
|
||||
"uninstall-all-mods": {
|
||||
"title": "Desinstalando mods",
|
||||
"description": "Você tem certeza que quer desinstalar todos os mods da versão {version}? Essa operação não pode ser desfeita."
|
||||
},
|
||||
|
||||
+33
-1
@@ -1,12 +1,44 @@
|
||||
## Table of Contents
|
||||
|
||||
- [With BSManager](#with-bsmanager)
|
||||
- [Install playlists](#how-to-install-playlists-with-bsmanager)
|
||||
- [Import playlists](#how-to-import-playlist-with-bsmanager)
|
||||
- [Manual Installation](#manual-installation)
|
||||
- [One-Click Installation](#one-click-installation)
|
||||
|
||||
## With BSManager
|
||||
|
||||
(Coming with version 1.5.0)
|
||||
### How to Install Playlists with BSManager
|
||||
|
||||
1. Download and install [BSManager](https://www.bsmanager.io) from one of the following sources:
|
||||
- [GitHub](https://github.com/Zagrios/bs-manager/releases/latest)
|
||||
- [Official Website](https://www.bsmanager.io)
|
||||
- [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files)
|
||||
2. Launch BSManager and select the version of *Beat Saber* where you want to install playlists from the list on the left side of the interface.
|
||||
3. Go to the `Playlist` section by clicking on the __`Maps`__ tab.
|
||||
4. Click the __`Add`__ button, then select __`Browse playlist`__ to open the list of online playlists.
|
||||
5. Use the search bar at the top of the interface to filter playlists or sort the list.
|
||||
6. Download to install it.
|
||||
7. Wait for the installation to complete. Once it's finished, you can launch Beat Saber directly from [BSManager](https://www.bsmanager.io) and enjoy your new playlists!
|
||||
|
||||
> [!NOTE]
|
||||
> You can click on a playlist's image to view the maps it contains and download only the maps you want.
|
||||
|
||||
### How to Import Playlist with BSManager
|
||||
|
||||
1. Download and install [BSManager](https://www.bsmanager.io) from one of the following sources:
|
||||
- [GitHub](https://github.com/Zagrios/bs-manager/releases/latest)
|
||||
- [Official Website](https://www.bsmanager.io)
|
||||
- [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files)
|
||||
2. Launch BSManager and select the version of *Beat Saber* where you want to install playlists from the list on the left side of the interface.
|
||||
3. Go to the `playlist` section by clicking on the __`Maps`__ tab.
|
||||
4. From here, there are two possible methods:
|
||||
1. Click the __`Add`__ button, then select __`Import a playlist`__ and choose the file to import.
|
||||
2. Drag and drop your file directly onto the playlist interface in BSManager.
|
||||
5. Wait for the import to complete. Once finished, you can launch Beat Saber directly from [BSManager](https://www.bsmanager.io) and enjoy your new playlists!
|
||||
|
||||
> [!Important]
|
||||
> The file must be in `.bplist` or `.json` format to be imported.
|
||||
|
||||
## Manual Installation
|
||||
|
||||
|
||||
@@ -1,18 +1,41 @@
|
||||
## Table of Contents
|
||||
|
||||
- [With BSManager](#with-bsmanager)
|
||||
- [Install maps](#how-to-install-maps-with-bsmanager)
|
||||
- [Import maps](#how-to-import-maps-with-bsmanager)
|
||||
- [Manual Installation](#manual-installation)
|
||||
- [One-Click Installation](#one-click-installation)
|
||||
|
||||
## With BSManager
|
||||
|
||||
1. Download and install [BSManager](https://www.bsmanager.io) from [GitHub](https://github.com/Zagrios/bs-manager/releases/latest).
|
||||
2. Launch [BSManager](https://www.bsmanager.io) and select the Beat Saber version where you want to install maps from the list on the left of the interface.
|
||||
3. Go to maps by clicking on the __`Maps`__ tab.
|
||||
4. Click on the __`Add`__ button to access the list of online maps.
|
||||
5. Find the maps that you want to install from the provided list. You can use the search bar at the top of the interface to filter maps by __`name`__, __`type`__, __`mods`__, __`tags`__, __`notes per second`__, __`duration`__, and order the list by __`latest`__, __`relevance`__, __`rating`__, or __`curated`__.
|
||||
6. Double-click on the map or simply click on the download button to install the map.
|
||||
7. Wait for the installation to complete. Once it's finished, you can launch Beat Saber directly from [BSManager](https://www.bsmanager.io) to enjoy your new maps!
|
||||
### How to Install Maps with BSManager
|
||||
|
||||
1. Download and install [BSManager](https://www.bsmanager.io) from one of the following sources:
|
||||
- [GitHub](https://github.com/Zagrios/bs-manager/releases/latest)
|
||||
- [Official Website](https://www.bsmanager.io)
|
||||
- [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files)
|
||||
2. Launch BSManager and select the version of *Beat Saber* where you want to install maps from the list on the left side of the interface.
|
||||
3. Go to the `Maps` section by clicking on the __`Maps`__ tab.
|
||||
4. Click the __`Add`__ button to access the list of online maps.
|
||||
5. Use the search bar at the top of the interface to filter maps by __`name`__, __`type`__, __`mods`__, __`tags`__, __`notes per second`__, or __`duration`__, and order the list by __`latest`__, __`relevance`__, __`rating`__, or __`curated`__.
|
||||
6. Download to install it.
|
||||
7. Wait for the installation to complete. Once it's finished, you can launch Beat Saber directly from [BSManager](https://www.bsmanager.io) to enjoy your new maps!
|
||||
|
||||
### How to Import Maps with BSManager
|
||||
|
||||
1. Download and install [BSManager](https://www.bsmanager.io) from one of the following sources:
|
||||
- [GitHub](https://github.com/Zagrios/bs-manager/releases/latest)
|
||||
- [Official Website](https://www.bsmanager.io)
|
||||
- [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files)
|
||||
2. Launch BSManager and select the version of *Beat Saber* where you want to install maps from the list on the left side of the interface.
|
||||
3. Go to the `Maps` section by clicking on the __`Maps`__ tab.
|
||||
4. From here, there are two possible methods:
|
||||
1. Click the __`Add`__ button, then select __`Import maps`__ and choose the .zip file to import.
|
||||
2. Drag and drop your .zip file directly onto the maps interface in BSManager.
|
||||
5. Wait for the import to complete. Once finished, you can launch Beat Saber directly from [BSManager](https://www.bsmanager.io) to enjoy your new maps!
|
||||
|
||||
> [!Important]
|
||||
> The file must be in `.zip` format to be imported.
|
||||
|
||||
## Manual Installation
|
||||
|
||||
|
||||
+7
-4
@@ -12,17 +12,20 @@
|
||||
- [With BSManager](#with-bsmanager)
|
||||
- [One-Click Installation](#one-click-installation)
|
||||
|
||||
# With BSManager
|
||||
## With BSManager
|
||||
|
||||
1. Download and install [BSManager](https://www.bsmanager.io) from [GitHub](https://github.com/Zagrios/bs-manager/releases/latest), [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files), or [Website](https://www.bsmanager.io).
|
||||
1. Download and install [BSManager](https://www.bsmanager.io) from one of the following sources:
|
||||
- [GitHub](https://github.com/Zagrios/bs-manager/releases/latest)
|
||||
- [Official Website](https://www.bsmanager.io)
|
||||
- [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files)
|
||||
2. Launch [BSManager](https://www.bsmanager.io) and select the Beat Saber version where you want to install models from the list on the left of the interface.
|
||||
3. Go to models by clicking on the __`Models`__ tab.
|
||||
4. Click on the __`Add`__ button to access the list of online models.
|
||||
5. Find the models that you want to install from the provided list. You can use the search bar at the top of the interface to filter models by __`name`__, __`type`__, and order the list by __`date`__, __`name`__, or __`author`__.
|
||||
6. Double-click on the model or simply click on the download button to install the model.
|
||||
6. Download to install the model.
|
||||
7. Wait for the installation to complete. Once it's finished, you can launch Beat Saber directly from [BSManager](https://www.bsmanager.io) to enjoy your new models!
|
||||
|
||||
# One-Click Installation
|
||||
## One-Click Installation
|
||||
|
||||
1. Launch [BSManager](https://www.bsmanager.io) and make sure that the One-Click installation feature is enabled for models.
|
||||
2. Go to one of the supported websites and search for the models you want to install.
|
||||
|
||||
+24
-1
@@ -1,11 +1,18 @@
|
||||
## Table of Contents
|
||||
|
||||
- [With BSManager](#with-bsmanager)
|
||||
- [Install mods](#how-to-install-mods-with-bsmanager)
|
||||
- [Import mods](#how-to-import-mods-with-bsmanager)
|
||||
- [Manual Installation](#manual-installation)
|
||||
|
||||
## With BSManager
|
||||
|
||||
1. Download and install [BSManager](https://www.bsmanager.io) from [GitHub](https://github.com/Zagrios/bs-manager/releases/latest), [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files), or the [official website](https://www.bsmanager.io).
|
||||
### How to Install Mods with BSManager
|
||||
|
||||
1. Download and install [BSManager](https://www.bsmanager.io) from one of the following sources:
|
||||
- [GitHub](https://github.com/Zagrios/bs-manager/releases/latest)
|
||||
- [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files)
|
||||
- [Official Website](https://www.bsmanager.io)
|
||||
2. Launch [BSManager](https://www.bsmanager.io) and select the version of Beat Saber that you want to use from the list on the left side of the interface.
|
||||
3. Go to mods by clicking on the __`Mods`__ tab.
|
||||
4. Find the mods that you want to install from the provided list. You can use the search bar at the top of the interface to filter mods by name.
|
||||
@@ -13,6 +20,22 @@
|
||||
6. Click __`Install or Update`__ at the bottom-right corner of the interface.
|
||||
7. Wait for the installation to complete. Once it's finished, you can launch Beat Saber directly from [BSManager](https://www.bsmanager.io) to enjoy your new mods!
|
||||
|
||||
### How to Import Mods with BSManager
|
||||
|
||||
1. Download and install [BSManager](https://www.bsmanager.io) from one of the following sources:
|
||||
- [GitHub](https://github.com/Zagrios/bs-manager/releases/latest)
|
||||
- [Official Website](https://www.bsmanager.io)
|
||||
- [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files)
|
||||
2. Launch BSManager and select the version of *Beat Saber* where you want to install mods from the list on the left side of the interface.
|
||||
3. Go to the `Mods` tab.
|
||||
4. From here, there are two possible methods:
|
||||
1. Click on __`⁝`__ button, then select __`Import mods`__ and choose the .zip or .dll file to import.
|
||||
2. Drag and drop your .zip or .dll file directly onto the mods interface in BSManager.
|
||||
5. Wait for the import to complete. Once finished, you can launch Beat Saber directly from [BSManager](https://www.bsmanager.io) to enjoy your new mods!
|
||||
|
||||
> [!Important]
|
||||
> The file must be in `.zip` or `.dll` format to be imported.
|
||||
|
||||
## Manual Installation
|
||||
|
||||
> [!IMPORTANT]
|
||||
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 112 KiB |
@@ -15,6 +15,10 @@
|
||||
4. Choose your launch options.
|
||||
5. Click on __`Create a Shortcut`__. It should now appear on your desktop.
|
||||
|
||||
<div align="center">
|
||||
<img src="../wiki/Guides/Installation-and-updates/Create-a-shortcut/BsmShortcutInterface.png" alt="SeeTxtFile.png" />
|
||||
</div>
|
||||
|
||||
### On Taskbar
|
||||
|
||||
1. Open Notepad and drag & drop the version shortcut you need.
|
||||
@@ -31,25 +35,12 @@ start <version link>
|
||||
|
||||
## How to create a shortcut on Steam
|
||||
|
||||
1. In [BSManager](https://www.bsmanager.io), select the version you want to open in Steam from the list on the left side.
|
||||
2. Click the gear icon at the top-right corner and select __`Create a Shortcut`__. This will create a shortcut on your desktop for launching the game.
|
||||
3. Open Notepad (or any other text editor) and drag & drop the shortcut file into the text editor. You will see a string of text similar to this:
|
||||
|
||||
```yaml
|
||||
bsmanager://launch/?version=1.29.1&versionIno=3940649674381032
|
||||
```
|
||||
|
||||
4. Copy this text and remove any spaces.
|
||||
|
||||
<div align="center">
|
||||
<img src="../wiki/Guides/Installation-and-updates/Create-a-shortcut/SeeTxtFile.png" alt="SeeTxtFile.png" />
|
||||
</div>
|
||||
|
||||
5. Open Steam and add [BSManager](https://www.bsmanager.io) as a non-Steam game.
|
||||
6. In your Steam library, right-click on [BSManager](https://www.bsmanager.io), select __`Properties`__, and add the link from step 4 as a launch parameter.
|
||||
7. Disable "Desktop Game Theatre" and scroll down to enable "Include in VR Library" so you can launch it from your VR headset.
|
||||
8. Rename this entry to whatever you want and customize the name and the icon of the shortcut if desired.
|
||||
1. Launch [BSManager](https://www.bsmanager.io) and select your version.
|
||||
2. Click on the gear icon at the top-right corner of the version.
|
||||
3. Click on the __`Create a Shortcut`__ button.
|
||||
4. Choose your launch options.
|
||||
5. Click on __`Create a Shortcut`__. It should now appear on your desktop.
|
||||
|
||||
<div align="center">
|
||||
<img src="../wiki/Guides/Installation-and-updates/Create-a-shortcut/SteamShortcut.png" alt="SteamShortcut.png" />
|
||||
<img src="../wiki/Guides/Installation-and-updates/Create-a-shortcut/SteamShortcutCheck.png" alt="SeeTxtFile.png" />
|
||||
</div>
|
||||
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 256 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 54 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 26 KiB |
+22
-5
@@ -10,7 +10,10 @@
|
||||
|
||||
## Install a Version with Steam
|
||||
|
||||
1. Download and install [BSManager](https://www.bsmanager.io) from [GitHub](https://github.com/Zagrios/bs-manager/releases/latest), [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files), or the [official website](https://www.bsmanager.io).
|
||||
1. Download and install [BSManager](https://www.bsmanager.io) from one of the following sources:
|
||||
- [GitHub](https://github.com/Zagrios/bs-manager/releases/latest)
|
||||
- [Official Website](https://www.bsmanager.io)
|
||||
- [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files)
|
||||
2. Open the __`Add Versions`__ interface and select the version you wish to download.
|
||||
3. Choose __`Steam`__ as your platform.
|
||||
4. Enter your Steam credentials (ID and password) or scan the QR code using the Steam app on your phone.
|
||||
@@ -28,15 +31,29 @@
|
||||
> - Ensure that Beat Saber is in your __Oculus PCVR__ library to enable downgrading.
|
||||
> - You must run Beat Saber at least once on your computer before attempting to launch retrograde Oculus versions from [BSManager](https://www.bsmanager.io).
|
||||
|
||||
1. Download and install [BSManager](https://www.bsmanager.io) from [GitHub](https://github.com/Zagrios/bs-manager/releases/latest), [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files), or the [official website](https://www.bsmanager.io).
|
||||
1. Download and install [BSManager](https://www.bsmanager.io) from one of the following sources:
|
||||
- [GitHub](https://github.com/Zagrios/bs-manager/releases/latest)
|
||||
- [Official Website](https://www.bsmanager.io)
|
||||
- [Nexus Mods](https://www.nexusmods.com/beatsaber/mods/18?tab=files)
|
||||
2. Open the __`Add Versions`__ interface and select the version you wish to download.
|
||||
3. Choose __`Oculus Store`__ as your platform.
|
||||
4. Follow [this guide](How-to-obtain-your-Oculus-Token) to obtain your Oculus token.
|
||||
5. Once logged into Oculus, the download will start automatically. Please wait for it to complete.
|
||||
6. When the download is finished, select the downloaded version and click the __`Launch`__ button to verify that the game launches correctly.
|
||||
4. Click on __`Connect to Meta`__ or __`Enter my login token manually`__ based on your preferred login method.
|
||||
|
||||
### If you selected __`Connect to Meta`__
|
||||
|
||||
1. You will be redirected to the Oculus website. Enter your email and follow the instructions to log in.
|
||||
2. Once logged in, the download will start automatically. Please wait for it to complete.
|
||||
3. When the download finishes, select the downloaded version and click the __`Launch`__ button to verify that the game launches correctly.
|
||||
|
||||
### If you selected __`Enter my login token manually`__
|
||||
|
||||
1. Follow [this guide](How-to-obtain-your-Oculus-Token) to obtain your Oculus token.
|
||||
2. Once the token is entered and validated, the download will start automatically. Please wait for it to complete.
|
||||
3. When the download finishes, select the downloaded version and click the __`Launch`__ button to verify that the game launches correctly.
|
||||
|
||||
<div align="center">
|
||||
<img src="../wiki/Guides/Installation-and-updates/Install-or-import-a-version/OculusLogin.png" alt="OculusLogin.png" />
|
||||
<img src="../wiki/Guides/Installation-and-updates/Install-or-import-a-version/OculusLoginToken.png" alt="OculusLoginToken.png" />
|
||||
</div>
|
||||
|
||||
## How to Import a Version
|
||||
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 66 KiB After Width: | Height: | Size: 125 KiB |
BIN
Binary file not shown.
|
After Width: | Height: | Size: 66 KiB |
+1
-1
@@ -2,7 +2,7 @@
|
||||
"name": "bs-manager",
|
||||
"description": "Manage maps, mods and more for Beat Saber",
|
||||
"main": "./.erb/dll/main.bundle.dev.js",
|
||||
"version": "1.5.0-alpha.9",
|
||||
"version": "1.5.0",
|
||||
"scripts": {
|
||||
"build-rust-scripts": "ts-node ./.erb/scripts/build-rust-scripts.js",
|
||||
"build": "concurrently \"npm run build:main\" \"npm run build:renderer\"",
|
||||
|
||||
Generated
+2
-2
@@ -1,12 +1,12 @@
|
||||
{
|
||||
"name": "bs-manager",
|
||||
"version": "1.5.0-alpha.9",
|
||||
"version": "1.5.0",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "bs-manager",
|
||||
"version": "1.5.0-alpha.9",
|
||||
"version": "1.5.0",
|
||||
"hasInstallScript": true,
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "bs-manager",
|
||||
"version": "1.5.0-alpha.9",
|
||||
"version": "1.5.0",
|
||||
"description": "BSManager",
|
||||
"main": "./dist/main/main.js",
|
||||
"author": {
|
||||
|
||||
@@ -280,6 +280,8 @@ export class LocalMapsManagerService {
|
||||
return new Observable<Progression>(observer => {
|
||||
const progress: Progression = { total: hashs.length, current: 0 };
|
||||
|
||||
observer.next(progress);
|
||||
|
||||
(async () => {
|
||||
const versionMapsPath = await this.getMapsFolderPath(version);
|
||||
const mapsPaths = await getFoldersInFolder(versionMapsPath);
|
||||
@@ -295,7 +297,7 @@ export class LocalMapsManagerService {
|
||||
observer.next(progress);
|
||||
}
|
||||
})()
|
||||
.catch(e => observer.error(e))
|
||||
.catch(e => {observer.error(e); console.log("AAAA", e)})
|
||||
.finally(() => observer.complete());
|
||||
});
|
||||
}
|
||||
|
||||
@@ -139,9 +139,11 @@ export abstract class AbstractLauncherService {
|
||||
for (const [ key, value ] of Object.entries(parseEnvString(envString))) {
|
||||
if (key in env) {
|
||||
log.warn("Ignoring", `${key}=${value}`, "already set env launch command");
|
||||
} else {
|
||||
log.info("Injecting", `${key}="${value}"`, "to the env launch command");
|
||||
continue;
|
||||
}
|
||||
|
||||
log.info("Injecting", `${key}="${value}"`, "to the env launch command");
|
||||
env[key] = value;
|
||||
}
|
||||
|
||||
launchOptions.command = command.substring(index + this.COMMAND_FORMAT.length);
|
||||
|
||||
@@ -89,7 +89,7 @@ export class SteamLauncherService extends AbstractLauncherService implements Sto
|
||||
obs.next({type: BSLaunchWarning.UNABLE_TO_LAUNCH_STEAM});
|
||||
});
|
||||
}
|
||||
else {
|
||||
else if(skipSteam) {
|
||||
obs.next({ type: BSLaunchEvent.SKIPPING_STEAM_LAUNCH});
|
||||
}
|
||||
|
||||
|
||||
@@ -3,7 +3,6 @@ import { BbmFullMod, BbmMod, BbmModVersion, BbmPlatform } from "../../../shared/
|
||||
import { RequestService } from "../request.service";
|
||||
import { BsStore } from "../../../shared/models/bs-store.enum";
|
||||
import log from "electron-log"
|
||||
import { tryit } from "shared/helpers/error.helpers";
|
||||
|
||||
export class BeatModsApiService {
|
||||
private static instance: BeatModsApiService;
|
||||
@@ -60,42 +59,17 @@ export class BeatModsApiService {
|
||||
});
|
||||
}
|
||||
|
||||
public async getModByHash<T extends string>(hashs: T[]): Promise<Record<T, BbmModVersion>> {
|
||||
|
||||
const getModsFromCache = (hashs: T[]): Record<T, BbmModVersion> => {
|
||||
const mods = {} as Record<T, BbmModVersion>;
|
||||
|
||||
for (const hash of hashs) {
|
||||
const mod = this.modsHashCache.get(hash);
|
||||
if(mod){
|
||||
mods[hash] = mod;
|
||||
}
|
||||
}
|
||||
|
||||
return mods;
|
||||
public getModByHash(hash: string): Promise<BbmModVersion|undefined> {
|
||||
if (this.modsHashCache.has(hash)) {
|
||||
return Promise.resolve(this.modsHashCache.get(hash));
|
||||
}
|
||||
|
||||
const mods = getModsFromCache(hashs);
|
||||
const missingHashs = hashs.filter(hash => !mods[hash]);
|
||||
|
||||
if(!missingHashs.length){
|
||||
return mods;
|
||||
}
|
||||
|
||||
const url = new URL(`${this.MODS_REPO_API_URL}/hashlookup`);
|
||||
missingHashs.forEach(hash => url.searchParams.append("hash", hash));
|
||||
|
||||
const res = await tryit(() => this.requestService.getJSON<{ modVersions: BbmModVersion[] }>(url.toString()));
|
||||
|
||||
if(res.error){
|
||||
log.error(`Failed to get mod by hashes`, res.error);
|
||||
return this.requestService.getJSON<{ modVersions: BbmModVersion[] }>(`${this.MODS_REPO_API_URL}/hashlookup?hash=${hash}`).then(({ data }) => {
|
||||
this.updateModsHashCache(data?.modVersions ?? []);
|
||||
return data?.modVersions?.at(0);
|
||||
}).catch((): undefined => {
|
||||
log.error(`Failed to get mod by hash: ${hash}`);
|
||||
return undefined;
|
||||
}
|
||||
|
||||
this.updateModsHashCache(res.result?.data?.modVersions ?? []);
|
||||
|
||||
const missingMods = getModsFromCache(missingHashs);
|
||||
|
||||
return {...mods, ...missingMods};
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
@@ -19,7 +19,6 @@ import crypto from "crypto";
|
||||
import { BsmZipExtractor } from "main/models/bsm-zip-extractor.class";
|
||||
import { BsmShellLog, bsmSpawn } from "main/helpers/os.helpers";
|
||||
import { BbmFullMod, BbmModVersion, ExternalMod } from "../../../shared/models/mods/mod.interface";
|
||||
import { Stats } from "fs";
|
||||
|
||||
export class BsModsManagerService {
|
||||
private static instance: BsModsManagerService;
|
||||
@@ -29,6 +28,8 @@ export class BsModsManagerService {
|
||||
private readonly linuxService: LinuxService;
|
||||
private readonly requestService: RequestService;
|
||||
|
||||
private manifestMatches: BbmModVersion[];
|
||||
|
||||
public static getInstance(): BsModsManagerService {
|
||||
if (!BsModsManagerService.instance) {
|
||||
BsModsManagerService.instance = new BsModsManagerService();
|
||||
@@ -43,9 +44,14 @@ export class BsModsManagerService {
|
||||
this.requestService = RequestService.getInstance();
|
||||
}
|
||||
|
||||
private async getModsFromHashes(hashes: string[]): Promise<BbmModVersion[] | undefined> {
|
||||
const mods = await this.beatModsApi.getModByHash(hashes)
|
||||
return Object.values(mods).filter(mod => !mod.contentHashes.some(content => content.path.includes("IPA")));
|
||||
private async getModFromHash(hash: string): Promise<BbmModVersion | undefined> {
|
||||
const mod = await this.beatModsApi.getModByHash(hash);
|
||||
|
||||
if(mod?.contentHashes?.some(content => content.path.includes("IPA.exe"))){
|
||||
return undefined;
|
||||
}
|
||||
|
||||
return mod;
|
||||
|
||||
}
|
||||
|
||||
@@ -57,17 +63,47 @@ export class BsModsManagerService {
|
||||
return [];
|
||||
}
|
||||
|
||||
const ignoreFunc = (file: string, stats: Stats): boolean => {
|
||||
if(!stats.isFile()) { return true; }
|
||||
const ext = path.extname(file);
|
||||
return !(ext === ".dll" || ext === ".exe" || ext === ".manifest");
|
||||
}
|
||||
const files = await recursiveReadDir(modsPath);
|
||||
|
||||
const files = await recursiveReadDir(modsPath, [ignoreFunc]);
|
||||
const hashes = await Promise.all(files.map(file => md5File(file)));
|
||||
const promises = files.map(async filePath => {
|
||||
const ext = path.extname(filePath);
|
||||
|
||||
const mods = await this.getModsFromHashes(hashes);
|
||||
return mods.filter(Boolean);
|
||||
if (ext !== ".dll" && ext !== ".exe" && ext !== ".manifest") {
|
||||
return undefined;
|
||||
}
|
||||
const hash = await md5File(filePath);
|
||||
const mod = await this.getModFromHash(hash);
|
||||
|
||||
if (!mod) {
|
||||
return undefined;
|
||||
}
|
||||
|
||||
if (ext === ".manifest") {
|
||||
this.manifestMatches.push(mod);
|
||||
return undefined;
|
||||
}
|
||||
|
||||
if (filePath.toLowerCase().includes("libs")) {
|
||||
const manifestIndex = this.manifestMatches.findIndex(m => m.id === mod.id);
|
||||
|
||||
if (manifestIndex < 0) {
|
||||
return undefined;
|
||||
}
|
||||
|
||||
this.manifestMatches.splice(manifestIndex, 1);
|
||||
}
|
||||
|
||||
return mod;
|
||||
});
|
||||
|
||||
const results = await Promise.allSettled(promises);
|
||||
|
||||
return results.reduce((mods, mod) => {
|
||||
if (mod?.status === "fulfilled" && mod?.value) {
|
||||
mods.push(mod.value);
|
||||
}
|
||||
return mods;
|
||||
}, [] as BbmModVersion[]);
|
||||
}
|
||||
|
||||
private async getBsipaInstalled(version: BSVersion): Promise<BbmModVersion> {
|
||||
@@ -77,7 +113,7 @@ export class BsModsManagerService {
|
||||
return undefined;
|
||||
}
|
||||
const injectorMd5 = await md5File(injectorPath);
|
||||
return (await this.beatModsApi.getModByHash([injectorMd5]))[injectorMd5];
|
||||
return this.beatModsApi.getModByHash(injectorMd5);
|
||||
}
|
||||
|
||||
private async downloadZip(zipUrl: string): Promise<BsmZipExtractor> {
|
||||
@@ -308,6 +344,8 @@ export class BsModsManagerService {
|
||||
}
|
||||
|
||||
public async getInstalledMods(version: BSVersion): Promise<BbmModVersion[]> {
|
||||
this.manifestMatches = [];
|
||||
|
||||
const bsipa = await this.getBsipaInstalled(version);
|
||||
|
||||
const pluginsMods = await Promise.all([this.getModsInDir(version, ModsInstallFolder.PLUGINS_PENDING), this.getModsInDir(version, ModsInstallFolder.PLUGINS)]);
|
||||
@@ -499,9 +537,11 @@ export class BsModsManagerService {
|
||||
const versionMods = await this.getAvailableMods(version);
|
||||
const installedMods = await this.getInstalledMods(version);
|
||||
|
||||
const fullInstalledMods: BbmFullMod[] = installedMods?.map(version => {
|
||||
return { version, mod: versionMods.find(mod => version.modId === mod.mod.id)?.mod };
|
||||
}) ?? [];
|
||||
const fullInstalledMods = (installedMods || []).reduce((mods, version) => {
|
||||
const mod = versionMods.find(mod => version.modId === mod.mod.id)?.mod;
|
||||
if (mod) { mods.push({ version, mod }); }
|
||||
return mods;
|
||||
}, [] as BbmFullMod[]);
|
||||
|
||||
const progress = { current: 0, total: fullInstalledMods.length };
|
||||
|
||||
|
||||
Reference in New Issue
Block a user