From 92a206ba335bd929d0c43d0d809d25f09d3e6774 Mon Sep 17 00:00:00 2001 From: gulag Date: Mon, 18 Mar 2024 22:52:52 -0400 Subject: [PATCH] docs: update README --- README.md | 76 ++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 75 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 1e9b3de..e204f61 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,77 @@ # HollowPS -Zenless Zone Zero server emulator \ No newline at end of file +A Server emulator for the game [`Zenless Zone Zero`](https://zenless.hoyoverse.com/en-us/) + +## Installation + +### From Source + +#### Requirements + +- [Rust](https://www.rust-lang.org/tools/install) + +**NOTE**: Nightly Rust is required to build the project. To install it, first install Rust itself, then run the following command: + +```sh +rustup toolchain install nightly +rustup default nightly +``` + +#### Building + +```sh +git clone https://git.xeondev.com/reversedrooms/HollowPS.git +cd HollowPS +cargo install --path gameserver +cargo install --path sdkserver +``` + +### From Prebuilt Binaries + +Navigate to the [Releases](https://git.xeondev.com/reversedrooms/HollowPS/releases) +page and download the latest release for your platform. + +## Usage + +To begin using the server, you need to run both the SDK server and the game server. + +If you installed from source, Rust's installer should have added .cargo/bin to your +path, so simply run the following: + +```sh +nap-gameserver +nap-sdkserver +``` + +If you installed from prebuilt binaries, navigate to the directory where you downloaded +the binaries and run the following: + +```sh +./nap-gameserver +./nap-sdkserver +``` + +## Configuration + +The game server can be configured using a `.env` file. The file contains one configurable +option, `SKIP_TUTORIAL`, which is set to 0 by default. + +If you have a `.env` file in the **same** directory as your executable, then this +is the file that will be loaded. Otherwise, upon _first_ running the `gameserver` +executable, it will create `{FOLDERID_RoamingAppData}\nap-gameserver\.env` +(`C:\Users\{user}\AppData\Roaming\nap-gameserver\.env`) for you, and will source +from this config instead. + +## Contributing + +Pull requests are welcome. For major changes, please open an issue first to discuss +what you would like to change, and why. + +## Bug Reports + +If you find a bug, please open an issue with as much detail as possible. If you +can, please include steps to reproduce the bug. + +Bad issues such as "This doesn't work" will be closed immediately, be _sure_ to +provide exact detailed steps to reproduce your bug. If it's hard to reproduce, try +to explain it and write a reproducer as best as you can.