This is a fork of argonms.

Obtain a localhost v62 client and modify 127.0.0.1 to redirect to localhost with a hex editor.

Use Harepacker to dump XML from the wz files in the client installation directory. Use argon-data to create the server KVJ files.

Before starting the server, copy .env.template to .env and edit the values.

DATA_DIR="/path/to/kvj/"

Alternatively, export these variables to the current environment. Then run the servers with the default testing settings.

docker-compose up

To insert a new account:

docker-compose run --rm center bin/insert_account.sh <NAME> <PASSWORD> <GM_LEVEL>

To make a GM account, set GM_LEVEL > 100 e.g. 200. To make a normal account, set it to 0 or omit it from the command. See argonms.common.UserPriviledges for more details.

adminer is shipped by default on port 8080. This can be used to modify the database by hand. To run this when the server is down:

docker-compose run --rm  --service-ports adminer

After exiting docker-compose, remove any dangling services:

docker-compose down

The data for the server is persisted inside of a volume. To inspect the contents:

docker volume inspect argonms-server_argonms-volume

To delete all persisted data:

docker-compose down -v

Set ARGONMS_HOST and modify the localhost client to your public IP address. Forward the appropriate ports from the docker-compose file (8383 for the center server, 8484 for the login server, and 7575 for the game server).

If you are using Docker for Windows using WSL, you should use the IPv4 address of the WSL interface (Ethernet adapter vEthernet (WSL)). Use ipconfig to find the interface.

Window line endings were introduced when saving these files. To fix this, run dos2unix.

# launch any container where the bin/ directory is mounted
docker-compose run --rm center bash

apt install dos2unix
dos2unix bin/*

# bring down the containers
docker-compose down