McOsu NX Switch: Difference between revisions

McOsu NX
McOsu NX
General
Author	McKay42
Type	Music
Version	33.00
License	GPL-3.0
Last Updated	2022/01/23
Links
	Download
	Website
	Source

Latest revision as of 07:50, 22 Mayıs 2023

An unofficial open-source client for osu! beatmaps, with the main focus on making practicing easier and customizing gameplay.

Runs on McEngine. The game code and Desktop version is available here.

Installation

How to install:

Extract the zip file, then merge the contents with your microSD card (do not change any folder/file structures/names).
If you are upgrading from an existing version, just overwrite everything except your cfg and Songs folder.
Launch HBL via takeover or HBL via the NSP version (to get full RAM access, which this game requires), and start McOsu.

Notes:

The game will give you a warning on the main menu if it doesn't have access to enough memory (< 1 GB).
If you launch HBL via the Album applet, then only ~400 MB out of 4 GB are available, and some of that is already used up (at least during testing, this might not even be a problem anymore with newer Atmosphere/ReiNX/etc. versions).

User guide

Adding beatmaps/skins

You don't have to create any folder structures, everything is already prepared.

Follow the guide on extracting beatmaps/skins below, and simply put them into /switch/McOsu/Songs/ or /switch/McOsu/Skins/ on your microSD card. Default beatmaps are already included, so just follow their structure.

Troubleshoot/Notes

If you get audio crackling after minimizing the game or going into sleep mode: To fix it, Go to Options > Audio > "Restart SoundEngine (fix crackling)".
If you are playing beatmaps with a lot of sliders visible at the same time, and consistently getting less than 60 fps, improve performance by enabling Options > Skin > "Use slidergradient.png".
If you get stuck at 0% loading forever, then the resource loader thread could not be created. Try restarting the game, HBL, and your system, in that order. This has only happened to me once, so it shouldn't be a problem.
All speed changing mods are unavailable (DT/HT/DC/NC, Speed/BPM Multiplier, Timewarp) because the audio library does not support varying playback speed (yet).

Controls

Screenshots

Media

McOsu on Nintendo Switch [Release] (McKay)

Compatibility

This was only tested on Firmware 5.1, with a pretty old SD setup and RajNX (which is no longer maintained).

Changelog

v33.00

Non switch-specific changes from version 33: https://steamcommunity.com/games/607260/announcements/detail/3128313422581495579

v31.08

Non switch-specific changes: https://steamcommunity.com/games/607260/announcements/detail/1691601090541194677

v29.31

Recompiled with libnx v3.0.0 (to support input without hid-mitm).

v29.3

Keyboard/Mouse support, with some limitations:
- Text typing is not supported, only raw keys/hotkeys/gameplay work.
- Mouse sensitivity can only be set to ≥ 1.0, use DPI settings of your mouse if you want to go lower.
Improved touch handling slightly.
Non switch-specific changes.

Credits

Skin Credits:

ffffffffffffffffff - "- Jaret - Mish Mosh".
irrlux - "Talrava XIV".
HazrdMC - "Phaze".
Redon - "Aesthetic 1.3".
DarkSlayer000 - "xXx_SampleSkin_xXx v1.3".
Inori - "Stepmania".
taikuta - "Murakumo".
Easy - "Burning_Crow V2".
Icomoon.
Freepik.

External links

GitHub - https://github.com/McKay42/McOsu-NX
ForTheUsers - https://apps.fortheusers.org/switch/McOsu-NX

@@ Line 1: / Line 1: @@
 {{Infobox Switch Homebrews
 |title=McOsu NX
-|image=mcosunxswitch.png
+|image=mcosunx.png
 |description=Custom unofficial osu! practice client (Nintendo Switch port).
 |author=McKay42
 |lastupdated=2022/01/23
 |type=Music
-|version=33
+|version=33.00
 |license=GPL-3.0
-|download=https://dlhb.gamebrew.org/switchhomebrews/mcosunxswitch.7z
+|download=https://dlhb.gamebrew.org/switchhomebrews/mcosunx.7z
 |website=https://github.com/McKay42/McOsu-NX
 |source=https://github.com/McKay42/McOsu-NX
 |donation=
 }}
-{{#seo:
+An unofficial open-source client for [https://osu.ppy.sh/ osu!] beatmaps, with the main focus on making practicing easier and customizing gameplay.
-|title=Switch Homebrew Games (Music) - GameBrew
-|title_mode=append
+Runs on McEngine. The game code and Desktop version is available [https://github.com/McKay42/McOsu/ here].
-|image=mcosunxswitch.png
-|image_alt=McOsu NX
+==Installation==
-}}
+How to install:
-{{cleanup|article|Needs cleanup}}
+*Extract the zip file, then merge the contents with your microSD card (do not change any folder/file structures/names).
-Custom unofficial osu! practice client (Nintendo Switch port).
+*If you are upgrading from an existing version, just overwrite everything except your <code>cfg</code> and <code>Songs</code> folder.
+*Launch [https://nh-server.github.io/switch-guide/user_guide/sysnand/launching_cfw/#launching-the-homebrew-menu HBL via takeover] or [[Homebrew_Menu_Loader_Switch|HBL via the NSP version]] (to get full RAM access, which this game requires), and start McOsu.
+Notes:
+*The game will give you a warning on the main menu if it doesn't have access to enough memory (< 1 GB).
+*If you launch HBL via the Album applet, then only ~400 MB out of 4 GB are available, and some of that is already used up (at least during testing, this might not even be a problem anymore with newer Atmosphere/ReiNX/etc. versions).
+==User guide==
+===Adding beatmaps/skins===
+You don't have to create any folder structures, everything is already prepared.
+Follow the guide on extracting beatmaps/skins below, and simply put them into <code>/switch/McOsu/Songs/</code> or <code>/switch/McOsu/Skins/</code> on your microSD card. Default beatmaps are already included, so just follow their structure.
+*[https://steamcommunity.com/sharedfiles/filedetails/?id=880768265 How to add beatmaps/skins]
+*[https://steamcommunity.com/app/607260/discussions/0/1620599015885400990/ McOsu FAQ]
-==Media==
+===Troubleshoot/Notes===
-<youtube></youtube>
+*If you get audio crackling after minimizing the game or going into sleep mode: To fix it, Go to Options > Audio > "Restart SoundEngine (fix crackling)".
+*If you are playing beatmaps with a lot of sliders visible at the same time, and consistently getting less than 60 fps, improve performance by enabling Options > Skin > "Use slidergradient.png".
+*If you get stuck at 0% loading forever, then the resource loader thread could not be created. Try restarting the game, HBL, and your system, in that order. This has only happened to me once, so it shouldn't be a problem.
+*All speed changing mods are unavailable (DT/HT/DC/NC, Speed/BPM Multiplier, Timewarp) because the audio library does not support varying playback speed (yet).
+==Controls==
+{| style="width: 80%; margin-left:0em;"
+|
+https://dlhb.gamebrew.org/switchhomebrews/mcosunx6.png
+|}
 ==Screenshots==
-https://dlhb.gamebrew.org/switchhomebrews/mcosunxswitch-01.png
+https://dlhb.gamebrew.org/switchhomebrews/mcosunx2.png
-https://dlhb.gamebrew.org/switchhomebrews/mcosunxswitch-02.png
+https://dlhb.gamebrew.org/switchhomebrews/mcosunx3.png
-https://dlhb.gamebrew.org/switchhomebrews/mcosunxswitch-03.png
-https://dlhb.gamebrew.org/switchhomebrews/mcosunxswitch-04.png
+https://dlhb.gamebrew.org/switchhomebrews/mcosunx4.png
-https://dlhb.gamebrew.org/switchhomebrews/mcosunxswitch-05.png
+https://dlhb.gamebrew.org/switchhomebrews/mcosunx5.png
-https://dlhb.gamebrew.org/switchhomebrews/mcosunxswitch-06.png
-https://dlhb.gamebrew.org/switchhomebrews/mcosunxswitch-07.png
+==Media==
-https://dlhb.gamebrew.org/switchhomebrews/mcosunxswitch-08.png
+'''McOsu on Nintendo Switch [Release]''' ([https://www.youtube.com/watch?v=gYIwxIA2RGA McKay]) <br>
+<youtube>gYIwxIA2RGA</youtube>
+==Compatibility==
+This was only tested on Firmware 5.1, with a pretty old SD setup and RajNX (which is no longer maintained).
 ==Changelog==
-'''v.1.0'''
+'''v33.00'''
-* First Release.
+*Non switch-specific changes from version 33: https://steamcommunity.com/games/607260/announcements/detail/3128313422581495579
+'''v31.08'''
+*Non switch-specific changes: https://steamcommunity.com/games/607260/announcements/detail/1691601090541194677
+'''v29.31'''
+*Recompiled with libnx v3.0.0 (to support input without hid-mitm).
+'''v29.3'''
+*Keyboard/Mouse support, with some limitations:
+**Text typing is not supported, only raw keys/hotkeys/gameplay work.
+**Mouse sensitivity can only be set to ≥ 1.0, use DPI settings of your mouse if you want to go lower.
+*Improved touch handling slightly.
+*Non switch-specific changes.
+==Credits==
+Skin Credits:
+*ffffffffffffffffff - "- Jaret - Mish Mosh".
+*irrlux - "Talrava XIV".
+*HazrdMC - "Phaze".
+*Redon - "Aesthetic 1.3".
+*DarkSlayer000 - "xXx_SampleSkin_xXx v1.3".
+*Inori - "Stepmania".
+*taikuta - "Murakumo".
+*Easy - "Burning_Crow V2".
+*Icomoon.
+*Freepik.
 == External links ==
-* Gbatemp - https://github.com/McKay42/McOsu-NX
+* GitHub - https://github.com/McKay42/McOsu-NX
-* Github - https://github.com/McKay42/McOsu-NX
+* ForTheUsers - https://apps.fortheusers.org/switch/McOsu-NX
-* Reddit -