Hi

.gitignore

@@ -0,0 +1,6 @@
+# Rust build directory
+target/
+/lib/crates/proto/cs_proto
+
+# Server configuration directory
+/config/

Cargo.toml

@@ -0,0 +1,57 @@
+[workspace]
+members = ["lib/*", "servers/*"]
+resolver = "2"
+
+[workspace.package]
+version = "0.0.1"
+
+[workspace.dependencies]
+tokio = { version = "1.44.2", features = ["full"] }
+tokio-util = "0.7.15"
+axum = "0.8.3"
+ureq = { version = "3.0.11", features = ["json"] }
+sqlx = { version = "0.8.5", features = ["postgres", "runtime-tokio-rustls"] }
+
+const_format = "0.2.34"
+thiserror = "2.0"
+scc = "2.3.3"
+num_enum = "0.7.3"
+itertools = "0.14"
+
+serde = { version = "1.0", features = ["derive"] }
+serde_json5 = "0.2.1"
+toml = "0.8"
+
+rsa = { version = "0.9.8", features = ["sha2"] }
+rand = "0.8.5" # locked on 0.8 due to RSA crate issues
+base64-simd = "0.8.0"
+rand_mt = "5.0.0"
+xxhash-rust = { version = "0.8.15", features = ["const_xxh64"] }
+
+# Protobuf
+prost = "0.13.5"
+prost-types = "0.13.5"
+prost-build = "0.13.5"
+
+# Flatbuffers
+flatbuffers = "25.2.10"
+flatc-rust = "0.2.0"
+
+# Logging
+tracing = "0.1"
+tracing-subscriber = "0.3"
+
+# Code Generation
+proc-macro2 = "1.0"
+syn = "2.0"
+prettyplease = "0.2"
+paste = "1.0"
+quote = "1.0"
+
+common = { path = "lib/common" }
+config = { path = "lib/config" }
+vivian-codegen = { path = "lib/codegen" }
+vivian-proto = { path = "lib/proto" }
+vivian-logic = { path = "lib/logic" }
+vivian-encryption = { path = "lib/encryption" }
+vivian-service = { path = "lib/service" }

README.md

@@ -0,0 +1,57 @@
+# Vivian-rs
+##### Experimental server emulator for the game Zenless Zone Zero
+![title](assets/img/title.png)
+
+## Features
+- Microservices Architecture
+- Quest System
+- "TV Mode" aka Monitor Array
+- VR Training
+- Gacha (with configurable banner schedule)
+- NPC Interactions
+- Miscellaneous items (Skins, W-Engines, Wallpapers)
+#### NOTE: vivian-rs is currently under active development
+
+## Getting started
+### Requirements
+- [Rust 1.86+](https://www.rust-lang.org/tools/install)
+- [PostgreSQL](https://www.postgresql.org/download/)
+- [SDK server](https://git.xeondev.com/reversedrooms/hoyo-sdk)
+##### 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](https://discord.xeondev.com)
+
+### Setup
+#### a) building from sources
+```sh
+git clone https://git.xeondev.com/vivian-rs/vivian-rs.git
+cd vivian-rs
+cargo run --bin vivian-dispatch-server
+cargo run --bin vivian-gate-server
+cargo run --bin vivian-dbgate-server
+cargo run --bin vivian-game-server
+```
+#### b) using pre-built binaries
+Navigate to the [Releases](https://git.xeondev.com/vivian-rs/vivian-rs/releases) page and download the latest release for your platform.
+Start each service in order from option `a)`.
+
+### Configuration
+The configuration of each server is located under the `config` directory (created upon first startup)
+- To change network settings for internal server communication, edit the: `config/00-service/environment.toml`
+- To change network settings for outer communication (e.g. with the game client), edit the dispatch-server and gate-server configuration, located in `config/10-dispatch-server/config.toml` and `config/20-gate-server/config.toml` respectively.
+- To change database connection settings, edit the dbgate-server configuration, located in: `config/30-dbgate-server/config.toml`
+- To change gameplay-related settings, edit one of game-server configuration files, for example: gacha banner schedule is located in: `config/40-game-server/gacha_schedule.toml`
+
+### Logging in
+Currently supported client version is `OSPRODWin1.7.0`, you can get it from 3rd party sources (e.g. game launcher). Next, you have to apply the necessary [client patch](https://git.xeondev.com/vivian-rs/vivian-patch). It allows you to connect to the local server and replaces encryption keys with custom ones.
+![tv_mode](assets/img/tv_mode.png)
+
+### Obtaining characters without gacha
+While playing on the server, you may want to obtain the characters that are not available in current gacha schedule. In order to do so, you can use in-game debug menu: find the 'Vivian' NPC in the WorkShop location, and interact with it. It'll send you to a debug TV mode scene, where you can select the characters to obtain. (The NPC will spawn as soon as you progress in starting quests!)
+![debug_menu](assets/img/debug_menu.png)
+
+### Gameplay customization
+The MainCity quests and TV mode levels are highly customizable by their nature. You may look around the `assets/LevelProcess` directory.
+
+### Support
+Your support for this project is greatly appreciated! If you'd like to contribute, feel free to send a tip [via Boosty](https://boosty.to/xeondev/donate)!