About

High-Level Alchemy is a game server emulator compatible with the 377 game client. It makes some attempt to emulate the popular MMORPG RuneScape around 2005. The project is a heavy work in progress. Many features are not even considered with the current design(s) and I would classify this as experimental at best.

Requirements

1. elixir >= 1.18
   • Erlang/OTP >= 28
2. bzip2
3. postgresql >= 14

Client

For 377, I use refactored-377 fork

Usage

Nix/devenv

Use devenv to bring up a shell that can service both the game server application and a postgresql database:

$ devenv up # Bring up the Game Server, a PostgreSQL database and run migrations against it.

Docker

You can use docker-compose to bring up a stack that includes the application along with a postgresql database:

$ docker compose up

Manual

1. Create a config/.env.dev.exs file. Fill it in with elixir environment variables.

System.put_env("HLA_DATABASE", "hla-dev")
System.put_env("HLA_DATABASE_USER", "hla")
System.put_env("HLA_DATABASE_PASSWORD","hla")
System.put_env("HLA_DATABASE_HOST","localhost")
System.put_env("HLA_DATABASE_PORT", "5432")
System.put_env("HLA_GAME_HOST", "localhost")
System.put_env("HLA_GAME_PORT", "43594")
System.put_env("HLA_JAGGRAB_PORT", "43595")
System.put_env("HLA_HTTP_PORT", "8080")

2. Use ecto to create the database and run migrations.

$ mix ecto.create
$ mix ecto.migrate

3. Run the game server application

$ mix run --no-halt 

or (with iex)

$ iex -S mix

RSA Login Encryption (Optional)

RSA encrypts the login block between client and server. Disabled by default — both sides must match.

1. Generate a keypair: mix rsa.keygen
2. Enable on the server: export HLA_RSA_ENABLED=true
3. Copy the printed modulus into the client's config/client-config.yaml and set rsaEnabled: true
4. Restart both server and client

For Docker, the hla_rsa volume persists the key. Generate inside the container with docker exec hla_app mix rsa.keygen.