Outdated tutorial, use the tutorial spoiler below. I will work on an updated vid soon.
Tutorial Vid: https://www.youtube.com/watch?v=xhFmis_Woh8
Tutorial
- Download and extract from the zip
- It will be just one file. Run it and you will be prompt with selecting a map file. Locate your osu Song folder. The path will be very similar to the path at the top of the image but you will have a different username of course.
- Use the search bar to find the song you want. Unfortunately windows will take a minute if you have a ton of maps.
- Choose a pattern and answer the prompts until you choose a bpm and the window auto closes.
- Open the game and locate the map you made. If you can't find it, press F5 and it should find it. If that still didn't work try F5 and "Let's do it!".
- If you're still having trouble, let me know and I will try to help.
4k Patterns
- Chord/Jack
- Jumpstream
- Handstream
- Brackets
- Single streams (you can add in trills too)
7k Patterns
- Chord/Jack
- Brackets
- Layered/single stairs
If you choose to specify the chord distributions, then you will get to choose the percentage that each sized chord will appear. For example, on 4k you can set it to have 50% singles, 30% jumps, 20% hands, and 0% quads.
Jumpstream Map Options
If you choose to specify the percentage of split chords, you will be prompted for a number 0-100. 0 meaning 0% chance of generating a split chord and 100 being only split chords. Split chords are chords with notes in non-neighboring columns. 100% will be more messy where as 0% will be more jack based.
Handstream Map Options
Same as jumpstream options. Some things to note, however:
1) The generation follows this pattern: single, double, single, triple
2) Split chords only refers to doubles in handstream pattern.
3) If you think the doubles are being placed on the same hand too much, try higher percentage for split chords
Bracket Map Options
For 4k you get to choose the missing note percentage. The less missing notes, the more dense it will be. For 7k you get to choose the generator. This is because the algorithm for brackets, in my opinion, isn't as good as the algorithm for layered stairs in terms of bracketness.
Single Stream Map Options
You get to choose if you want trills mixed in. You then get to choose the percentage of trills showing up if you chose to include them.
Layered Stairs Map Options
Imagine a single stair pattern. Now take 1 to 4 stair patterns and stick them on top of each other. I recommend 2 if you want to practice stairs. 3 and 4 just become brackets because of the density.
After that you are given the option to specify a max bpm (charted as quarter notes). This is because things like 8th note jacks on a 200 bpm song are not fun, but if you disagree than you can skip this option. I recommend always setting the max bpm(even if its the same as the songs bpm) but feel free to try things out and see what you like. Also, there is randomness involved in generating maps so running it more than once will produce different results.
WARNING
If you experience a warning that the download or file is not safe to run, don't be alarmed. It's a C++ exe compiled in release mode to keep the file size small and it usually triggers that as a result. The complete project's source code can be found on Github here if you wish to compile it yourself or contribute new features.
6k isn't really supported and hasn't been tested other than chords pattern ¯\_(ツ)_/¯
KNOWN BUGS
- Attempting to load a file with non-ascii (non-english letters) it will crash the program
- If you try to overwrite an existing diff on a map, it will work but leave the star level the same. So you can end up with 10* maps that are truly 3*. You can work around this by deleting a diff first if you really want that diff name or by choosing a custom diff name via the options.
- Although I cannot reproduce it, I have seen a bug where opening a freshly made map in the editor causes lag or even crashing. I have not experienced any lasting negative side effects though so it shouldn't be of any worry. The program only modifies the .osu file you selected and nothing else, so there should not be any harm to your game other than what I have mentioned.
Not a bug but still weird
Jumpstream and handstream maps get really low star ratings imo. This is because it does not generate jump trills which usually inflate a songs star level.
Future Plans
I plan to add more patterns for 7k. It's just kind of tricky to think of a good algorithm hence why I have put it off.
Planned patterns:
Planned patterns:
- Single Streams 7k
- Chordstream 7k
- Possibly better Jacks
- Delay
- Tech 4k, no promises
- Test working with LN
- Hand and jump stream with jump trills mixed in