In-depth tutorial of adding songs to Osu! Mania V3 on Scratch for Windows.

In-depth tutorial of adding songs to Osu! Mania V3 on Scratch for Windows.

-Getting the project ready to import beat maps-

1. In the "map master" sprite, spam-click the code block that has a comment connected to it that says "Use this to delete the last beat map". This is to reduce loading time and because scratch has a maximum size before it won't save. You can check and see if all beat maps are gone by pressing the green flag then pressing osu!, then play, and see if there are any beat maps. If there are, click the code block till you reached the desired amount of beat maps (probably 0)
2. Delete all but the first five backgrounds. Backgrounds are on the right side of the screen when you open the editor. In backgrounds as well, delete all the sounds/songs, but the first and the second when remixing this project. in the original project, delete all the songs but the first and the third.

-Getting the background, the mp3, and the charting ready-

3. Right-click Osu! when it's on your desktop as an application, click properties(on the bottom of the opened list)
4. Click open file location. (it's like the left middle area of the pop-up)
5. Open the songs folder.
6. Search up any 4k songs in the folder, has to be 4k unconverted most likely, I haven't tried it.
6. Open the folder.
7. Take the PNG/JPG, mp3, and the file and copy-paste it onto your downloads. (if you don't copy-paste it you cant play it on Osu!, because Osu! needs the mp3 to play sound and the file to know where the notes go)
8. If you don't have a file to txt auto converter go to a site that does that, I recommend https://document.online-convert.com/convert-to-txt
9. After converting it, find the [Editor] and [Events] and delete the lines under it, but stop when you see an empty line because that's a different section that you most likely shouldn't delete. You can use CTRL + F to search keywords
10. In the [General] section of the TXT, change the AudioFilename to something that's not already an mp3 in the scratch project or keep it, but if you have, for example, freedom dive's mp3 name as "1.mp3", and Oshamba Scramble's mp3 name as "1.mp3" as well, then scratch cant read them and when you play the beat map it won't work.
11. Go to
https://pinetools.com/add-text-each-line
and copy-paste the entire TXT file into the "original text" box. You can highlight all words in the txt file using CTRL + A. Press convert at the bottom of the screen and copy all of the stuff in the "new text" box. The /n at the end is so scratch knows when a new line starts.

-Importing the downloads into scratch-

12. In backgrounds, go to the sounds section and upload the .mp3 file. when it uploads, it will not include the .mp3 at the end usually. Change the name to have a .mp3 at the end (so if you had "1.mp3" and uploaded it to the sounds, it would come out as just "1". add an mp3 at the end, so in this case, it would turn into "1.mp3" again. This is so scratch can read it.
13. Go in the sprites of the backgrounds, and upload the .PNG or .JPG file you have, and resize accordingly. Rename it to the audio file name including the .mp3 at the end. (ex: audio.mp3)
14. In the "Song Button" sprite, go in costumes, scroll all the way down, and copy the last one. In the duplicate, change the song name and difficulty in the costume to whatever, but what's important is the name of the costume. Set the costume name in this fashion: "SONGNAME//DIFFICUTYNAME" where SONGNAME is the name of the song (UnicodeTitle) and DIFFICULTYNAME is the difficulty name, no spaces and "//" required. (ex: Freedom Dive//Another)

15. Connect the code blocks that have the comment that says "Connect this and click the green flag to import a beat map. In the prompt paste all the ".osu" file contents with /n separators" in it. After doing this, press the green flag and it should prompt you with a text box. Paste the really long code in your clipboard with the /n separators at the end into the text box. Don't be confused if you don't see anything, I don't know why that happens. Click the checkmark or press ENTER, and it should have the song ported into scratch. I don't know what black magic this man does but it works. The settings might be bugged and the giant Osu! circle covers all the options IDK why.


Common mistakes and troubleshooting:
-Adding too many songs (this is because scratch has a storage limit for each project you have)
-Changing the audio file name in the scratch project, but not in the txt file. (Ex: changing the audio file in scratch from "1" to "Galaxy Collapse.mp3" but not changing the txt file's AudioFilename.)
-not putting .mp3 at the end of the sound name after importing it into scratch
-not having the background name be the same as the AudioFilename ( ".mp3" included at the end as well)


Tutorial written by KrispyWater