Server emulator for Stella Sora
  • Zig 99.1%
  • PowerShell 0.5%
  • Shell 0.3%
Find a file
2026-08-29 11:13:44 +02:00
assets feat: implt shop 2026-08-29 01:22:02 -04:00
build feat: implt shop 2026-08-29 01:22:02 -04:00
common/src refactor: general code improvements 2026-08-24 20:13:31 +02:00
docs feat(game): complete centralized progression tracking 2026-08-26 23:55:13 +02:00
generated feat: implt shop 2026-08-29 01:22:02 -04:00
scripts all: init 2026-08-21 18:52:54 +02:00
servers fix(game): refine Ascension state and progression 2026-08-29 11:13:44 +02:00
tools all: init 2026-08-21 18:52:54 +02:00
.gitattributes all: init 2026-08-21 18:52:54 +02:00
.gitignore all: init 2026-08-21 18:52:54 +02:00
build.zig all: init 2026-08-21 18:52:54 +02:00
build.zig.zon all: init 2026-08-21 18:52:54 +02:00
LICENSE all: init 2026-08-21 18:52:54 +02:00
README.md fix(game): refine Ascension state and progression 2026-08-29 11:13:44 +02:00

Astralis

Server emulator for Stella Sora.

This project is not affiliated with the game's developers or publisher.

Contents

Compatibility

Current supported client version: 1.13.0.131

The server is tested against the version above. Game updates may take time to receive compatible resources or protocol changes, and the repository is not guaranteed to support the latest client version.

What works

Astralis currently focuses on Recruitment and Ascension.

Recruitment

  • Newbie and regular gacha banners, including pulls, costs, rewards, guarantees, and collection progress.

Character progression

  • Leveling, skill upgrades, talents.

Ascension

  • Starting, resuming, leaving, and completing runs.
  • Combat rooms, events, recovery rooms, shops, Potentials, Musical Notes, Harmony Skills, and the Enhancement Machine.
  • Journey Tickets, first-clear and give-up rewards, NPC affinity, and Ascension records.
  • Record saving, dismantling, locking, naming, and preferences.
  • Monolith Research upgrades, plus Research Project quests and rewards for supported Ascension actions.

Still in progress

Some parts are not complete yet, or may still differ from the official server:

  • A few advanced Monolith Research effects and unusual Ascension events need more refinement.
  • Fate Cards and Cataclysm Survivor are not implemented yet.
  • Daily and weekly missions are listed and reset on schedule, but their gameplay progress and rewards are not implemented yet.
  • Character emblems are not implemented yet.

Client patch

You will need Asterism. It makes the game request from your local server instead of the official server.

Prebuilt executables

Prebuilt binaries are available from the release page, extract the compressed file anywhere, then start both servers from the extracted folder.

Automatic setup

The installer downloads Astralis and prepares the right Zig version for you. On Windows, open PowerShell and run:

irm https://git.xeondev.com/nyan/astralis/raw/branch/main/scripts/install.ps1 | iex

On Linux, run:

curl -fsSL https://git.xeondev.com/nyan/astralis/raw/branch/main/scripts/install.sh | sh

Windows can install Git automatically. On Linux, the installer will tell you which tools are missing so you can install them with your distribution's package manager. If Zig is missing or has the wrong version, the installer can set it up through zvm.

Once installation finishes, Windows users can double-click scripts/start.cmd. On Linux, run sh scripts/start.sh.

Use scripts/update.cmd on Windows or sh scripts/update.sh on Linux to update Astralis. The updater will preserve customized server configs when they can be merged safely, and will never discard other local changes.

Manual setup

You will need Git and Zig 0.16.0. Clone the repository and enter its directory:

git clone --depth=1 https://git.xeondev.com/nyan/astralis.git
cd astralis

Build the servers with:

zig build -Doptimize=ReleaseSafe

Or start both servers with:

zig build -Doptimize=ReleaseSafe serve-all

By default, the SDK server listens on 127.0.0.1:20001 and the game server listens on 127.0.0.1:20002. Press Ctrl+C to stop both services.

The servers can also be run separately:

zig build -Doptimize=ReleaseSafe run-sdk-server
zig build -Doptimize=ReleaseSafe run-game-server

The shared local addresses used by both servers can be overridden from the command line. For example:

zig build -Doptimize=ReleaseSafe serve-all -- --sdk-server-address 127.0.0.1:21001 --game-server-address 127.0.0.1:21002

For separate listen and advertised addresses, run the servers separately.

The same settings can be changed permanently in servers/sdk/config.zon and servers/game/config.zon.

Player data is stored in the store folder.

Technical documentation

Developers who want to understand how the server works can start with the technical documentation index.

Bug reports

Please report bugs in the issue tracker. Include steps to reproduce the problem, what you expected to happen, what happened instead, and the relevant server or client logs (if any). Mention the Astralis and Asterism version or commit you are using.

You can also report issues in the Reversed Rooms Discord server.

Contributing

Focused pull requests are welcome. For larger features or changes to core protocol or gameplay behavior, open an issue first so the approach can be discussed before you spend time implementing it.

If you don't have an account you can submit patches in the Discord server.

License

This repository was made public in the hopes that it will be useful. However, it comes with no warranty whatsoever (expressed or implied). It's licensed under GNU Affero General Public License v3.