Free open source Splinterlands statistics tool v0.25.0

2025-03-19T19:16:24

Introduction

Welcome back to another release of the free, open-source Splinterlands statistics tool!
Hope you enjoy this update.
In this release, we've expanded Hive blog generation, now including validator rewards in the reports.
Additionally, land liquidity pools have been updated to support the new pools:
  • DEC-WOOD
  • DEC-IRON
  • DEC-STONE
This update is especially important because recent API changes caused the tool to stop working over the last few days. If you want to continue using the tool, make sure to upgrade to the latest version!

How-to Manuals

Learn how to set up and use the Splinterlands Statistics tool on different platforms:

Demo environment

Try the demo environment to explore the tool’s features. Remember, for full control and to keep it free, you can easily set it up on your machine or server.
https://demo.spl-stats.com

Release:

Previous release posts:

Main Features

Battle Insight

  • Performance Analysis: View your most used and best-performing cards based on customizable filters.
  • Detailed Filtering: Filter battles by rulesets, formats (Modern/Wild), opponents, and more to gain specific insights.
  • Identify Weaknesses: Discover which cards and strategies you frequently lose against.
  • Strategic Improvements: Analyze loss patterns to adjust and improve your gameplay tactics.
  • Opponent Analysis: Identify and analyze performance against frequent opponents.
  • Overall Nemesis Stats: Discover which players pose the biggest challenge to you over time.

Season Statistics

  • Comprehensive Overview: Access detailed statistics of your performance for each season.
  • Earnings Tracking: Monitor your season earnings across various reward types including DEC, SPS, and cards.
  • Hive Blog Generation: Automatically generate detailed Hive blog posts summarizing your seasonal performance.

Card Insights

  • Individual Card Stats: Explore specific statistics for each card in your collection.
  • Recent Battle Logs: Review the last five battles won and lost using a particular card.
  • Synergy Analysis: Understand how specific cards perform in combination with different summoners and units.

Portfolio Management

  • Investment Overview: Track the value and performance of your entire Splinterlands asset portfolio over time.
  • Category Breakdown: Analyze assets by categories such as Cards, SPS, DEC, and more at specific historical points.
  • Edition Analysis: Evaluate the value and BCX count across different card editions.
  • SPS Monitoring: Keep tabs on your SPS holdings, including staked amounts and historical value changes.

Rating Analysis

  • Daily Win Rates: View and compare your daily win rates in both Modern and Wild formats.
  • Rating Progression: Monitor changes in your rating over time to assess improvement and consistency.
  • Multi-Account Support: Track and compare ratings across multiple accounts simultaneously.

Land Monitoring

  • Trade Hub Tracking: Monitor liquidity pools and activity within the Trade Hub.
  • Resource Harvesting: View detailed logs of resources received from land harvests.
  • Tax Collection Insights: Track resources gained through tax collections from castles and keeps.
  • Cumulative Analysis: Analyze the accumulation of resources over time for better asset management.

What is new in this release...

  • Update season SPS graph (add validator rewards)
  • Update hive blog generation with validator node rewards
  • Update land pools (DEC-WOOD, DEC-STONE, DEC-IRON)

Elaborate on the new features

In this update, we've introduced several exciting new features to enhance your experience.

SPS validator rewards tracking

When a hive blog is generated it now also includes the SPS validator nodes here part of my last season blog:
Earnings and costs

Land liquidity pools (Trade Hub) expanded

With the latest land update there are now more liquidity pool.
Before we had only DEC-GRAIN.
Now its expanded with:
  • DEC-WOOD
  • DEC-IRON
  • DEC-STONE

Showcase main features...

Here’s a closer look at some of the key features that make the Splinterlands Statistics tool a must-have for players.

Main page

On this page, you can find your most frequently used and best-performing units or summoners. Clicking on any of them will take you to a detailed overview of that specific card. You can also define filters to refine your search.
For example, you can display your best-performing units under the standard ruleset, with a minimum of 10 battles played in the Modern format.

Losing

On this page, the cards you have been losing most against. Again with extensive filtering options.

Specific card overview

On this page, you can select you account and a specific card.
Note: only cards can be selected since battles are recording via this tool.
On the top an generic overview of the selected card.
Then with which card it is most paired with summoners and units
After that the most lost against cards with summoner and units are presented

Nemesis

On this page, information about who you lost most against. When a certain player is selected you will get an result of the last played matched against that player and some stats.
In the end of the page there is still the overval nemesis, the most lost battles against an player

Rating

Daily battle statistics:
In my case modern are played by myself and wild by xbot.
or view all of the accounts at once:

Season result tracking

Seasonal battle statistics:
Summarized seasonal earning:
Generate hive blog post about you last season:

Portfolio tracking

Tracking your complete portfolio value and view how your editions are valued:
Or view specific editions like riftwatchers compared to chaos:
View you staked SPS value over time and zoom in:

What is next...

  • Investigate change from cvs store to parquet files, should have better performance.
  • Write how to deploy on cloud environment
  • Show cards that are not used or almost never used.
  • Make icons for navigation bar

How to use splinterlands statistics

⚠️When this tool is used for the first time and you are collecting seasonal data it has to retrieve all historical data. This can take a very long time, depending on how long you have played the game and how many transaction are done. Especially when an renting bot is used it probably has many small DEC transactions.
It an open-source free to use tool. If you do not trust it, do not use it or you can verify the source here:
https://github.com/gamerbeaker007/splinterlands-statistics/tree/main

With executable

Installation with Executable

  1. Download the Executable:
  2. Unzip the Downloaded File.
  3. Run spl_statistics_tool_<x>.exe on Windows or ./spl_statistics_tool_<x>.sh on Linux.
  4. Access the Tool: Open your browser and go to http://127.0.0.1:8050.
  5. In config page connect SPL account
  6. Add monitoring accounts

With Docker

docker pull gamerbeaker/splinterlands-statistics:latest
latest can also be replaced by a release tag those can be found here:
https://registry.hub.docker.com/r/gamerbeaker/splinterlands-statistics/tags
Command line options:
  -h, --help            show this help message and exit
  -d, --debug           Enable debug mode
  -l {WARN,ERR,DEBUG,INFO}, --log-level {WARN,ERR,DEBUG,INFO} Set log level
  -s, --server-mode     Enable server mode
  -st STORE, --store STORE Specify a store
  -ro, --read-only      Read only
Create an directory where to store the files, in this example C:\Temp or \temp

Windows (docker):

docker run --rm -it -v C:\Temp\:/app/store -p 8050:8050 --name splinterlands-statistics gamerbeaker/splinterlands-statistics:latest
For server mode
docker run --rm -it -v C:\Temp\:/app/store -p 8050:8050 --name splinterlands-statistics gamerbeaker/splinterlands-statistics:latest -s

Linux (docker):

docker run --rm -it -v \tmp\:/app/store -p 8050:8050 --name splinterlands-statistics gamerbeaker/splinterlands-statistics:latest
For server mode
docker run --rm -it -v \tmp\:/app/store -p 8050:8050 --name splinterlands-statistics gamerbeaker/splinterlands-statistics:latest -s

With python development or local execution

Download source and unpack, source link.
Use python 3.8 or higher.
pip install -r requirements.txt
python src/main.py
When installing on a window machine and you encounter this error message:
scrypt-1.2.1/libcperciva/crypto/crypto_aes.c(6): fatal error C1083: Cannot open include file: 'openssl/aes.h': No such file or directory
Then install Win64 OpenSSL (not the light version)

Disclaimer

This is a hobby project that I do in my spare time.

Why I created this project:

  • Passion for Data: I enjoy diving into data for a game I love to play and aim to improve my playstyle through detailed data analysis.
  • Skill Development: This project also helps me practice and keep my programming skills up to date.

Future updates:

I plan to update the data with newer versions of the game. However, please be aware that there may be times when you need to start over with data collection. I can't guarantee that everything will always work smoothly.

Important notes:

Performance with large datasets: I'm not yet sure how the project will perform with larger datasets, so consider this a big caveat.
Early-stage development: Since this is a new project, expect occasional crashes or issues that may not work in your particular situation.
If you encounter any problems, please feel free to reach out. I'll do my best to help resolve any issues.
Please note that the performance with large datasets is still uncertain and may require further optimization.

Feedback:

If you have any suggestions, remarks, improvements, or bug reports, please leave a comment or send me a message.
That's all for this week! I hope you enjoyed reading and that you'll start tracking your data to gain more insights.
See you all on the battlefield!
Not a splinterlands player yet, consider using my referral link.
257
15
87.64
15 Replies