BuzzerBeater Forums

BB Insider - https://github.com/radszy/bbinsider/

The purpose of this tool is to help with game analysis by providing data about match that is not available through website, nor BBApi. It is not designed for end users, but rather programmers that can use it for building tools on top of it. Think of it as a BBApi extension. The output file can be consumed by any programming language.

Just an example of what information this tool can provide:
* Full match statistics (for team and each player)
* Per quarter statistics (for team and each player)
* Shot chart image
* List of all game events

Each event includes:
* event type
* attacking and defending team
* attacking, defending, assisting player
* gameclock
* shotclock
* commentary
* and extra event specific details

Some things are not implemented yet, but can be easily done:
* number of possessions
* biggest lead
* second chance points
* bench points
* fastbreak points
* and many more!

You can see a sample output from my last game (123786926): https://github.com/radszy/bbinsider/blob/main/123786926.js...

To reproduce this file, run the script with "python3 ./main.py --matchid 123786926 --print-events --print-stats".
Obviously, you need things like python with some libraries installed, but I'm assuming the any capable programmer can figure that out.

A bigger example of what data you can pull out using this tool: https://github.com/radszy/bbinsider/wiki/Shot-Types-(World...

And another example using this tool - find bugs in BB! https://www.buzzerbeater.com/community/forum/read.aspx?thr...

Last edited by radszy at 3/11/2023 7:23:03 PM

Great job to provide insights into GE. Thanks for sharing!

Hey how install this? ;)

I've added some instructions on Github on how to run it - the instructions were tested only on Windows, for Linux & Mac I'll revisit them later.

It's easy to use, great work. Thank you for sharing!

Wow! But is it some kind of data mining? Will we be banned if we use this tool?

I don't think anyone is going to be banned for using this. The Game Manual talks about data mining and here's what it says:

The use of web-based data mining tools, “crawler bots,” or any other software designed to use our bandwidth intensively is strictly forbidden, and your account will be banned. If you really want access to large amounts of data, ask one of the BBs, and we’ll do what we can to provide it to you.

So keeping in mind the bold part, here are some approximate numbers:
- The amount of data downloaded by the browser user to open BB welcome webpage: 1.9 MB
- The amount of data used to get boxscore from BBAPI: 25 KB
- The amount of data this tool uses to gather statistics about single game: 12 KB

This tool or any BBAPI calls are less than 1% of normal webpage content. And this tool uses data that is encoded, and thus is likely to use less data than the BBAPI.

Thanks for sharing! Looks interesting, will give it a go!