BSML
The essential code framework powering the most complex Beat Saber modifications.
Beat Saber Modding Library (BSML) is a foundational modding framework for the rhythm game Beat Saber, enabling players to inject custom code into the game's runtime environment. Unlike simple content mods that add songs or skins, BSML provides the infrastructure for complex modifications such as new gameplay mechanics, user interface alterations, and enhanced multiplayer features.
- Type
- Modding Framework
- Platform
- PC (Windows)
- Dependency
- Beat Saber
- Primary Function
- Runtime Code Injection
- Status
- Active Development
Lore & Background
This framework has become the backbone for some of the most ambitious projects in the modding scene, allowing for features that were never intended by the original design. It transforms the game from a simple rhythm experience into a sandbox where physics can be altered, new game modes invented, and entirely custom interfaces constructed without breaking the core engine.
In Their Own Story
The neon lights of the virtual arena flicker as the player loads a custom level. Suddenly, the familiar block patterns dissolve into a chaotic storm of shifting colors, a direct result of a BSML script overriding standard physics. The saber hums with a new frequency, reacting not just to hits but to proximity, as the modded code rewrites the rules of engagement in real-time.
Reader's Guide
BSML is developed by the community member known as BepInEx users and specifically tailored for Beat Saber on PC. It relies heavily on the BepInEx plugin loader framework to inject custom assemblies into the game process at startup. The framework does not have an official studio backing it, as it is a third-party tool created outside of Beat Games or Harmony Music. Its reception within the community is overwhelmingly positive, regarded as essential for advanced modding tasks. Because it modifies the game's executable memory, using BSML can potentially lead to instability if conflicting scripts are loaded. It is strictly limited to PC platforms and cannot be used on VR headsets that run the standalone console versions of Beat Saber.
Did You Know?
- BSML allows mods to change how the game calculates scores in real-time.
- The framework enables custom user interfaces that replace the standard menu screens.
- Many complex multiplayer mods rely on BSML for their core functionality.
Frequently Asked Questions
What is BSML?
BSML stands for Beat Saber Modding Library, serving as a foundational framework that allows developers to inject custom code directly into the game's runtime on PC. Unlike simple content mods, it provides the essential infrastructure required to create complex gameplay changes and new features.
How does BSML differ from standard song or skin mods?
While standard mods typically only add new songs or visual skins, BSML enables deep alterations to the game's core mechanics and user interface. It acts as a powerful tool that lets other modifications access and modify the game engine in ways simple content packs cannot.
What are the primary capabilities of the BSML framework?
This library empowers creators to build advanced features such as custom gameplay modes, enhanced multiplayer functionality, and dynamic UI adjustments. By providing direct runtime code injection, it unlocks possibilities far beyond basic asset replacement.
Is BSML still being developed and supported?
Yes, the project remains in active development with ongoing updates to ensure compatibility with new game versions. Its continued maintenance makes it a reliable backbone for the modern Beat Saber modding community on Windows.
Why is BSML considered essential for the Beat Saber legacy?
BSML is crucial because it serves as the underlying engine that powers the most sophisticated and transformative modifications in the game's history. Without this framework, many of the complex custom experiences players enjoy today would simply be impossible to create.
More in Updates & Community Events
Elsewhere in the Beat Saber universe
Spotted an error? Know more?
This is a living reference — every entry is fact-audited, and reader corrections feed straight into our audit queue. Suggest an edit · See this site's audit record
