BBReplay

A nodejs module that reads Blood Bowl replay files

Installation

Simplest way to install bbreplay is to use npm, just npm install bbreplay which will download bbreplay and all dependencies.

Usage

var bbreplay = require('bbreplay');
var file = 'path to your BB2 replay file';

bbreplay.getBB2replay(file)
    .then(function (result) {
        console.log(result);
    })
    .catch(function (err) {
        console.log(err);
    });

Documentation

bbreplay.getBB2replay(file)

Arguments

• file - path to the BB2 replay file.

Returned object

{
    gameDetails: {
        fileName: replay file name,
        leagueName: league name,
        competitionName:  competition name,
        stadiumName: stadium name,
        finished: game end date and hour,
        homeTeam: {
            data: {
                coachName: home team coach name,
                coachid: home team coach id,
                teamName: home team name,
                raceId: home team race id,
                value: home team TV,
                popularity: home team popularity,
                treasury: home team treasury,
                apothecary: home team apothecary,
                reroll: home team reroll,
                logo: home team logo,
                teamId: home team id
            },
            result: {
                score: home team score,
                nbsupporters: home team supporters,
                fame: home team fame,
                winningsdice: home team winningdice,
                cashearned: home team cash earned,
                popularitygain: home team popularity gain
            },
            stats: {
                imvp: nb of MVP,
                inflictedpasses: nb of inflicted passes,
                inflictedcatches: nb of inflicted catches,
                inflictedinterceptions: nb of inflicted interceptions,
                inflictedcasualties: nb of inflicted casualties,
                inflictedtackles: nb of inflicted tackles,
                inflictedpushouts: nb of inflicted pushouts,
                inflictedstuns: nb of inflicted stuns,
                inflictedko: nb of inflicted ko,
                inflictedinjuries: nb of inflicted injuries,
                inflicteddead: nb of inflicted dead,
                inflictedmetersrunning: run meters,
                inflictedmeterspassing: nb of meters through pass,
                inflictedpossessionball: % of ball possession,
                sustainedinterceptions: nb of sustained interceptions,
                sustainedcasualties: nb of sustained casualties,
                sustainedtackles: nb of sustained tackles,
                sustainedstuns: nb of sustained stuns,
                sustainedko: nb of sustained ko,
                sustainedinjuries: nb of sustained injuries,
                sustaineddead: nb of sustained dead,
                occupationtheir: % of time in opposite side,
                occupationown: % of time in own side
            }
        },
        awayTeam: {
            data: {
                coachName: away team coach name,
                coachid: away team coach id,
                teamName: away team name,
                raceId: away team race id,
                value: away team TV,
                popularity: away team popularity,
                treasury: away team treasury,
                apothecary: away team apothecary,
                reroll: away team reroll,
                logo: away team logo,
                teamId: away team id
            },
            result: {
                score: away team score,
                nbsupporters: away team supporters,
                fame: away team fame,
                winningsdice: away team winningdice,
                cashearned: away team cash earned,
                popularitygain: away team popularity gain
            },
            stats: {
                imvp: nb of MVP,
                inflictedpasses: nb of inflicted passes,
                inflictedcatches: nb of inflicted catches,
                inflictedinterceptions: nb of inflicted interceptions,
                inflictedcasualties: nb of inflicted casualties,
                inflictedtackles: nb of inflicted tackles,
                inflictedpushouts: nb of inflicted pushouts,
                inflictedstuns: nb of inflicted stuns,
                inflictedko: nb of inflicted ko,
                inflictedinjuries: nb of inflicted injuries,
                inflicteddead: nb of inflicted dead,
                inflictedmetersrunning: run meters,
                inflictedmeterspassing: nb of meters through pass,
                inflictedpossessionball: % of ball possession,
                sustainedinterceptions: nb of sustained interceptions,
                sustainedcasualties: nb of sustained casualties,
                sustainedtackles: nb of sustained tackles,
                sustainedstuns: nb of sustained stuns,
                sustainedko: nb of sustained ko,
                sustainedinjuries: nb of sustained injuries,
                sustaineddead: nb of sustained dead,
                occupationtheir: % of time in opposite side,
                occupationown: % of time in own side
            }
        }
    },
    playerDetails: { //one line per player
        '1': { // id used in actions
            team: team index, // 0: home, 1:away
            name: player name,
            id: player id used in actions,
            number: player number,
            ma: player MA,
            st: player ST,
            ag: player AG,
            av: player AV,
            type: player type id,
            level: player level,
            xp: player XP,
            skills: array of skill id,
            casualty: array of casualty id ,
            stats: { // game player statistics
                acquiredxp: acquired experience during the game,
                casualty: game casualty,
                inflictedtackles: 1, // stats keys depends of player performances
                sustainedtackles: 3,
                sustainedinjuries: 1,
                matchplayed: 1,
                idplayerlisting: player id
            }
        }
    },
    actions: [ // array of actions
        { team: 0(home)-1(away), 
            turn: 0, // match turn
            player: 43, // player id
            rollType: -2, // roll Type see below
            dice: [array of dice roll] },
    ],
    results: {
        match row information
    },
    bbReplayVersion: version of bbrepplay that generates the data
}  

Roll Type

• -2 - Kickoff Scatter if 2 dices (D6 + D6)
• -2 - Pass Scatter if 3 dices (D8 + D6 + D6)
• -1 - Kickoff (D6 + D6)
• 1 - GFI (D6)
• 2 - Dodge (D6)
• 3 - Armour (D6)
• 4 - Injury (D6)
• 5 - Block (Block Dice)
• 6 - Stand up (D6)
• 7 - Pickup (D6)
• 8 - Casualty (D6)
• 9 - Catch (D6)
• 10 - Scatter (D8)
• 11 - Throw in (D6)
• 12 - Pass (D6)
• 16 - Intercept (D6)
• 17 - Wake-Up After KO (D6)
• 20 - Bone-Head (D6
• 21 - Really Stupid (D6)
• 22 - Wild Animal (D6)
• 23 - Loner (D6)
• 24 - Landing (D6)
• 26 - Inaccurate Pass Scatter (D8)
• 27 - Always Hungry (D6)
• 29 - Dauntless (D6)
• 31 - Jump Up (D6)
• 34 - Stab (D6)
• 36 - Leap (D6)
• 37 - Foul Appearance (D6)
• 40 - Take Root (D6)
• 42 - Hail Mary Pass (D6)
• 46 - Hypnotic Gaze (D6)
• 54 - Fireball (D6)
• 55 - Lightning Bolt (D6)
• 56 - Throw Team-Mate (D6)
• 58 - Kickoff Gust (D6)
• 59 - Armour (D6) // pre-piling on roll
• 60 - Injury (D6) // pre-piling on roll

Examples

var file = 'file.bbrz';

bbreplay.getBB2replay(file)
    .then(function (result) {
        // results is an object with match data
        console.log(result);
    })
    .catch(function(err) {
        console.log(err);
    });
});

Acknowledgments

Part of the code, especially replay file decoding, is inspired by [bonnici] (https://www.reddit.com/user/bonnici) and its [onesandskulls] (http://onesandskulls.com/) web site.

Versions

version 0.4.4 : Modify coachId and teamId
version 0.4.3 : Add file name
version 0.4.2 : Add level into player object
version 0.4.1 : Add team info into player object
version 0.4.0 : Include team and player statistics in the returned object
version 0.3.0 : Use promise instead of asynchrone function with callback
version 0.2.0 : Code refactoring
version 0.1.0 : First implementation of the library with one function 'getMatchResults' that returns BB2 match result as json object

Getting support

Please, if you have a problem with the library, first make sure you read this README. If you read this far, thanks, then please make sure your problem really is with bbreplay. It is? Okay, then open an issue.