Free open source Splinterlands statistics tool v0.23.1

in Splinterlands2 months ago

Splinterlands Statistics.png

Introduction

This is a somewhat smaller release and it came a bit as a surprise.

With the last update the Splinterlands team made it possible to unbound the rebellion soulbound rewards cards. I did not expect this for a few more months. So i needed to update the application.

image.png

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:

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

Previous release posts:

v0.22.1 - Fix account connections towards SPL API
v0.22.0 - Add rebellion soulbound rewards units
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 (Portfolio): Value is calculated for fully unlocked rebellion soulbound rewards unit.
  • UPDATE: generation of executable improved, changed executable name and add icon. removed windows admin warning.

image.png


The following message will still appear with the window executable

Windows protected your PC
Microsoft Defender SmartScreen prevented an unrecognized app from starting. Running this app might put your PC at risk.

This warning is shown if your app doesn't have enough reputation with Microsoft SmartScreen yet. In order to gain reputation, you can either

  • submit your app for malware analysis to Microsoft
    • Need to be done for every release not feasible
  • buy an "Extended Validation" (EV) code signing certificate
    • 200-700 USD
  • buy an "Organization Validation" (OV) code signing certificate
    • 100-500 USD
  • just wait for a long time
    • Best option only not many downloads of this application so will take forever 😌

Read on for the details about these different options.
https://stackoverflow.com/questions/48946680/how-to-avoid-the-windows-defender-smartscreen-prevented-an-unrecognized-app-fro

Elaborate on the new features

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

Unlocked rebellion rewards units

Now the fully unlocked rebellion soulbound rewards units are taken into account with the portfolio update.

soulboundrb.png

I have unlocked one units for the testing of the functionally. To put it in perspective here a view where i also have selected the chaos legion soulbound reward cards.

image.png

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.

image.png

Losing

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

image.png

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.

image.png

Then with which card it is most paired with summoners and units

image.png

After that the most lost against cards with summoner and units are presented

image.png

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

In the end of the page there is still the overval nemesis, the most lost battles against an player
image.png

Rating

Daily battle statistics:
In my case modern are played by myself and wild by xbot.

image.png

image.png

image.png

or view all of the accounts at once:

image.png

Season result tracking

Seasonal battle statistics:

image.png

Summarized seasonal earning:

earnings.png

Generate hive blog post about you last season:
image.png

Portfolio tracking

Tracking your complete portfolio value and view how your editions are valued:

image.png

image.png

Or view specific editions like riftwatchers compared to chaos:

rift-chaos.png

View you staked SPS value over time and zoom in:

image.png

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.

Sort:  


This post has been supported by @fallen.angels guild!
Delegate Tokens and HP to Fallen Angels to earn weekly rewards!
Delegate | Join to the guild

This post has been supported by @Splinterboost with a 15% upvote! Delagate HP to Splinterboost to Earn Daily HIVE rewards for supporting the @Splinterlands community!

Delegate HP | Join Discord

Thanks for sharing! - @alokkumar121