Server emulator for Stella Sora
  • Zig 99.3%
  • PowerShell 0.4%
  • Shell 0.3%
Find a file
2026-09-29 18:59:15 +02:00
assets Update server for 1.13.0.139 2026-09-29 17:15:35 +02:00
build Update server for 1.13.0.139 2026-09-29 17:15:35 +02: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 Update server for 1.13.0.139 2026-09-29 17:15:35 +02:00
scripts all: init 2026-08-21 18:52:54 +02:00
servers fix(game): decouple saves from asset sizes 2026-09-29 18:59:15 +02:00
tools Update server for 1.13.0.137 2026-09-24 17:34:46 +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 Update server for 1.13.0.137 2026-09-24 17:34:46 +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 Update server for 1.13.0.139 2026-09-29 17:15:35 +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.139

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.

Getting started

The client needs Asterism (client patch) before it can connect to Astralis. Once you have that, choose whichever setup method suits you:

  • Prebuilt executables if you want to download and run the server directly.
  • Automatic setup if you want the scripts to clone the repository and prepare Zig for you.
  • Manual setup if you prefer to install the requirements and build it yourself.

After setup, run both server executables (or start both servers through the provided scripts), then launch the patched client.

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.

Daily and weekly missions

  • Daily and weekly mission lists, scheduled resets, and individual or bulk reward claims.
  • Progress for login, Ascension entry/completion and battles, character and Disc level-ups, and the daily shop reward.
  • Daily and weekly activity rewards.

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 missions use the observed 10 fixed entries plus 2 rotating entries. The official selection formula is unknown, so the exact pair sequence may differ.
  • Some daily and weekly missions are tied to systems or activities that are not implemented (at least yet), so those missions will not progress for now.
  • 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 run both server executables 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.