Skip to content

Latest commit

 

History

History
68 lines (36 loc) · 2.15 KB

readme.md

File metadata and controls

68 lines (36 loc) · 2.15 KB

trojan

A golang package used to execute integration tests and benchmarks against running rathena server components.

preparation

Start by compiling rathena source.

Add a user to the login table; ideally ragnarok with a password ragnarok and an account_id of 2. This will allow testing the registration of a second character server to the login server.

Adjust the following settings if you plan to run the benchmarks:

  • set enable_ip_rules to no in conf/import/packet_conf.txt
  • set ipban_enable to no in conf/import/login_conf.txt
  • increase allowed_regs to something arbitrarily high (eg. 100000) in conf/import/login_conf.txt

installation

Install go, ideally using gvm so you can easily upgrade versions.

You can download this package and all dependencies via:

go get github.com/rathena/trojan

This will download and build all dependencies, but this project does not produce a binary.

Next navigate your terminal to $GOPATH/src/github.com/rathena/trojan to begin running commands.

integration

Here is a list of parameters and the default values that can be adjusted to change execution behavior:

  • packetVer is set to 55
  • clientVer is set to 20151029
  • loginAddress is set to 127.0.0.1:6900
  • charAddress is set to 127.0.0.1:6121
  • charCredentials is set to ragnarok:ragnarok
  • mapAddress is set to 127.0.0.1:5121

A username will be randomly generated per execution, and the password is a hard-coded value of secret.

To run the integration tests, use the following command:

go test -v

Add flags as needed to configure.

notes

These tests are still very new and lacking in many ways.

  • There is no support for alternative hexed client behavior, including the other supported login commands.
  • There is no support for alternative packet formats created by different packet versions (namely 2017).
  • There are no tests for map and character servers, yet.

benchmarks

Use this command to run the benchmarks:

go test -v -run=X -bench=.

The same flags can be applied if addresses are different.