@rpgm-tools/neo-angband-core 0.10.0

package/dist/combat/brand-slay.js

@@ -0,0 +1,264 @@
+/**
+ * Brand and slay selection for combat, ported VERBATIM from
+ * reference/src/obj-slays.c (Angband 4.2.6): get_monster_brand_multiplier and
+ * improve_attack_modifier, plus the small object bonus accessors from
+ * obj-util.c (object_to_hit / object_to_dam). object_weight_one now lives in
+ * obj/object.ts (its curse-aware home); combat imports it from there.
+ *
+ * These live in the combat domain rather than obj/ because they are combat
+ * math and the obj domain does not export them; obj/ owns the Brand/Slay
+ * record shapes and the bound brands[]/slays[] arrays, which are passed in.
+ *
+ * Temporary brands/slays (improve_attack_modifier's obj == NULL path and the
+ * learn helper's allow_temp path, obj-slays.c:378-406,501-503,558-560) are now
+ * ported: the player_has_temporary_brand/slay lookups (obj-slays.c:287-317)
+ * become an injected TempBrandSlay predicate, since the TMD->brand/slay binding
+ * (player_timed.txt brand:/slay:) is resolved by the caller (game layer). Only
+ * melee's py_attack_real / learn_brand_slay_from_melee consult it upstream
+ * (allow_temp = true); the launcher/throw paths pass allow_temp = false.
+ *
+ * DEFERRED (ledgered in parity/ledger/combat-melee.yaml):
+ * - Curse contributions to object_to_hit/to_dam (obj->curses); no object
+ *   carries curses through combat yet. object_weight_one's curse adjustment is
+ *   likewise skipped there, since combat does not thread the curse table.
+ */
+import { tvalIsLauncher, tvalIsWeapon } from "../obj/object.js";
+import { playerKnowsBrand, playerKnowsSlay, playerLearnBrand, playerLearnSlay, } from "../obj/knowledge.js";
+/** object_to_hit(obj): the object's to-hit bonus (curses DEFERRED). */
+export function objectToHit(obj) {
+    return obj.toH;
+}
+/** object_to_dam(obj): the object's to-dam bonus (curses DEFERRED). */
+export function objectToDam(obj) {
+    return obj.toD;
+}
+/**
+ * get_monster_brand_multiplier: the multiplicative factor for a brand hitting
+ * a monster. Elemental vulnerability doubles the extra damage; resistances are
+ * accounted for by the caller (improve_attack_modifier skips resisted brands).
+ */
+export function getMonsterBrandMultiplier(mon, b, isOCombat) {
+    let mult = isOCombat ? b.oMultiplier : b.multiplier;
+    if (b.vulnFlag && mon.race.flags.has(b.vulnFlag)) {
+        /* Especially vulnerable: apply a factor of two to the extra damage. */
+        if (isOCombat) {
+            mult = 2 * (mult - 10) + 10;
+        }
+        else {
+            mult *= 2;
+        }
+    }
+    return mult;
+}
+/**
+ * react_to_specific_slay (obj-slays.c): does this slay affect this monster?
+ */
+function reactToSpecificSlay(s, mon) {
+    if (!s.name)
+        return false;
+    /* Upstream also requires mon->race->base; every bound race has one. */
+    if (s.raceFlag && mon.race.flags.has(s.raceFlag))
+        return true;
+    if (s.base && s.base === mon.race.base.name)
+        return true;
+    return false;
+}
+/**
+ * react_to_slay (obj-slays.c L435): does `obj` carry a slay that would affect
+ * `mon`? Iterates the object's slay runes and returns true on the first whose
+ * race flag or base name matches (react_to_specific_slay). Draws no RNG. Used
+ * by the thief blows (a slay-bearing item resists being stolen) and by the
+ * monster-turn item-pickup guard.
+ */
+export function reactToSlay(obj, mon, slays) {
+    if (!obj.slays)
+        return false;
+    for (let i = 0; i < slays.length; i++) {
+        const s = slays[i];
+        if (s && obj.slays[i] && reactToSpecificSlay(s, mon))
+            return true;
+    }
+    return false;
+}
+/**
+ * improve_attack_modifier: fold the best applicable brand or slay for `obj`
+ * against `mon` into `mod`, updating mod.brand/mod.slay/mod.verb.
+ *
+ * Faithful to upstream, including the quirk that the brand loop sets
+ * mod.brand without clearing mod.slay (only the slay loop clears mod.brand);
+ * the damage code then prefers a set slay. When `obj` is null the loops read
+ * temporary brands/slays from `temp` (player_has_temporary_brand/slay), exactly
+ * as improve_attack_modifier(p, NULL, ...) does; passing no `temp` leaves the
+ * obj == null call a no-op (no temporary brand/slay active).
+ *
+ * \param isOCombat selects the O-combat multipliers (birth_percent_damage);
+ * the standard path passes false.
+ * \param temp temporary brand/slay predicate, consulted only when obj is null.
+ */
+export function improveAttackModifier(obj, mon, brands, slays, mod, range, isOCombat = false, temp) {
+    let bestMult = 1;
+    /* Set the current best multiplier from any already-chosen brand/slay. */
+    if (mod.brand) {
+        const b = brands[mod.brand];
+        bestMult = Math.max(bestMult, getMonsterBrandMultiplier(mon, b, isOCombat));
+    }
+    else if (mod.slay) {
+        const s = slays[mod.slay];
+        const mult = isOCombat ? s.oMultiplier : s.multiplier;
+        bestMult = Math.max(bestMult, mult);
+    }
+    /* Brands */
+    for (let i = 1; i < brands.length; i++) {
+        const b = brands[i];
+        if (!b)
+            continue;
+        if (obj) {
+            if (!obj.brands || !obj.brands[i])
+                continue;
+        }
+        else {
+            /* Temporary brand (player_has_temporary_brand). */
+            if (!temp || !temp.hasBrand(i))
+                continue;
+        }
+        /* Is the monster vulnerable (not resistant)? */
+        if (!mon.race.flags.has(b.resistFlag)) {
+            const mult = getMonsterBrandMultiplier(mon, b, isOCombat);
+            if (bestMult < mult) {
+                bestMult = mult;
+                mod.brand = i;
+                mod.verb = range ? `${b.verb}s` : b.verb;
+            }
+        }
+    }
+    /* Slays */
+    for (let i = 1; i < slays.length; i++) {
+        const s = slays[i];
+        if (!s)
+            continue;
+        if (obj) {
+            if (!obj.slays || !obj.slays[i])
+                continue;
+        }
+        else {
+            /* Temporary slay (player_has_temporary_slay). */
+            if (!temp || !temp.hasSlay(i))
+                continue;
+        }
+        if (reactToSpecificSlay(s, mon)) {
+            const mult = isOCombat ? s.oMultiplier : s.multiplier;
+            if (bestMult < mult) {
+                bestMult = mult;
+                mod.brand = 0;
+                mod.slay = i;
+                mod.verb = range ? s.rangeVerb : s.meleeVerb;
+            }
+        }
+    }
+}
+/** lore_learn_flag_if_visible over the reduced learn target. */
+function loreLearnFlag(mon, flag) {
+    if (flag && mon.lore && mon.visible)
+        mon.lore.flags.on(flag);
+}
+/**
+ * learn_brand_slay_helper (obj-slays.c L463): after an attack, learn the
+ * brand/slay runes carried by the objects involved (and, for melee/throws,
+ * by off-weapon equipment) that the monster did not resist, and note the
+ * monster's resist/vulnerability flags in its lore. Slays are only
+ * learned on visible monsters; brands teach whenever they bite.
+ *
+ * `allowTemp` enables the temporary-brand/slay path (obj-slays.c:501,558):
+ * a temporary brand/slay whose rune the objects do NOT carry still teaches the
+ * monster's lore (resist/vuln/race flags), but does NOT teach the rune itself
+ * (upstream guards player_learn_* on `learn`, which stays false for temp-only).
+ */
+function learnBrandSlayHelper(p, env, obj1, obj2, mon, allowOff, allowTemp, temp) {
+    /* Handle brands. */
+    for (let i = 1; i < env.brands.length; i++) {
+        const b = env.brands[i];
+        if (!b)
+            continue;
+        let learn = Boolean(obj1?.brands?.[i]) || Boolean(obj2?.brands?.[i]);
+        if (allowOff && !learn) {
+            for (let j = 0; j < p.body.count; j++) {
+                const obj = env.slotObject(j);
+                if (obj?.brands?.[i] &&
+                    !tvalIsWeapon(obj.tval) &&
+                    !tvalIsLauncher(obj.tval)) {
+                    learn = true;
+                }
+            }
+        }
+        /* Temporary brand: relevant only if not already carried by an object. */
+        if (!learn && !(allowTemp && (temp?.hasBrand(i) ?? false)))
+            continue;
+        if (!b.resistFlag || !mon.race.flags.has(b.resistFlag)) {
+            /* Learn the rune only from a real object, not a temporary brand. */
+            if (learn)
+                playerLearnBrand(p, env, i);
+            /* Learn about the monster (the flag's known absence / presence). */
+            loreLearnFlag(mon, b.resistFlag);
+            loreLearnFlag(mon, b.vulnFlag);
+        }
+        else if (playerKnowsBrand(p, i)) {
+            /* A known brand fizzles: learn the monster resists. */
+            loreLearnFlag(mon, b.resistFlag);
+        }
+    }
+    /* Handle slays. */
+    for (let i = 1; i < env.slays.length; i++) {
+        const s = env.slays[i];
+        if (!s)
+            continue;
+        let learn = Boolean(obj1?.slays?.[i]) || Boolean(obj2?.slays?.[i]);
+        if (allowOff && !learn) {
+            for (let j = 0; j < p.body.count; j++) {
+                const obj = env.slotObject(j);
+                if (obj?.slays?.[i] &&
+                    !tvalIsWeapon(obj.tval) &&
+                    !tvalIsLauncher(obj.tval)) {
+                    learn = true;
+                }
+            }
+        }
+        /* Temporary slay: relevant only if not already carried by an object. */
+        if (!learn && !(allowTemp && (temp?.hasSlay(i) ?? false)))
+            continue;
+        if (reactToSpecificSlay(s, mon)) {
+            /* Learn about the monster. */
+            loreLearnFlag(mon, s.raceFlag);
+            /* Learn the rune only from a real object on a visible monster. */
+            if (mon.visible && learn)
+                playerLearnSlay(p, env, i);
+        }
+        else if (playerKnowsSlay(p, i)) {
+            /* Learn about unaffected monsters. */
+            loreLearnFlag(mon, s.raceFlag);
+        }
+    }
+}
+/**
+ * learn_brand_slay_from_melee: weapon (or unarmed) plus off-weapon gear, plus
+ * temporary brands/slays (allow_off = true, allow_temp = true).
+ */
+export function learnBrandSlayFromMelee(p, env, weapon, mon, temp) {
+    learnBrandSlayHelper(p, env, weapon, null, mon, true, true, temp);
+}
+/**
+ * learn_brand_slay_from_launch: missile and launcher only (allow_off = false,
+ * allow_temp = false).
+ */
+export function learnBrandSlayFromLaunch(p, env, missile, launcher, mon) {
+    learnBrandSlayHelper(p, env, missile, launcher, mon, false, false);
+}
+/**
+ * learn_brand_slay_from_throw: thrown object only (allow_off = false,
+ * allow_temp = false) - obj-slays.c:633. The previous port passed allow_off
+ * true, which wrongly taught brand/slay runes from worn off-weapon gear on a
+ * throw (gap 3.1).
+ */
+export function learnBrandSlayFromThrow(p, env, missile, mon) {
+    learnBrandSlayHelper(p, env, missile, null, mon, false, false);
+}
+//# sourceMappingURL=brand-slay.js.map

package/dist/combat/brand-slay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brand-slay.js","sourceRoot":"","sources":["../../src/combat/brand-slay.ts"],"names":[],"mappings":"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"}

package/dist/combat/hit.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Shared to-hit and critical-hit machinery, ported VERBATIM from
+ * reference/src/player-attack.c and reference/src/mon-attack.c (Angband
+ * 4.2.6), with the critical constant tables from
+ * reference/lib/gamedata/constants.txt.
+ *
+ * This module ports the DEFAULT (non-O) combat path: test_hit / hit_chance,
+ * the melee/ranged critical chance-and-power formulas, and the critical-level
+ * cutoff tables. It also ports the alternative "O-combat" path
+ * (birth_percent_damage): o_critical_melee / o_critical_shot, the o-*-critical
+ * constants (constants.txt), and apply_deadliness. The O path is a birth
+ * option, off by default; oMeleeDamage / oRangedDamage (melee.ts / ranged.ts)
+ * consume these behind that gate.
+ *
+ * All integer arithmetic reproduces C semantics (Math.trunc for the C `/`).
+ */
+import type { RandomChance, Rng } from "../rng.js";
+/** Adjust BTH per plus-to-hit (player.h BTH_PLUS_ADJ). */
+export declare const BTH_PLUS_ADJ = 3;
+/** Percentage reduction in accuracy for a stunned combatant (mon-timed.h). */
+export declare const STUN_HIT_REDUCTION = 25;
+/** Percentage reduction in damage for a stunned combatant (mon-timed.h). */
+export declare const STUN_DAM_REDUCTION = 25;
+/**
+ * The message key a hit resolves to. These match the upstream MSG_ names used
+ * by the melee/ranged hit_types tables (player-attack.c); the combat code
+ * returns the key and leaves message text/formatting to the UI layer.
+ */
+export type HitType = "MISS" | "HIT" | "HIT_GOOD" | "HIT_GREAT" | "HIT_SUPERB" | "HIT_HI_GREAT" | "HIT_HI_SUPERB" | "SHOOT_HIT";
+/**
+ * hit_chance: the likelihood of a hit roll succeeding for the given to_hit and
+ * ac. Scaled to a denominator of 10,000 to avoid rounding error.
+ *
+ * Always hit 12% of the time, always miss 5% of the time, floor the to-hit at
+ * 9, roll 0..to_hit, and require the roll to reach ac*2/3.
+ */
+export declare function hitChance(toHit: number, ac: number): RandomChance;
+/**
+ * test_hit: determine if a hit roll succeeds against the target AC. Uses the
+ * port's random_chance_check (rng.randomChanceCheck), which is the faithful
+ * WELL-stream equivalent of upstream random_chance_check.
+ */
+export declare function testHit(rng: Rng, toHit: number, ac: number): boolean;
+/**
+ * Success percentage (0..100) for the given to_hit and ac, derived from
+ * hit_chance. Upstream ui-player.c reports the same ratio (numerator / 100).
+ */
+export declare function getHitChance(toHit: number, ac: number): number;
+/** Minimal monster shape the crit code reads (its timed-effect array). */
+export interface DebuffTarget {
+    mTimed: Int16Array;
+}
+/**
+ * is_debuffed: whether a monster is confused, held, afraid or stunned - any
+ * of which makes a critical hit more likely.
+ */
+export declare function isDebuffed(mon: DebuffTarget): boolean;
+/** One critical severity level (constants.txt *-critical-level lines). */
+export interface CriticalLevel {
+    /** Power cutoff; the last level uses -1 as the catch-all sentinel. */
+    cutoff: number;
+    /** Damage multiplier applied to the base damage. */
+    mult: number;
+    /** Flat damage added. */
+    add: number;
+    /** Message key for this severity. */
+    msg: HitType;
+}
+/** melee-critical chance/power scale factors (constants.txt). */
+export declare const MELEE_CRIT: {
+    readonly debuffToh: 10;
+    readonly chanceWeightScl: 1;
+    readonly chanceTohScl: 5;
+    readonly chanceLevelScl: 0;
+    readonly chanceTohSkillScl: 1;
+    readonly chanceOffset: -60;
+    readonly chanceRange: 5000;
+    readonly powerWeightScl: 1;
+    readonly powerRandom: 650;
+};
+/** melee-critical-level cutoffs (constants.txt), in file order (head first). */
+export declare const MELEE_CRIT_LEVELS: readonly CriticalLevel[];
+/** ranged-critical chance/power scale factors (constants.txt). */
+export declare const RANGED_CRIT: {
+    readonly debuffToh: 10;
+    readonly chanceWeightScl: 1;
+    readonly chanceTohScl: 4;
+    readonly chanceLevelScl: 2;
+    readonly chanceLaunchedTohSkillScl: 0;
+    readonly chanceThrownTohSkillScl: 0;
+    readonly chanceOffset: 0;
+    readonly chanceRange: 5000;
+    readonly powerWeightScl: 1;
+    readonly powerRandom: 500;
+};
+/** ranged-critical-level cutoffs (constants.txt), in file order. */
+export declare const RANGED_CRIT_LEVELS: readonly CriticalLevel[];
+/**
+ * Walk the critical-level list for a given power, exactly as the upstream
+ * `while (power >= this_l->cutoff && this_l->next) this_l = this_l->next`.
+ * The head level is the "below the first cutoff" bucket; each cutoff is the
+ * threshold to advance to the next, sharper level; the final entry (cutoff
+ * -1) is the catch-all.
+ */
+export declare function selectCritLevel(power: number, levels: readonly CriticalLevel[]): CriticalLevel;
+/** The player_state fields the critical formulas read. */
+export interface CritActor {
+    /** Player level (p->lev). */
+    lev: number;
+    /** state->to_h. */
+    toH: number;
+    /** state->skills[SKILL_TO_HIT_MELEE]. */
+    meleeSkill: number;
+    /** state->skills[SKILL_TO_HIT_BOW]. */
+    bowSkill: number;
+    /** state->skills[SKILL_TO_HIT_THROW]. */
+    throwSkill: number;
+}
+/** Result of a critical calculation: the (possibly) boosted damage + message. */
+export interface CritResult {
+    damage: number;
+    msg: HitType;
+}
+/**
+ * critical_melee: factor weapon weight, total plusses and player level into a
+ * chance of a critical, then a power that selects a severity level.
+ *
+ * NB: in 4.2.6 the melee critical is critical_melee(); earlier releases named
+ * the equivalent routine critical_norm(). criticalMelee is the faithful port.
+ */
+export declare function criticalMelee(rng: Rng, actor: CritActor, mon: DebuffTarget, weight: number, plus: number, dam: number): CritResult;
+/**
+ * critical_shot: as critical_melee but for shooting/throwing. `launched` is
+ * true for a launcher shot, false for a thrown object. The non-critical
+ * message is SHOOT_HIT (not HIT).
+ */
+export declare function criticalShot(rng: Rng, actor: CritActor, mon: DebuffTarget, weight: number, plus: number, dam: number, launched: boolean): CritResult;
+/** One O-combat critical severity level (constants.txt o-*-critical-level). */
+export interface OCritLevel {
+    /** one_in_(chance) to stop walking at this level (0 = never advances). */
+    chance: number;
+    /** Extra damage dice this level adds. */
+    dice: number;
+    /** Message key for this severity. */
+    msg: HitType;
+}
+/** o-melee-critical scale factors (constants.txt). */
+export declare const O_MELEE_CRIT: {
+    readonly debuffToh: 10;
+    readonly powerTohScaleNum: 1;
+    readonly powerTohScaleDen: 3;
+    readonly chancePowerScaleNum: 1;
+    readonly chancePowerScaleDen: 1;
+    readonly chanceAddDen: 240;
+};
+/** o-melee-critical-level rows (constants.txt), head first. */
+export declare const O_MELEE_CRIT_LEVELS: readonly OCritLevel[];
+/** o-ranged-critical scale factors (constants.txt). */
+export declare const O_RANGED_CRIT: {
+    readonly debuffToh: 10;
+    readonly powerLaunchedTohScaleNum: 1;
+    readonly powerLaunchedTohScaleDen: 1;
+    readonly powerThrownTohScaleNum: 3;
+    readonly powerThrownTohScaleDen: 2;
+    readonly chancePowerScaleNum: 1;
+    readonly chancePowerScaleDen: 1;
+    readonly chanceAddDen: 360;
+};
+/** o-ranged-critical-level rows (constants.txt), head first. */
+export declare const O_RANGED_CRIT_LEVELS: readonly OCritLevel[];
+/** Result of an O-combat critical: extra dice + the severity message. */
+export interface OCritResult {
+    addDice: number;
+    msg: HitType;
+}
+/**
+ * o_critical_melee (player-attack.c L439): the crit-chance is a rational
+ * a*power / (b*power + c); on success, walk the level list for the added dice.
+ * `powerBase` is chance_of_melee_hit_base(p, obj) (computed by the caller).
+ *
+ * RNG: one randint1(chance_den) for the crit test, then (on a crit) the
+ * one_in_ level walk. Non-crit returns msg SHOOT_HIT, faithful to upstream.
+ */
+export declare function oCriticalMelee(rng: Rng, powerBase: number, mon: DebuffTarget): OCritResult;
+/**
+ * o_critical_shot (player-attack.c L351): as oCriticalMelee for shooting
+ * (launched) / throwing. `powerBase` is chance_of_missile_hit_base(p, missile,
+ * launcher). The power scale factor differs for launched vs thrown.
+ */
+export declare function oCriticalShot(rng: Rng, powerBase: number, mon: DebuffTarget, launched: boolean): OCritResult;
+/** deadliness_conversion[151] (player-attack.c L231). */
+export declare const DEADLINESS_CONVERSION: readonly number[];
+/**
+ * apply_deadliness (player-attack.c L261): scale die_average (x100) by the
+ * deadliness bonus. Returns the scaled value (upstream mutates in place).
+ */
+export declare function applyDeadliness(dieAverage: number, deadliness: number): number;
+//# sourceMappingURL=hit.d.ts.map

package/dist/combat/hit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hit.d.ts","sourceRoot":"","sources":["../../src/combat/hit.ts"],"names":[],"mappings":"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"}