AutoSaber for Beat Saber (Meta Quest)

Generate Beat Saber maps instantly using AI, directly inside your headset! AutoSaber connects your Quest to a powerful, dynamic cloud AI that "listens" to any YouTube song and hallucinates a fully playable map complete with notes, walls, and lighting.

Web App & Generator: AutoSaber Web Portal

• Current Version: [1.0.0]
• Compatible Beat Saber Version: [1.40.8]

Quick Note

Hey everyone! Welcome to AutoSaber. This project is a small technical experiment aimed at bringing deep-learning map generation natively to the Quest.

Important Disclaimer: The maps generated by this mod are currently raw AI hallucinations. There is no post-processing "constraints engine" yet, which means the AI knows no rules—only rhythm. You may encounter parity breaks, vision blocks, or impossible resets. I highly recommend playing the generated maps on No Fail mode! Play at your own risk, and embrace the chaos.

Features

• In-Headset Generation:
  • Search YouTube directly from the Beat Saber main menu.
  • Select a song, hit "Generate Map", and watch the AI separate the audio stems and build your map.
• Dual Neural Architectures:
  • BAST V2 (Current): Fluid, chaotic, and reactive to vocals and bass drops.
  • RASTER V1: Rigid, structured, safe, reactive to instrumentals.
• Seamless Multiplayer Sync:
  • Play your AI-generated maps with friends!.
• Highly Configurable:
  • Toggle specific map elements on/off (Walls, Bombs, Lighting, Arcs, and Chains).
  • Adjust the Note Jump Speed (NJS) to match your preferred reaction time.

Installation

1. Download the latest AutoSaber.qmod file from the Releases page.
2. Open Mods Before Friday (MBF) and pair your Quest with a USB cable.
3. Select Upload File and choose the downloaded AutoSaber.qmod file.
4. Click Sync to Beat Saber.
5. Launch the game!

How to Use

1. On the Main Menu, look for the new AutoSaber button on the left panel.
2. Click it to open the Generator UI.
3. Use the search bar to find any song on YouTube.
4. Click on a search result to select it.
5. Click GENERATE MAP.
6. Wait for the AI to finish generating the map.
7. Click the Play button next to the song in the queue to jump straight into Solo mode!

Configuration Options

Accessible via the Settings Gear in the AutoSaber menu:

• Engine Version: Switch between BAST V2 and RASTER V1.
• Map Elements:
  • Walls: Generates reactive strobe walls and ceiling/floor barriers.
  • Bombs: Adds bombs to punish missed beats or force resets.
  • Lighting: Enables cinematic, audio-reactive light shows.
  • Chains: Enables burst sliders on high-intensity notes.
  • Arcs: Enables sliders connecting notes.
• Speed Tuning:
  • Note Jump Speed (NJS): Adjust how fast the notes fly at you (Default is 19.3).

Future Plans

• V3 Engine: A more advanced and better AutoSaber AI model.
• Constraints Engine: A post-processing system to automatically detect and fix parity errors, wrist-twisters, and vision blocks to make the AI maps rank-quality.

Credits

• Core Modding Libraries: Immense thanks to the developers of beatsaber-hook, bs-cordl, BSML, config-utils, custom-types, and web-utils.
• AI Models: The backend utilizes modified architectures based on Demucs (Stem Separation) and Microsoft's BEATs (Audio Embeddings).
• AI Assistant: Gemini 3.0 Pro provided extensive development, debugging, and architecture assistance for both the C++ Client and the Python/Next.js Backend.