Stratus Stat Utilities

This was a fun little project that I wanted to do for a while. It scrapes data from the Stratus Network Minecraft server and does your typical computer beeps and boops with it to produce some slick PvP statistics.

Current Features

• Individual player statistics lookup
• Reverse statistics lookup
• Staff listing
• Match statistics and win prediction
• Apache/PHP files necessary to make a mirror

Planned Features

• Custom group statistics
• 1v1 comparison
• Nginx/Ruby mirror files

Requirements

• Python 3.6+
• lxml 4.x
• PycURL
• libcurl 7.19.x (should come with PycURL)
• python-tabulate
• BeautifulSoup 4.4.x
• Packaging
• python-dateutil 2.0+

You should be able to do the trick with pip install lxml pycurl tabulate beautifulsoup4 packaging python-dateutil

Configuration

What little is available to configure should be pretty self-explanitory.

Stratus Stat Utilities.py

• TITLE_TEXT and VERSION are currently just for the a e s t h e t i c.
• When MULTITHREADED is enabled, Python's futures are used to "asynchronously" (but not really) call cURL requests. Tests have shown it to be slightly faster. When disabled, it'll just go through one person at a time.
• MIRROR is the full URL to a content deliverer that mirrors the actual website. A cache mirror is useful because the Stratus Network website can get really slow at peak times and we don't want to overwhelm their servers. Leaving this option blank will just request data straight from https://stratus.network/.
• Setting a nonzero DELAY allows you to request win predictor statistics in tandem with the beginning of the current match. Setting the delay to zero asks for match input instead.
• HEADLESS_MODE is used for automatic scraping and logging for other applications to hook into. Program will dump standard output into output.log and complete_output.log when enabled.
• REALTIME_MODE (dependent on HEADLESS_MODE being active) will run a headless cycle every 15 seconds, regardless of match status.
• Last but not least, UNIXBOT will pull data from the unixfox API for live player data to circumvent problems with native Stratus match information.

index.php

• $cacheDir should point to a pre-existing directory with proper permissions already established. All of the data requests coming through your mirror will be stored there.
• $cacheDays is the number of days you want data to be cached. Floats are acceptable.
• If you set up the mirror in a subdirectory, you'll have to edit the .htaccess file's redirection statement to pass data to that subdirectory.

Extras

• Stratus Database Integrator takes all available mirror cache and feeds it into a given MySQL database
• Stratus Bulk Downloader force-feeds a mirror batches of players ordered by rank
  • Pulls from https://stratus.network/stats?game=global&sort=kills&time=eternity&page=<START_PAGE> to that of END_PAGE
• These can be automated with their corresponding bash scripts in something like cron (crontab -e):

0 */1 * * * sudo bash /path/to/stratus-gameplay.sh > /dev/null 2>&1
0 */1 * * * sudo bash /path/to/stratus-database.sh > /dev/null 2>&1
0 0 * * * sudo bash /path/to/stratus-growth.sh > /dev/null 2>&1

Support

I'm open to suggestions for feature requests. You can open an issue or contact me on Discord @Siceth#2618. I usually get back within a few hours at most.