Skip to content

Latest commit

 

History

History
63 lines (39 loc) · 2.03 KB

README.md

File metadata and controls

63 lines (39 loc) · 2.03 KB

goko-dominion-tools

Tools for use with Goko's online Dominion game.

Features:

  • Log Parsing/Database
  • Log Search
  • Kingdom Visualizer
  • Trueskill Leaderboard
  • Automatch browser extension
  • Log Prettifier (credit to nutki for original version)
  • Avatar uploading (credit to nutki for original version)

Contributions are welcome.

Installation

You'll need Python v3.3.2+ and the following PyPi packages:

  • beautifulsoup4 (4.2.1)
  • bidict (0.1.1)
  • numpy (1.7.1)
  • scipy (0.12.0)
  • py-postgresql (1.1.0)
  • pytz (2013b)
  • tornado (3.1)
  • trueskill (0.4.1)
  • Pillow (2.4.0)

You can either connect remotely to my database of parsed games or create your own. To create and maintain your own, you'll also need PostgreSQL and a *NIX environment with bash, perl, zcat, split, and wget.

Database Setup

Remote

The default configuration is to connect to the PostgreSQL server at gokologs.drunkensailor.org, which has all the games played on Goko and updates every 15 minutes. Configuration information is in gdt/model/db_manager.

Local (out of date)

To create your own database, install PostgreSQL and create a database with UTF-8 encoding. Then create the database schema:

$ psql -d goko < misc/db/schema.sql

Import the non-game info into your database (bot names, etc):

$ psql -d goko < misc/db_initdata/*

Download and parse logs from the Goko log archive:

$ bash update_logdb.sh <logdir> <codebase> <dates>

where <logdir> is the local directory where you want to store unparsed logs, <codebase> is this project's root, and <dates> are formatted like YYYYMMDD. You'll have to run this for each day. The import process is IO-bound on a modern machine. An SSD drive helps a lot. As of May 2014, the full database is about 60G.

Server setup

Start the server:

$ python ./start_servers.py

Go to http://localhost to use the logsearch, kingdom visualizer, and leaderboard. The automatch server runs on ports 443 and 8889, but has no web browser UI.