Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/arlyon/azerust
An experimental World of Warcraft emulator in Rust
https://github.com/arlyon/azerust
emulator rust world-of-warcraft wotlk wow wow-server wow-servers wow-wotlk wrath-of-the-lich-king
Last synced: about 1 month ago
JSON representation
An experimental World of Warcraft emulator in Rust
- Host: GitHub
- URL: https://github.com/arlyon/azerust
- Owner: arlyon
- License: mit
- Created: 2020-12-24T02:03:35.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2022-03-05T14:33:09.000Z (over 2 years ago)
- Last Synced: 2024-05-01T12:51:03.302Z (4 months ago)
- Topics: emulator, rust, world-of-warcraft, wotlk, wow, wow-server, wow-servers, wow-wotlk, wrath-of-the-lich-king
- Language: Rust
- Homepage:
- Size: 459 KB
- Stars: 29
- Watchers: 4
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
- License: license.md
Awesome Lists containing this project
README
# azerust
Azerust is an experimental WoW server emulator for patch 3.3.5
written in Rust. Currently, it only implements the auth server.
It is currently being built to be compatible (read: piggy back
on top of) the TrinityCore database. Note, however, that we use
mariadb in the docker-compose file. Our goals are:
- fast
- readable
- safe
- concise
> **Note:** For the time being this relies on nightly for the
> `arbitrary_enum_discriminant` feature, which simplifies
> serialization / deserialization.
## Getting Started
This project uses [`cargo-make`](https://github.com/sagiegurari/cargo-make)
for scripting / tasks. It also uses the latest nightly compiler
however this is only to speed up compilation.
### Configuration
You will need to provide some configs. Run the `init` command on
the world and auth server to generate configs for them.
### Docker
The simplest method to kickstart is to just use docker compose.
To set up the database, you can use a docker compose file we have
available. We need to populate a schema, for which we piggy back
off the incredible Trinitycore project.
```bash
> cargo make fetch-db
> docker compose --profile server up
```
The downloaded SQL scripts will be used to set up the databases.
You will also need to create a `config-auth-compose.yml` and a
`confit-world-compose.yml` file which are used by docker-compose.
### Building
We statically check our queries against the database to ensure
type safety across the board. This means we depend on access to
certain information from our database. Obviously spinning up a
db every time you build is cumbersome, so there are two options:
`.env`
```bash
DATABASE_URL=mysql://localhost/auth
# or
SQLX_OFFLINE=true
```
Setting `DATABASE_URL` dynamically updates queries as we go, while
the `SQLX_OFFLINE` option uses the data in `sqlx-data.json`. This
should always be up to date. If the queries change at any time, we
will need to regenerate this file from the live database. To do
this, use the make command:
```bash
cargo make prepare
```
The next part is easy. Provide the `--release` flag if you want to
make it go fast.
```bash
cargo make auth
# or
cargo run --bin azerust-auth --release
```
### Logging
You can use the [RUST_LOG env var](https://rust-lang-nursery.github.io/rust-cookbook/development_tools/debugging/config_log.html) to configure log levels.
For example, we can enable debug mode for the azerust packages:
```bash
RUST_LOG=azerust_auth,azerust_world=debug
```
## Account Creation
To create a command, you can use the `exec` command to run commands
against the database.
```bash
cargo make auth exec account create
```