Upgrading to lazer · wiki (2025)

osu!(lazer) is the next major update to the game. It is the culmination of several years of work behind the scenes to painstakingly reimplement the game.

The eventual goal is that this version will be released as an update which will completely supersede the existing stable version of the game, but there's still some work to be done before that is feasible. At the end of the day, the players will dictate when this happens and we will continue to support the previous release until users have migrated across.

"lazer" is a codename and will eventually be dropped as it becomes the primary release of the game. The rest of this document will refer to osu!(lazer) as "lazer" and osu!(stable) as "stable" for simplicity.

Feature comparison

For a list of differences regarding game mechanics, see Gameplay differences in osu!(lazer)

The following is a comprehensive list of the current state of lazer in comparison to stable. Note that this is a moving target — the end goal is to implement all the features that players care about over time.

Compatibility and performance

Featurestablelazer
Windows 8.0 and lowerUpgrading to lazer · wiki (1)Upgrading to lazer · wiki (2)
macOS / LinuxUpgrading to lazer · wiki (3)1Upgrading to lazer · wiki (4)
DirectX / MetalUpgrading to lazer · wiki (5)2Upgrading to lazer · wiki (6)
Mobile supportUpgrading to lazer · wiki (7)Upgrading to lazer · wiki (8)
Multithreaded architectureUpgrading to lazer · wiki (9)Upgrading to lazer · wiki (10)
Hardware-accelerated videoUpgrading to lazer · wiki (11)Upgrading to lazer · wiki (12)
UI scalingUpgrading to lazer · wiki (13)Upgrading to lazer · wiki (14)
Custom rulesets (game modes)Upgrading to lazer · wiki (15)Upgrading to lazer · wiki (16)3
De-duped file storeUpgrading to lazer · wiki (17)Upgrading to lazer · wiki (18)
Tablet area adjustmentUpgrading to lazer · wiki (19)Upgrading to lazer · wiki (20)
Support for many aspect ratiosUpgrading to lazer · wiki (21)Upgrading to lazer · wiki (22)

UI and skinning

Featurestablelazer
Skin supportUpgrading to lazer · wiki (23)Upgrading to lazer · wiki (24)5
Song select grouping modesUpgrading to lazer · wiki (25)Upgrading to lazer · wiki (26)
In-game skin / UI layout editingUpgrading to lazer · wiki (27)Upgrading to lazer · wiki (28)
Dynamic customisable skinning componentsUpgrading to lazer · wiki (29)Upgrading to lazer · wiki (30)

Interface

Featurestablelazer
Storyboards in main menuUpgrading to lazer · wiki (31)Upgrading to lazer · wiki (32)6
Hiding difficultiesUpgrading to lazer · wiki (33)Upgrading to lazer · wiki (34)
First-run setup wizardUpgrading to lazer · wiki (35)Upgrading to lazer · wiki (36)
Soft deletionUpgrading to lazer · wiki (37)Upgrading to lazer · wiki (38)7
Immediate setting changes during gameplayUpgrading to lazer · wiki (39)Upgrading to lazer · wiki (40)

Gameplay

Featurestablelazer
Accurate performance point displayUpgrading to lazer · wiki (41)8Upgrading to lazer · wiki (42)
Difficulty adjustmentUpgrading to lazer · wiki (43)Upgrading to lazer · wiki (44)9
Mod presetsUpgrading to lazer · wiki (45)Upgrading to lazer · wiki (46)
Per-mod settingsUpgrading to lazer · wiki (47)Upgrading to lazer · wiki (48)
New "fun" modsUpgrading to lazer · wiki (49)Upgrading to lazer · wiki (50)
Combo colour normalisation10Upgrading to lazer · wiki (51)Upgrading to lazer · wiki (52)
Hold for HUDUpgrading to lazer · wiki (53)Upgrading to lazer · wiki (54)11
Per-beatmap offset calibrationUpgrading to lazer · wiki (55)12Upgrading to lazer · wiki (56)13
osu! sliders "snake" while draggingUpgrading to lazer · wiki (57)Upgrading to lazer · wiki (58)14
osu! player-friendly "note lock"Upgrading to lazer · wiki (59)Upgrading to lazer · wiki (60)15
osu!mania and osu! timing-based note colouringUpgrading to lazer · wiki (61)Upgrading to lazer · wiki (62)
Replay seekingUpgrading to lazer · wiki (63)Upgrading to lazer · wiki (64)
Niconico-style scrolling replay commentsUpgrading to lazer · wiki (65)Upgrading to lazer · wiki (66)

Online systems

Featurestablelazer
Score submissionUpgrading to lazer · wiki (67)Upgrading to lazer · wiki (68)
Beatmap leaderboardsUpgrading to lazer · wiki (69)Upgrading to lazer · wiki (70)
Profile statisticsUpgrading to lazer · wiki (71)Upgrading to lazer · wiki (72)
MedalsUpgrading to lazer · wiki (73)Upgrading to lazer · wiki (74)16
Performance pointsUpgrading to lazer · wiki (75)Upgrading to lazer · wiki (76)
Real-time chatUpgrading to lazer · wiki (77)17Upgrading to lazer · wiki (78)
Wiki / news / changelog / rankingsUpgrading to lazer · wiki (79)Upgrading to lazer · wiki (80)18
User profilesUpgrading to lazer · wiki (81)Upgrading to lazer · wiki (82)
Beatmap listingUpgrading to lazer · wiki (83)19Upgrading to lazer · wiki (84)
Unlimited multiplayer room sizeUpgrading to lazer · wiki (85)20Upgrading to lazer · wiki (86)
Multiplayer spectatingUpgrading to lazer · wiki (87)Upgrading to lazer · wiki (88)
Countdown timersUpgrading to lazer · wiki (89)21Upgrading to lazer · wiki (90)22
Queue modesUpgrading to lazer · wiki (91)Upgrading to lazer · wiki (92)23
Multiplayer commandsUpgrading to lazer · wiki (93)Upgrading to lazer · wiki (94)
Tag co-opUpgrading to lazer · wiki (95)Upgrading to lazer · wiki (96)
Playlists (user-curated leaderboards)Upgrading to lazer · wiki (97)Upgrading to lazer · wiki (98)
Updating beatmaps with online changesUpgrading to lazer · wiki (99)24Upgrading to lazer · wiki (100)25

Editor

Featurestablelazer
osu! editorUpgrading to lazer · wiki (101)Upgrading to lazer · wiki (102)
osu!taiko editorUpgrading to lazer · wiki (103)Upgrading to lazer · wiki (104)
osu!catch editorUpgrading to lazer · wiki (105)Upgrading to lazer · wiki (106)
osu!mania editorUpgrading to lazer · wiki (107)Upgrading to lazer · wiki (108)
Open difficulty as referenceUpgrading to lazer · wiki (109)Upgrading to lazer · wiki (110)
Per-object SV / volumeUpgrading to lazer · wiki (111)Upgrading to lazer · wiki (112)
Per-segment slider curve typesUpgrading to lazer · wiki (113)Upgrading to lazer · wiki (114)
Slider splitting and mergingUpgrading to lazer · wiki (115)Upgrading to lazer · wiki (116)
Pattern rotationUpgrading to lazer · wiki (117)Upgrading to lazer · wiki (118)
Pattern resizingUpgrading to lazer · wiki (119)Upgrading to lazer · wiki (120)
Beatmap submissionUpgrading to lazer · wiki (121)Upgrading to lazer · wiki (122)
Storyboard editorUpgrading to lazer · wiki (123)Upgrading to lazer · wiki (124)
Cross-compatibilityUpgrading to lazer · wiki (125)Upgrading to lazer · wiki (126)26

Switching to lazer

So you've decided you want to give lazer a shot? Great!

You can find it for download here. In the near future, you will be able to switch to lazer from stable (from the Release stream setting).

FAQ

Migration

Is stable going away? Am I going to be forced to switch?

Stable will continue to be maintained as long as users are using it. At very least, it will be maintained for several years.

Can I import all my data from stable to lazer?

Currently, beatmaps, skins, scores, replays and collections can be imported into lazer. Of note, settings are not yet imported so you will need to set them up from scratch.

If I import my beatmaps to lazer, will it use double the disk space?

If you have both lazer and stable on the same drive, hard links are used to avoid using extra disk space.

In all other cases, importing beatmaps will use double the disk space.

If I delete lazer will it break my stable install?

No.

If I delete stable will it break content in lazer that was imported from stable?

No.

If I install lazer, will I be able to return to stable?

Yes, lazer always installs alongside stable. Unless you choose to delete one or the other, both will be accessible.

Can I import data from lazer to stable?

No. This will not be supported.

That said, individual scores and beatmaps can be exported from lazer and manually imported into stable for now.

Gameplay and scoring

If I set a score on lazer, will it show on my profile?

Yes, but it won't show in "best performance" with "lazer mode" turned off on the website.

It additionally not show in "first place ranks" regardless for now.

If I set a score on lazer, will it give performance points?

Yes.

Does lazer use ScoreV2?

It uses a scoring system based on it with some adjustments.

I prefer the classic scoring display, where scores get really big.

You can actually change the Score display mode setting to Classic to get back the explosive style of scoring game-wide! It won't be a perfect match, but will give you the same feel of classic scoring and be applied everywhere you'd expect it to be.

Global score leaderboards will also use classic scoring.

If I set a score on lazer, will it remain forever?

While we will try to preserve as many scores as possible, we offer no guarantee that scores will remain indefinitely. At any point we may choose to wipe a subset of scores in order to preserve game balance, such as when exploits or foul play are discovered.

Will scores set on stable show in lazer?

Yes.

Will scores set in lazer show in stable?

Not at the moment.

Will all mods be ranked?

Scores of all mod combinations appear on leaderboards.

However, only the following mods will award performance points for now:

  • Difficulty reduction

    • Easy

    • No Fail

    • Half Time (only 0.75x, configuring Adjust pitch is allowed)

    • Daycore (only 0.75x)

  • Difficulty Increase

    • Hard Rock (not for osu!mania)

    • Sudden Death (Configuring Restart on fail is allowed)

    • Perfect (Configuring Restart on fail is allowed)

    • Hidden

    • Nightcore (only 1.5x)

    • Double Time (only 1.5x, configuring Adjust pitch is allowed)

    • Flashlight

    • Blinds

    • Accuracy Challenge

  • Conversion (osu!mania only)

    • Mirror

    • Four Keys

    • Five Keys

    • Six Keys

    • Seven Keys

    • Eight Keys

    • Nine Keys

  • Fun

    • Muted

    • No Scope

  • Automation (osu! only)

    • Spun out

  • System

    • Touch Device

Only the default configuration of customisation options is eligible for performance points, unless otherwise noted above.

I don't like the new gameplay mechanics. Can I restore the old gameplay mechanics like on stable?

Please try applying the "Classic" mod, which will restore much of the old behaviour that you are used to. Also make sure to check the settings offered by the Classic mod, as it will let you further customise your experience and also understand what changes are being applied (as they are all listed there).

Skinning and UI

Something is behaving differently to stable and I don't like it!

Please run the setup wizard at the top of settings and go through the settings on the Behaviour screen. A lot of the common settings which have defaults changed are listed here. There's also a single button you can press to apply the old behaviours as a starting point for your lazer journey.

Will old skins eventually work in song select and results screens?

We'll do our best to bring back as much of this as we can without blocking new functionality. This will come later on.

Can I use my skin cursor in the menus as well?

We will likely bring back support for this in the future due to popular demand.

Performance

Why can't I run at unlimited FPS?

Above a certain threshold there is no reason to run at higher frame rates. Lazer employs various new technologies to ensure the lowest latency is achievable without requiring high frame rates. This will continue to improve going forward as we still have a few improvements left to implement.

Lazer polls for input at 1,000 Hz regardless of FPS limiter, which is why the maximum limiter setting will also limit to 1,000 FPS.

If you are curious about how this affects input latency and test your own perception, please run the built-in "latency certifier" at the bottom of settings.

You can also read this technical document explaining the path we are taking along with rationale behind it.

If input is only polled at 1,000 Hz, what about my 8,000 Hz gaming mouse?

The operating system will still poll at the higher rate, although benefits are proven to be negligible. Polling at such high rates can have unforeseen overheads, and we recommend limiting devices to 1,000 Hz for system stability.

Lazer performs worse than stable for me. What gives?

While on most modern hardware we see lazer outperform stable, there are always edge cases when each user has a different hardware configuration. In our short-term roadmap, we are looking to support DirectX (aka "compatibility mode" on stable) and Vulkan, which both have better driver support than OpenGL across all hardware. Once this is implemented, performance on hardware like Intel integrated chipsets will improve greatly.

Providing feedback

A feature that I depend on is missing! / Something has changed and I don't like it. / I have found a bug, what's the best way to report it?

There's a very high chance we are already aware of this and tracking it for future implementation! Please search the issue tracker and discussions page. If you can't find any matching threads, feel free to open a discussion.

Do note that we are already tracking over 1,000 issues of varying priorities, and it may take us some time to fix issues that only affect a small number of users.

Other

Why is it called "lazer"?

What is sharper than cutting-edge?

Why is it taking so long to become the "main" release?

While osu! may seem like a simple game, there are hundreds on hundreds of features and systems that users have come to rely on. Depending on who you ask, lazer may have been in a fully playable state for years now, or it may be missing countless features.

Another area which has taken a huge amount of effort is historical preservation — making sure that beatmaps behave exactly as they should, including edge cases that weren't originally planned for. osu! is a vibrant ecosystem and users have taken liberty to extend the game far beyond its planned extents, and we are trying our best to embrace and support this going forward.

Finally, unlike the last iteration, we are putting in the time and diligence to ensure the code base will serve us well into the future. We have done the groundwork to allow new features to come online at blazing speed going forward. This will include new UI components, new ways to skin the game, new multiplayer systems and let's not forget the ability to load and play all your existing beatmaps on completely new game modes (a.k.a. rulesets)!

What comes next?

We have a huge backlog of user-requested features and improvements that we will continue to push out at the speed of light. For those that have joined us recently and haven't experienced the momentum of osu! development, prepare to be in for a surprise.

How do I access my songs folder?

There is no songs folder in lazer! This allows us to do cool things like not require pressing F5 at song select to refresh beatmaps (because beatmaps are always in a good state) and reduce the disk space used by beatmaps by 20–40%. You can read more about the way lazer stores files.

If you need to make changes to a beatmap, please use the editor. Going forward we will introduce a mode in the editor which makes a beatmap's folder temporarily accessible for external editing. This will allow you to use external tools on a beatmap during the creation process.

Now that "osu!direct" is available to all players, will supporters have any new benefits?

Some filters in the beatmap listing are still supporter-only.

There are also some additional benefits already:

  • Supporters can create playlists that last longer.

  • Supporters can enable storyboards to play in the main menu.

We do intend to look into new benefits in the future, but our focus is currently on feature parity with stable so please use your supporter tag purchase as a way to... support the game's development!

If I cheat on lazer will I be banned?

Yes.

If I find someone cheating on lazer how should I report them?

The same way you usually would.

Where are the microtransactions?

You're likely thinking of another game.

Notes

  1. Using Wine.

  2. DirectX via compatibility mode.

  3. Manually via .dll files.

  4. Gameplay only.

  5. osu!supporter-only.

  6. Restore deleted beatmaps and other data from the settings. Deletions only become permanent upon restart.

  7. Via online retrieval.

  8. Change CS/AR/OD/HP of a beatmap directly from song select via the Difficulty Adjust mod.

  9. This brings beatmap custom combo colours to the same brightness level.

  10. Hold Ctrl to view the HUD momentarily while it's hidden.

  11. Adjustable manually via key bindings.

  12. When retrying a beatmap, you can calibrate the offset based on your last play.

  13. Can be disabled.

  14. Still exists, but should not interfere.

  15. Some Hush-Hush medals are not yet obtainable.

  16. Messages can take up to 15 seconds to arrive.

  17. Native access to most online content.

  18. Via osu!direct, osu!supporter-only.

  19. 16 players max.

  20. Set a countdown using a command, no automatic start.

  21. Set a countdown from the game UI to automatically start the match.

  22. Turn on to allow anyone in a lobby to queue new beatmaps, a.k.a. "host rotate".

  23. Map only.

  24. All files.

  25. Some editor features will cause beatmaps to play incorrectly in stable — will be fixed soon.

Upgrading to lazer · wiki (2025)
Top Articles
Latest Posts
Recommended Articles
Article information

Author: Edmund Hettinger DC

Last Updated:

Views: 6281

Rating: 4.8 / 5 (78 voted)

Reviews: 93% of readers found this page helpful

Author information

Name: Edmund Hettinger DC

Birthday: 1994-08-17

Address: 2033 Gerhold Pine, Port Jocelyn, VA 12101-5654

Phone: +8524399971620

Job: Central Manufacturing Supervisor

Hobby: Jogging, Metalworking, Tai chi, Shopping, Puzzles, Rock climbing, Crocheting

Introduction: My name is Edmund Hettinger DC, I am a adventurous, colorful, gifted, determined, precious, open, colorful person who loves writing and wants to share my knowledge and understanding with you.