kalahbot

COMP34120 Project 1

Running & Developing

The runnable file is main.lua. To run the bot, just run that file using lua main.lua.

1. Install Lua
2. Install Luarocks using sudo apt-get install luarocks or brew install luarocks if you have home brew installed.
3. Navigate into the lua-agent directory and install dependencies using luarocks make --local rockspecks/<choose the latest rockspec>.
4. You may need to add luarocks path to your lua path by using eval $(luarocks path --bin) on UNIX systems.

Running with game engine

You must be inside lua-agent directory.

NB! Very important: If you're on a machine without Luarocks, use the latest release and run with lua -l utils.init main.lua. utils.init package will ensure that the depencenies are used from lib directory inside the build.

Running agains given clients

The given client must be inside the lua-agent directory. For example, to play against MKRefAgent use java -jar ManKalah.jar "lua -i main.lua" "java -jar ../mankalah/MKRefAgent.jar"

Play against the client

1. Open a terminal window and type nc -l localhost 12345.
2. In another terminal window navigate to lua-agent directory and run java -jar ManKalah.jar "lua -i main.lua" "nc localhost 12345"

Play against given client

1. Open a terminal window and type nc -l localhost 12345.
2. In another terminal window navigate to lua-agent directory and run java -jar ManKalah.jar ""java -jar ../mankalah/MKRefAgent.jar"" "nc localhost 12345"

Logs

Logs are stored in logs subfolder. If it doesn't exist, you may have to create it under lua-agent. Logfiles are named by the system date. Reccommended way to see logs is using tail -f <logfile>.

Project structure

. (kalahbot)
├─ lua-agent        (the lua agent that plays the game)
|  └─ logs          (logs directory, logfiles ignored by git)
|  └─ rockspecks    (luarocks rockspecs)
|  └─ spec          (lua tests)
|  └─ utils         (util functions)
├─ mankalah         (the game engine that was provided)

Testing

Lua tests are ran using Busted. Please follow these steps. Make sure you have installed all dependencies using luarocks make --local inside lua-agent directory. Then, run all tests using busted inside the lua-agent directory.

NB! You may also have to install busted dependencies manually using the instructions below.

luarocks install copas
luarocks install lua-ev scm --server=http://luarocks.org/repositories/rocks-scm/
luarocks install moonscript