Introduction

If you've always wanted to keep track of your Splinterlands statistics, this free open-source tool makes it easy.

This release contains three major updates:

• Implemented support of rebellion rewards units
• Implemented value calculations for unlocked Soulbound Chaos Legion reward cards.
• Update config page, using keychain extension

How-to Manuals

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

• Windows with Docker: Step-by-step guide to setting up on Windows.
• Synology NAS: Deploy the tool on a Synology NAS for continuous tracking.

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:

To view all released versions:
Github splinterlands statistics release overview page

Previous release posts:

v0.21.0 - Add dec/grain pool information
v0.20.3 - Add loot chests to hive blog
v0.19.0 - Add rarity draws and last played battles
v0.18.2 - Add glint to season rewards
v0.17.1 - Add Ability filter
v0.16.0 - Unclaimed SPS balance history SPL API update
v0.15.1 - SPL battle history API changed
v0.14.2 - Balance history and battle API updated
v0.13.0 - Battle view home team now in reverse order
v0.12.1 - Update losing page
v0.11.1 - Add land monitoring
v0.10.0 - Portfolio: land update
v0.9.1 - Fix rebellion pack values
v0.8.0 - Auto process season in server mode
v0.7.0 - Server/read only mode incl. how-to deploy on synology nas
v0.6.0 - Card overview + Nemesis expansion
v0.5.0 - Portfolio card edition and sps overview
v0.4.0 - Show categories in portfolio overview including history
v0.3.1 - Add generate hive blog
v0.2.0 - Add filter and sort options to home page
v0.1.0 - First implementation Splinterlands Statistics V2
Last "Old" Splinterstats tool V1

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...

• Add rebellion soulbound reward units. Portfolio and filter options
• Add calculation of chaos legion soulbound for portfolio
• Streamlined account registration, now only requiring a single management account for easier setup.
• Update the message for season statistics retrieval
• FIX/CHANGE: remove pycoingecko dependency use hive price of SPL
• FIX: Collection page is update only with current collection for determining portfolio value previous owned rented card are removed.
• Update small layout improvements on season and portfolio page

Elaborate on the new features

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

Add rebellion soulbound rewards units

The new rebellion soulbound rewards units are added to the portfolio edition overview:

Calculate value for unlocked soulbound chaos legion reward cards

For every fully unlocked soulbound a values are calculated and shown in portfolio edition page:

Update config page

In this release, the configuration process has been simplified. To gain full access, you need to connect one of your SPL accounts to the Splinterlands API. This connection generates a token, which is then stored in the secret.csv file (be sure to keep this file confidential). With this token, you can retrieve battle and balance information for your account as well as other accounts.

Additionally, the monitoring setup has been updated to support multiple accounts simultaneously, separated by commas (,).

Showcase some other 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:
   • Windows: Download exe
   • Linux: Download sh
2. Unzip the Downloaded File.
3. Run main.exe on Windows or ./main.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.