yidhari-zs/Yidhari-ZS
1
Fork 0
Code Issues Pull requests Releases 2 Activity Actions
Zenless Zone Zero Server Emulator
6 commits 1 branch 2 tags 8.1 MiB
Find a file
Exact
xeon bbcd8c12ef feat(scene): implement proper initialization of 'Fight' scene 
currently only for training scene
2025-09-03 02:19:19 +03:00
.forgejo/workflows feat: setup CI workflow 2025-09-01 01:48:20 +03:00
assets feat(scene): implement proper initialization of 'Fight' scene 2025-09-03 02:19:19 +03:00
common/src Hi 2025-08-30 04:32:45 +03:00
dispatch-server Hi 2025-08-30 04:32:45 +03:00
game-server feat(scene): implement proper initialization of 'Fight' scene 2025-09-03 02:19:19 +03:00
protocol feat(protobuf): introduce namespaced mixin for messages, codegen: introduce default value for lists 2025-09-02 03:15:29 +03:00
.envrc Hi 2025-08-30 04:32:45 +03:00
.gitignore Hi 2025-08-30 04:32:45 +03:00
build.zig Hi 2025-08-30 04:32:45 +03:00
build.zig.zon Hi 2025-08-30 04:32:45 +03:00
flake.lock feat: setup CI workflow 2025-09-01 01:48:20 +03:00
flake.nix feat: setup CI workflow 2025-09-01 01:48:20 +03:00
LICENSE Hi 2025-08-30 04:32:45 +03:00
README.md readme: update client patch link 2025-08-31 18:01:28 +03:00

README.md

Yidhari-ZS

Server emulator for the game Zenless Zone Zero

title

Features

  • Walking
  • World Map
  • VR Training
  • Shiyu Defense and Deadly Assault
  • Miscellaneous items (Skins, W-Engines, Drive Discs, Wallpapers)

Getting started

Requirements

NOTE: this server doesn't include the sdk server as it's not specific per game. You can use hoyo-sdk with this server.

For additional help, you can join our discord server

Setup

a) building from sources

git clone https://git.xeondev.com/yidhari-zs/yidhari-zs.git
cd yidhari-zs
zig build run-yidhari-dispatch
zig build run-yidhari-gameserver

b) using pre-built binaries

Navigate to the Releases page and download the latest release for your platform. Start each service in order from option a).

Configuration

Configuration is loaded from current working directory. If no configuration file exists, default one will be created.

  • To change server settings (such as bind address), edit dispatch_config.zon (for dispatch) and gameserver_config.zon (for game-server).
  • To change gameplay-related settings (such as equipment/shiyu schedule), edit the gameplay_settings.zon file.
NOTE: player data is currently not persistent (as there's basically nothing to save rn), so database is not needed.

Logging in

Currently supported client version is CNBetaWin2.3.1, you can get it from 3rd party sources. Next, you have to apply the necessary client patch. It allows you to connect to the local server and replaces encryption keys with custom ones.

Support

Your support for this project is greatly appreciated! If you'd like to contribute, feel free to send a tip via Boosty!