daggerheart/tools/analyze-damage.mjs

/**
 * Internal script to analyze damage and spit out results.
 * There isn't enough entries in the database to make a full analysis, some tiers miss some types.
 * This script only checks for "minions" and "everything else".
 * Maybe if future book monsters can be part of what we release, we can analyze those too.
 */

import fs from 'fs/promises';
import path from 'path';

const allData = [];

// Read adversary pack data for average damage for attacks
const adversariesDirectory = path.join('src/packs/adversaries');
for (const basefile of await fs.readdir(adversariesDirectory)) {
    if (!basefile.endsWith('.json')) continue;
    const filepath = path.join(adversariesDirectory, basefile);
    const data = JSON.parse(await fs.readFile(filepath, 'utf8'));
    if (data?.type !== 'adversary' || data.system.type === 'social') continue;

    allData.push({
        name: data.name,
        tier: data.system.tier,
        adversaryType: data.system.type,
        damage: parseDamage(data.system.attack.damage)
    });
}

const adversaryTypes = new Set(allData.map(a => a.adversaryType));
for (const type of [...adversaryTypes].toSorted()) {
    const perTier = Object.groupBy(
        allData.filter(a => a.adversaryType === type),
        a => a.tier
    );
    console.log(`${type} per Tier: ${[1, 2, 3, 4].map(t => perTier[t]?.length ?? 0).join(' ')}`);
}

const result = {
    basic: compileData(allData.filter(d => d.adversaryType !== 'minion')),
    solos_and_bruisers: compileData(allData.filter(d => ['solo', 'bruiser'].includes(d.adversaryType))),
    leader_and_ranged: compileData(allData.filter(d => ['leader', 'ranged'].includes(d.adversaryType))),
    minion: compileData(allData.filter(d => d.adversaryType === 'minion'))
};

console.log(result);

/** Compiles all data for an adversary type (or all entries) */
function compileData(entries) {
    // Note: sorting numbers sorts by their string version by default
    const results = {};
    for (const tier of [1, 2, 3, 4]) {
        const tierEntries = entries.filter(e => e.tier === tier);
        const allDamage = removeOutliers(tierEntries.map(d => d.damage).sort((a, b) => a - b));
        const mean = getMean(allDamage);
        if (tier === 4) console.log(allDamage);
        results[tier] = {
            mean,
            deviation: getStandardDeviation(allDamage, { mean })
        };
    }

    return results;
}

function removeOutliers(data) {
    if (data.length <= 4) return data;
    const startIdx = Math.floor(data.length * 0.25);
    const endIdx = Math.ceil(data.length * 0.75);
    const iqrBound = (data[endIdx] - data[startIdx]) * 1.25;
    return data.filter(d => d >= data[startIdx] - iqrBound && d <= data[endIdx] + iqrBound);
}

function getMedian(numbers) {
    numbers = numbers.toSorted((a, b) => a - b);
    const medianIdx = numbers.length / 2;
    return medianIdx % 1 ? numbers[Math.floor(medianIdx)] : (numbers[medianIdx] + numbers[medianIdx - 1]) / 2;
}

function getMean(numbers) {
    if (numbers.length === 0) return NaN;
    return numbers.reduce((r, a) => r + a, 0) / numbers.length;
}

function getMedianAverageDeviation(numbers, { median }) {
    const residuals = allDamage.map(d => Math.abs(d - median));
    return getMedian(residuals);
}

function getStandardDeviation(numbers, { mean }) {
    const deviations = numbers.map(r => r - mean);
    return Math.sqrt(deviations.reduce((r, d) => r + d * d, 0) / (numbers.length - 1));
}

function parseDamage(damage) {
    const formula = damage.parts
        .filter(p => p.applyTo === 'hitPoints')
        .map(p =>
            p.value.custom.enabled
                ? p.value.custom.formula
                : [p.value.flatMultiplier ? `${p.value.flatMultiplier}${p.value.dice}` : 0, p.value.bonus ?? 0]
                      .filter(p => !!p)
                      .join('+')
        )
        .join('+');
    return getExpectedDamage(formula);
}

/**
 * Given a simple flavor-less formula with only +/- operators, returns a list of damage partial terms.
 * All subtracted terms become negative terms.
 */
function getExpectedDamage(formula) {
    const terms = formula
        .replace('+', ' + ')
        .replace('-', ' - ')
        .split(' ')
        .map(t => t.trim());
    let multiplier = 1;
    return terms.reduce((total, term) => {
        if (term === '-') {
            multiplier = -1;
            return total;
        } else if (term === '+') {
            return total;
        }

        const currentMultiplier = multiplier;
        multiplier = 1;

        const number = Number(term);
        if (!Number.isNaN(number)) {
            return total + currentMultiplier * number;
        }

        const dieMatch = term.match(/(\d+)d(\d+)/);
        if (dieMatch) {
            const numDice = Number(dieMatch[1]);
            const faces = Number(dieMatch[2]);
            return total + currentMultiplier * numDice * ((faces + 1) / 2);
        }

        throw Error(`Unexpected term ${term} in formula ${formula}`);
    }, 0);
}