OGame highscores tracker

Python script to fetch player highscores from OGame public APIs and store them inside an InfluxDB time series database.
Data can then be explored using the InfluxDB UI or CLI or using the provided Shiny web application.

Getting started

Install and configure InfluxDB as see fit.

Clone the repository at the desired location.

git clone https://github.com/QueCS/ogame_highscores_tracker.git

Hop into it.

cd ogame_highscores_tracker

Set the appropriate python virtual environment used in further steps.

python3 -m venv .venv

Install necessary dependencies in the virtual environment.

.venv/bin/pip3 install -r requirements.txt

Modify the configuration file as see fit, keep it saved as config.toml:

• The [INFLUXDB] section must be adjusted to match your InfluxDB setup.
• The [SCRIPT] section configures scripts parmeters, can be left as is or modified.
• The [OGAME] section configures which OGame server and highscores to track (more information on highscores categories and types) as well as what timezones to use when generating tables using the Shiny web application, can be left as is or modified.

Running the tracker

Launch tracker.py in the virtual environment.

.venv/bin/python3 src/tracker.py >> logs/tracker.log

Running the shiny web application

Launch app.py in the virtual environment.

.venv/bin/shiny run src/app.py >> logs/app.log

Note that you can adjust the host and port on which you want the webapp to be reachable by using the options --host and --port.

Using the shiny web application

Several tabs are available on the top.

Analysis

Consist in a series of bar-charts indicating whether the player gained some points or not whithin the timeframe of your choice for each day of the week, combined.
The idea is to easily spot basic player habbits patterns. Two additional parameters are specific to it. "Time interval (min)" allows to adjust the timeframe stringency. "Timezone" allows to run the analysis using either the game server timezone, your local timezone (as set in config.toml) or UTC.

Table

An easy-to-read summary of the query allowing to check point gain and loss of the chosen player.

One-liner installation

git clone https://github.com/QueCS/ogame_highscores_tracker.git && cd ogame_highscores_tracker && python3 -m venv .venv && .venv/bin/pip3 install -r requirements.txt

Disclaimer

OGame is a registered trademark of Gameforge Productions GmbH.
I am not affiliated with, endorsed by, or in any way officially connected to Gameforge Productions GmbH.