d2r-saver 0.1.0

package/dist/formats/d2s-reader.d.ts

@@ -0,0 +1,104 @@
+/**
+ * D2S (character save) reader — Blizzless v105 only.
+ *
+ * Ported from d2planner/src/logic/binary/index.js → parseCharacter().
+ * Simplified: v105 only — all offsets use v105 values.
+ *
+ * Uses GameData instead of global Data singleton.
+ */
+import { GameData } from '../game-data/game-data.js';
+import { type BinaryParsedItem } from './item-parser.js';
+export interface D2SCharacterProfile {
+    name: string;
+    class: string;
+    level: number;
+    stats: {
+        str: number;
+        dex: number;
+        int: number;
+        vit: number;
+    };
+    skills: Record<number, number>;
+    quests: Array<{
+        denofevil: boolean;
+        radamentslair: boolean;
+        thegoldenbird: boolean;
+        lamessenstome: boolean;
+        thefallenangel: boolean;
+        prisonofice: boolean;
+    }>;
+    weaponSet?: number;
+    mercName?: number;
+    merc?: string;
+    mercLevel?: number;
+    /**
+     * Slot maps and arrays carry either numeric item IDs OR string base codes
+     * (for preset items like runes / gems / potions, which are keyed by base
+     * code in the items dict).
+     */
+    items: Record<string, number | string>;
+    mercItems: Record<string, number | string>;
+    inventory: (number | string | undefined)[];
+    cube: (number | string | undefined)[];
+    stash: (number | string | undefined)[];
+    belt: (number | string | undefined)[];
+    /** Gold carried in the character's inventory (the `gold` stat). */
+    gold?: number;
+    /** Gold in the character's personal stash (the `goldbank` stat). */
+    goldStash?: number;
+    /**
+     * Raw character stat map straight from the save (stat name → value), e.g.
+     * strength, dexterity, vitality, energy, level, experience, maxhp, maxmana,
+     * maxstamina, statpts, newskills. Life/mana/stamina are 8.8 fixed-point
+     * (divide by 256 for the displayed integer).
+     */
+    attributes?: Record<string, number>;
+    ironGolem?: number | string;
+    /**
+     * Raw bytes of the v105 "extra sections" tail (typically the 0x666c warlock
+     * demon block). Preserved verbatim from the source file so the writer can
+     * round-trip them unchanged.
+     */
+    extraSections?: number[];
+    /**
+     * Raw bytes [0, 833) of the fixed v105 header, captured verbatim. Lets the
+     * writer round-trip every header field (name, class, merc header, quests,
+     * waypoints, appearance, difficulty, skill hotkeys, timestamps, progression)
+     * without recomputing them. Only filesize + checksum are re-derived on write.
+     */
+    rawHeader?: number[];
+    /** Raw bytes of the corpse section (0x4d4a marker + corpse item lists). */
+    rawCorpse?: number[];
+    /** Raw bytes of the iron-golem section (0x666b marker + optional golem item). */
+    rawGolem?: number[];
+    /**
+     * Parsed warlock bind-demon descriptor when the 0x666c extras block
+     * decodes successfully. Optional and best-effort.
+     */
+    bindDemon?: {
+        revive: 'bind';
+        id: string;
+        monsterType: string;
+        monster: string;
+        area: number;
+        level: number;
+        unit: string;
+        group: string;
+        minion: boolean;
+        skill: string;
+        mods?: string[];
+    };
+}
+export interface D2SReadResult {
+    profile: D2SCharacterProfile;
+    items: Record<number, BinaryParsedItem>;
+    warnings: string[];
+}
+/**
+ * Parse a .d2s character file.
+ *
+ * @param data Raw file bytes
+ * @param gd   GameData instance
+ */
+export declare function readD2S(data: Uint8Array, gd: GameData): D2SReadResult;
+//# sourceMappingURL=d2s-reader.d.ts.map

package/dist/formats/d2s-reader.d.ts.map

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

package/dist/formats/d2s-reader.js

@@ -0,0 +1,257 @@
+/**
+ * D2S (character save) reader — Blizzless v105 only.
+ *
+ * Ported from d2planner/src/logic/binary/index.js → parseCharacter().
+ * Simplified: v105 only — all offsets use v105 values.
+ *
+ * Uses GameData instead of global Data singleton.
+ */
+import { BinaryReader } from '../core/binary-reader.js';
+import { GameData } from '../game-data/game-data.js';
+import { detectFormat } from './detect.js';
+import { createItemParser } from './item-parser.js';
+// ─── Reader ─────────────────────────────────────────────────────
+/**
+ * Parse a .d2s character file.
+ *
+ * @param data Raw file bytes
+ * @param gd   GameData instance
+ */
+export function readD2S(data, gd) {
+    const warnings = [];
+    const fmt = detectFormat(data);
+    if (!fmt || fmt.type !== 'd2s')
+        throw Error('invalid d2s header');
+    const reader = new BinaryReader(data);
+    reader.seek(16);
+    const result = {};
+    // Preserve the fixed 833-byte v105 header verbatim for lossless round-tripping.
+    // (The stats section always starts at offset 833 in this format.)
+    result.rawHeader = Array.from(data.subarray(0, 833));
+    // v105: 4 zero bytes at offset 0x10
+    reader.skip(4);
+    // Name might be at offset 299 (v105)
+    if (!result.name) {
+        const savedPos = reader.bitpos;
+        reader.seek(299);
+        result.name = reader.utf8(16);
+        reader.bitpos = savedPos;
+    }
+    // Class at offset 24 (v105)
+    reader.seek(24);
+    const classId = reader.read8();
+    result.class = GameData.classes[classId] || `unknown_${classId}`;
+    // Merc data at offset 163 (v105)
+    reader.seek(163);
+    const mercId = reader.read32();
+    if (mercId) {
+        result.mercName = reader.read16();
+        result.merc = reader.read16().toString();
+        const mercXP = reader.read32();
+        const mercData = gd.hireling[result.merc]?.[0];
+        if (mercData) {
+            let L = mercData.level;
+            const M = mercData.explvl;
+            while (L < 98 && M * (L + 1) * (L + 1) * (L + 2) <= mercXP) {
+                L += 1;
+            }
+            result.mercLevel = L;
+        }
+    }
+    // Quests
+    function readQuestTable() {
+        return {
+            denofevil: (reader.byte(2) & 1) !== 0,
+            radamentslair: (reader.byte(18) & 1) !== 0,
+            thegoldenbird: (reader.byte(40) & 1) !== 0,
+            lamessenstome: (reader.byte(34) & 1) !== 0,
+            thefallenangel: (reader.byte(50) & 1) !== 0,
+            prisonofice: (reader.byte(74) & 1) !== 0,
+        };
+    }
+    result.quests = [];
+    reader.seek(413); // v105 quest offset normal
+    result.quests.push(readQuestTable());
+    reader.seek(509); // nightmare
+    result.quests.push(readQuestTable());
+    reader.seek(605); // hell
+    result.quests.push(readQuestTable());
+    // Character stats at offset 833 (v105)
+    reader.seek(833);
+    if (reader.read16() !== 0x6667)
+        throw Error('invalid stats header');
+    // Build stat map
+    const statMap = new Map();
+    for (const key in gd.itemStatCost) {
+        statMap.set(gd.itemStatCost[key].id, key);
+    }
+    const charStats = {};
+    while (true) {
+        const statId = reader.bits(9);
+        if (statId === 511)
+            break;
+        const stat = statMap.get(statId);
+        if (!stat)
+            throw Error(`unknown stat code ${statId}`);
+        charStats[stat] = reader.bits(gd.itemStatCost[stat].csvbits ?? 0);
+    }
+    reader.align();
+    const classStats = gd.charStats[result.class];
+    result.stats = {
+        str: charStats.strength - (classStats?.str || 0),
+        dex: charStats.dexterity - (classStats?.dex || 0),
+        int: charStats.energy - (classStats?.int || 0),
+        vit: charStats.vitality - (classStats?.vit || 0),
+    };
+    result.level = charStats.level;
+    result.gold = charStats.gold ?? 0;
+    result.goldStash = charStats.goldbank ?? 0;
+    result.attributes = charStats;
+    // Skills
+    if (reader.read16() !== 0x6669)
+        throw Error('invalid skills header');
+    result.skills = {};
+    const skillBases = [6, 36, 66, 96, 126, 221, 251, 373];
+    const skillBase = skillBases[classId] ?? (classId < 5 ? classId * 30 + 6 : (classId - 5) * 30 + 221);
+    for (let i = 0; i < 30; ++i) {
+        const level = reader.read8();
+        if (level)
+            result.skills[i + skillBase] = level;
+    }
+    // Items
+    const ctx = createItemParser(reader, gd);
+    result.items = {};
+    result.inventory = [];
+    result.cube = [];
+    result.stash = [];
+    result.belt = [];
+    try {
+        ctx.parseItemList((id, location, slot) => {
+            if (location === 'body')
+                result.items[slot] = id;
+            if (location === 'inventory')
+                result.inventory[slot] = id;
+            if (location === 'cube')
+                result.cube[slot] = id;
+            if (location === 'stash')
+                result.stash[slot] = id;
+            if (location === 'belt')
+                result.belt[slot] = id;
+        });
+        // Corpses — captured verbatim so the writer preserves corpse items.
+        const corpseStart = reader.bitpos >> 3;
+        if (reader.read16() !== 0x4d4a)
+            throw Error('invalid item table header');
+        const corpses = reader.read16();
+        reader.skip(corpses * 12);
+        for (let i = 0; i < corpses; ++i) {
+            ctx.parseItemList(() => null);
+        }
+        result.rawCorpse = Array.from(reader.buffer.subarray(corpseStart, reader.bitpos >> 3));
+        // Hireling items
+        if (!reader.eof()) {
+            if (reader.read16() !== 0x666a)
+                throw Error('invalid hireling header');
+            result.mercItems = {};
+            if (reader.byte(0) === 0x4a && reader.byte(1) === 0x4d) {
+                ctx.parseItemList((id, location, slot) => {
+                    if (mercId && location === 'body')
+                        result.mercItems[slot] = id;
+                });
+            }
+        }
+        // Iron golem — captured verbatim so the writer preserves the golem item.
+        if (!reader.eof()) {
+            const golemStart = reader.bitpos >> 3;
+            if (reader.read16() !== 0x666b)
+                throw Error('invalid iron golem header');
+            if (reader.read8()) {
+                ctx.parseItem(ctx.nextId(), id => { result.ironGolem = typeof id === 'number' ? id : 0; });
+            }
+            result.rawGolem = Array.from(reader.buffer.subarray(golemStart, reader.bitpos >> 3));
+        }
+        // Preserve extra sections (0x666c warlock demon data) as raw bytes,
+        // and best-effort parse the bind-demon descriptor.
+        if (!reader.eof()) {
+            const bytePos = reader.bitpos >> 3;
+            result.extraSections = Array.from(reader.buffer.subarray(bytePos));
+            try {
+                if (reader.read16() === 1 && reader.read16() === 0x666c) {
+                    const count = reader.read16();
+                    if (count > 0) {
+                        reader.read16(); // entrySize
+                        const idType = reader.read16(); // 1=normal monster by hcidx, 2=super unique
+                        const binaryId = reader.read16();
+                        const monId = binaryId - 1; // hcidx (1-indexed in binary)
+                        reader.read16(); // skip
+                        const monType = reader.read16(); // 8=unique, 12=champion
+                        reader.read16(); // skip
+                        reader.read8(); // diff
+                        reader.skip(11);
+                        const area = reader.read32();
+                        const level = reader.read32();
+                        reader.skip(48);
+                        let monClass;
+                        let demonId;
+                        let monsterType;
+                        if (idType === 2) {
+                            const su = gd.superUniques?.[String(monId)];
+                            monClass = su?.class;
+                            demonId = String(monId);
+                            monsterType = 'super';
+                        }
+                        else if (idType === 1) {
+                            const entry = Object.entries(gd.monsters).find(([, v]) => v?.hcidx === monId);
+                            monClass = entry?.[0];
+                            demonId = monClass;
+                            monsterType = monType === 12 ? 'champion' : 'unique';
+                        }
+                        if (monClass && demonId && monsterType) {
+                            result.bindDemon = {
+                                revive: 'bind',
+                                id: demonId,
+                                monsterType,
+                                monster: monClass,
+                                area,
+                                level,
+                                unit: `bind_${monClass}`,
+                                group: 'binddemon',
+                                minion: monType !== 16,
+                                skill: '382',
+                            };
+                            const presetMods = idType === 2
+                                ? [
+                                    gd.uniqueMods?.[gd.superUniques?.[String(monId)]?.mod1 ?? '']?.uniquemod,
+                                    gd.uniqueMods?.[gd.superUniques?.[String(monId)]?.mod2 ?? '']?.uniquemod,
+                                    gd.uniqueMods?.[gd.superUniques?.[String(monId)]?.mod3 ?? '']?.uniquemod,
+                                ].filter(Boolean)
+                                : [];
+                            const allMods = new Set();
+                            for (let m = 0; m < 8; m++) {
+                                const um = gd.uniqueMods?.[String(reader.read8())]?.uniquemod;
+                                if (um)
+                                    allMods.add(um);
+                            }
+                            const demonMods = [...allMods].filter(m => !presetMods.includes(m));
+                            if (demonMods.length)
+                                result.bindDemon.mods = demonMods;
+                        }
+                    }
+                }
+            }
+            catch {
+                // best-effort; non-critical
+            }
+        }
+    }
+    catch (e) {
+        const warning = `Item parsing error (some items may be missing): ${e.message}`;
+        warnings.push(warning);
+    }
+    return {
+        profile: result,
+        items: ctx.items,
+        warnings,
+    };
+}
+//# sourceMappingURL=d2s-reader.js.map

package/dist/formats/d2s-reader.js.map

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

package/dist/formats/d2s-writer.d.ts

@@ -0,0 +1,52 @@
+/**
+ * D2S (character save) writer — Blizzless v105 only.
+ *
+ * Ported from d2planner/src/logic/binary/writed2s.js → writeCharacter().
+ * Simplified: v105 only — all version conditionals removed.
+ *
+ * Uses GameData instead of global Data/Locale/Store singletons.
+ * Accepts an explicit profile + items dict instead of reading from state.
+ */
+import { GameData } from '../game-data/game-data.js';
+import type { D2SCharacterProfile } from './d2s-reader.js';
+import type { BinaryParsedItem } from './item-parser.js';
+/**
+ * Options for writeD2S.
+ * Only `profile`, `items`, and `gd` are required.
+ * Everything else has sensible defaults for a Blizzless v105 character.
+ */
+export interface WriteD2SOptions {
+    /** Character profile (as returned by readD2S). */
+    profile: D2SCharacterProfile;
+    /** All items keyed by item ID. */
+    items: Record<number | string, BinaryParsedItem>;
+    /** GameData instance for itemStatCost, charStats, etc. */
+    gd: GameData;
+    /** Override character name (uses profile.name by default). */
+    name?: string;
+    /**
+     * Explicit character stats (base totals = base class + allocated).
+     * If not supplied, stats are computed from profile.stats + charStats base.
+     */
+    charStats?: {
+        strength: number;
+        energy: number;
+        dexterity: number;
+        vitality: number;
+        hitpoints: number;
+        maxhp: number;
+        mana: number;
+        maxmana: number;
+        stamina: number;
+        maxstamina: number;
+        statpts?: number;
+        newskills?: number;
+    };
+}
+/**
+ * Write a complete .d2s character save file (Blizzless v105).
+ *
+ * @returns Raw file bytes ready to be saved.
+ */
+export declare function writeD2S(opts: WriteD2SOptions): Uint8Array;
+//# sourceMappingURL=d2s-writer.d.ts.map

package/dist/formats/d2s-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"d2s-writer.d.ts","sourceRoot":"","sources":["../../src/formats/d2s-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAwBzD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,OAAO,EAAE,mBAAmB,CAAC;IAC7B,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACjD,0DAA0D;IAC1D,EAAE,EAAE,QAAQ,CAAC;IACb,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,SAAS,CAAC,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAID;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,UAAU,CA8J1D"}