surgent: (adjective) rising in a surge
SSuRGents is a work in progress that hopes to be a 3rd-party clone/extension of the engine in SuperStar Rhythm Games (SSRG). It runs on the existing Sonolus app, a generic rhythm game app already used for other engines like Bandori and Project Sekai clones. (See Bestdori and SweetPotato for communities based around those engines.) The Sonolus app gives SSuRGents some nice features for free, like offline play and customizations.
This test server currently contains levels from
More can be added in the future.
If you see a message saying that the engine is not compatible, you probably installed/updated to version 0.7.x or 0.8.x of the Sonolus app. The engine currently needs version 0.6.x to work. If you mainly play ssurgents, please hold off from updating for now, or see the How to play section for the v0.6.x download link.
Work on a new v0.8.x compatible engine is still in progress, and updates will be posted here.
Neither the SSuRGents engine nor the Sonolus app has any concept of theme cards or storing score records. This project is NOT intended to replace the full experience of the original SuperStar rhythm games.
Instead, this project is intended to be enjoyed solely for the rhythm gameplay itself, and (in the future) as a space for creative extensions of the gameplay. It hopes to provide a way to play any song and any beatmap, free from the following:
Since the app is still in beta, it is not yet available from the usual app stores. Currently, the engine will only work on version 0.6.x of the app (NOT v0.7.x or v0.8.x), so be sure to download the correct version below.
Visit the Sonolus website for sideloading instructions. iOS users, do NOT join the beta on TestFlight at this time, because that is for the newest version v0.8.0 which doesn't work with the current engine.
Add the following as custom servers in the sonolus app. If you already have Sonolus installed, clicking the link will go directly to the page in the app.
Select the desired custom server and choose from the list of levels available.
Specific values for timing ranges/hitbox sizes might need further tuning to match SSRG exactly. Please file a bug report if you feel a mismatch (currently beyond my ability to tell if there is a difference).
Certain elements of UI do not match SSRG for now, as it will take time to work around some limitations of Sonolus to implement them.
- Sonolus' default Perfect/Great/Good judgments instead of SPerfect/Perfect/Good
- Combo is broken on Good
- Scores/Rave not ready
Search functionality in the level listing does not work in this static test server, but will work once we move to dedicated hosting in the future
Judgment of slider start notes are delayed until the end of the entire slider. This is a workaround to allow the engine to deduct health at the exact time of a "miss" anytime along the slider.
If you would like to play songs from a certain group, please do let me know by submitting a feature request. (See the Bugs section) I want to be sure that there is support from the respective fandom before making it available.
Intended for newly released or less well-known music, until human chart-makers get to it. Human-made beatmaps are still better in general, but generated beatmaps could be useful as a base to start on.
Q: Can you fix this issue with the Sonolus app?
A: I am not the developer of the Sonolus app, but you can ask for help with Sonolus in the help-and-support channel of their discord.
Q: When will you add levels from the SuperStar XXX app or from XXX group?
A: I can't commit to a timeframe, but will try to consider requests from the community.
Q: My timing seems to be significantly off compared to my performance in the SuperStar apps. How do I calibrate my touch timing?
A: If you scroll down the results page after playing a level, you can see a few graphs showing your touch offsets. Peaks left of center means tapping too early, and right of center means too late. To calibrate, try setting the Engine Input Offset at the bottom of the level configuration page to how far your graph peaks are from the center.
For now, all bugs will be tracked on github, so first check if it is already listed there. You may also report bugs through this google form.
Everything made in this project will always be available for free, I do this only because I can't bear to see people deprived of playing their favorite songs.
This project would not be possible at all without the Sonolus app, so please consider supporting its development as well.
If you like this project, please help share it with other players that will like it too!