SpringRTS Lobby DataBase
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
etc
var
COMPONENTS
LICENSE
README.md
Sldb.pm
SldbLiConf.pm
TABLES
XMLRPC
ratingEngine.pl
slMonitor.pl
sldbBackup.pl
sldbLi.pl
sldbSetup.pl
xmlRpc.pl
zkMonitor.pl

README.md

SLDB

SLDB (Spring Lobby DataBase) is a data warehouse and real time ranking application for all games based on SpringRTS engine. It is designed to offer all the required functionalities to manage the player base in the context of FOSS (Free Open Source Software) games, where players can create as many accounts as they want and games can be hosted by anyone. For this purpose, following functionalities have notably been implemented:

  • advanced automatic multi-accounts ("smurfs") detection
  • automatic and manual (by admins) accounts join/split
  • by-game and by-game-type TrueSkill ranking system to optimize players balance on all types of games
  • retro-active account management regarding ranking (automatic re-rating of all required matches when new accounts are joined/split)
  • protection against fake data sent by thrid parties
  • configurable privacy levels to limit account information disclosure

SLDB is also designed to allow fast access to historical data concerning all games and players using main Spring lobby since July 2012 (matches results, ranking data, statistics...).

Components

Please see the file called COMPONENTS for a more detailed description of each component.

The SLDB lobby inteface bot is based on the templates provided by following project:

Dependencies

The SLDB application is based on a partitionned database which requires MySQL 5.5 or later.

The SLDB application depends on following projects:

The SLDB backup script requires following dependencies, which are only needed if you plan to use this script for your backups:

Additionally, some SLDB components require some standard but non-core Perl modules to be available on the system (easily installable through CPAN):

  • ratingEngine requires the "Inline::Python" Perl module
  • xmlRpc requires the "RPC::XML::Server" Perl module ("Net::Server::PreFork" is also highly recommended)
  • zkMonitor requires the "HTML::TreeBuilder" and "WWW::Mechanize" Perl modules

SLDB also depends on following project (hosted remotely) for additional functionalities:

Installation

  • Ensure MySQL 5.5 or later is installed on the system

  • Copy following dependencies into SLDB directory: SimpleConf.pm, SimpleLog.pm and SpringLobbyInterface.pm

  • Install the TrueSkill python module as "trueskill" subdirectory of SLDB (version "0.2.1" is known to be compatible with SLDB)

  • Use your favorite Perl package manager to install following standard Perl modules (available on CPAN) and their dependencies: Inline::Python, RPC::XML::Server, Net::Server::PreFork, HTML::TreeBuilder and WWW::Mechanize

  • run the sldbSetup.pl script from SLDB directory and execute all steps, as selectionned by default by the script

  • Edit the etc/sldbLi.conf file to set following parameters:

    • lobbyPassword (password of the lobby account used by sldbLi)
    • sldb (replace <dbLogin>, <dbPwd> and <dbName> by the corresponding values for SLDB)
    • etcDir (directory containing sldbLi config files, should be the "etc" subdirectory of SLDB)
    • varDir (directory containing sldbLi dynamic data, should be the "var" subdirectory of SLDB)
    • logDir (directory containing sldbLi log files, should be the "var/log" subdirectory of SLDB)
  • Edit the etc/users.conf file and update the <> placeholders with the desired privileged lobby user names and account IDs for SLDB

  • You are now ready to launch all SLDB components, using recommended order:

      ./slMonitor.pl
      ./zkMonitor.pl
      ./ratingEngine.pl
      ./sldbLi.pl
      ./xmlRpc.pl
    

Backups

SLDB includes a basic backup script: sldbBackup.pl

The "Configuration" section of this script must be edited before first use, to match host environment (in particular, a LFTP bookmark must be created first to store the remote FTP server connection information).

This script requires an account with sufficient privileges to run mysqlhotcopy. It can be launched manually once with verbose option to check that all works as expected:

    ./sldbBackup.pl --verbose

Then it is recommended to schedule this script to be executed weekly in off peak periods, using crontab for example.

Documentation

Please see the file called COMPONENTS for a description of each SLDB component.

Please see the file called TABLES for a basic description of SLDB data model.

Please see the file called XMLRPC for a description of the XML-RPC interface.

Licensing

Please see the file called LICENSE.

Author

Yann Riou yaribzh@gmail.com