SSuRGents Test Server

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.


Notice regarding official Sonolus release (1.x.x)

This engine is based on an old version of Sonolus (0.6.x) and will not work with newer versions, including the official release on App Store/Google Play.

If you see a message saying that the engine is not compatible, you probably installed/updated to a newer incompatible version. To play ssurgents, the current workaround is to avoid updating for now, or see the How to play section for the v0.6.x download link.

The official Sonolus requires a new engine that (realistically) might not be available for a while, but the author hopes to have the time someday to complete.


Contents


Objectives

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:


How to play

Step 1: Get the Sonolus app (version 0.6.x)

Currently, the engine will only work on version 0.6.x of the app (NOT v0.7.x to the official v1.x.x), so be sure to download the correct version below.

With the official release, the Sonolus website no longer provides sideloading instructions, but you may be able to find instructions elsewhere for sideloading the old version of the app onto your device.

Step 2: Add custom server

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.

Step 3: Choose level and play

Select the desired custom server and choose from the list of levels available.


Known Issues

  1. 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).

  2. 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
    
  3. 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

  4. 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.


Tentative Roadmap

Phase 1: SSRG-compatible level trainer

Engine

Aesthetics

Levels

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.

Services

Phase 2: Community-made custom levels

Engine

Aesthetics

Levels

Services

Phase 3: Level Generator?

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.

Levels

Services


FAQ

  1. 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.

  2. 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.

  3. 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.


Bugs

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.


Supporting the project

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!


Special thanks to