assets | ||
lib | ||
servers | ||
.gitignore | ||
Cargo.lock | ||
Cargo.toml | ||
LICENSE | ||
README.md |
Vivian-rs
Experimental server emulator for the game Zenless Zone Zero
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
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/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 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
andconfig/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. It allows you to connect to the local server and replaces encryption keys with custom ones.
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!)
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!