osrs-tools 2.6.0 → 2.7.0

package/dist/runescape/model/npc/npcs/DesertLizard.d.ts

@@ -0,0 +1,10 @@
+import { Npc } from "../Npc";
+/**
+ * Desert Lizard
+ * Wiki reference: https://oldschool.runescape.wiki/w/Desert_Lizard
+ *
+ * A lizard native to the Kharid Desert.
+ */
+export declare const desertLizard: Npc;
+export default desertLizard;
+//# sourceMappingURL=DesertLizard.d.ts.map

package/dist/runescape/model/npc/npcs/DesertLizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesertLizard.d.ts","sourceRoot":"","sources":["../../../../../source/runescape/model/npc/npcs/DesertLizard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAG7B;;;;;GAKG;AACH,eAAO,MAAM,YAAY,KA0DvB,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/dist/runescape/model/npc/npcs/DesertLizard.js

@@ -0,0 +1,61 @@
+import { Npc } from "../Npc";
+import { NpcDrop } from "../NpcDrop";
+/**
+ * Desert Lizard
+ * Wiki reference: https://oldschool.runescape.wiki/w/Desert_Lizard
+ *
+ * A lizard native to the Kharid Desert.
+ */
+export const desertLizard = new Npc({
+    id: 1311,
+    name: "Desert Lizard",
+    examine: "A lizard of the desert.",
+    members: false,
+    officialWikiUrl: "https://oldschool.runescape.wiki/w/Desert_Lizard",
+    combatLevel: 22,
+    stats: {
+        hitpoints: 15,
+        attack: 18,
+        strength: 16,
+        defence: 12,
+        magic: 1,
+        ranged: 1,
+    },
+    aggressiveStats: {
+        attackBonus: -15,
+        strengthBonus: -10,
+        magicStrengthBonus: 0,
+        rangedStrengthBonus: 0,
+    },
+    defences: {
+        melee: { stab: -15, slash: -15, crush: -15 },
+        magic: { bonus: -25, elementalWeakness: undefined },
+        ranged: { light: -15, standard: -15, heavy: -15 },
+    },
+    combat: {
+        maxHit: 5,
+        attackSpeed: 5,
+        respawnTime: 30,
+        isAggressive: false,
+        isAttackable: true,
+        attackStyles: ["Melee"],
+        isPoisonous: false,
+        hasWeaponVenom: false,
+        weaknesses: ["Crush"],
+    },
+    immunities: {
+        canBePoison: false,
+        isPoisonous: false,
+        canBeVenom: false,
+        canBeCannoned: true,
+        canBeThralled: true,
+    },
+    locations: ["Kharid Desert"],
+    drops: [new NpcDrop("Bones", 1, "Always")],
+    trivia: [
+        "Native to the Kharid Desert",
+        "Adapted to hot arid climates",
+        "Low-level slayer creature",
+    ],
+});
+export default desertLizard;

package/dist/runescape/model/npc/npcs/DesertWolf.d.ts

@@ -0,0 +1,10 @@
+import { Npc } from "../Npc";
+/**
+ * Desert Wolf
+ * Wiki reference: https://oldschool.runescape.wiki/w/Desert_Wolf
+ *
+ * A dangerous wolf adapted to life in the desert.
+ */
+export declare const desertWolf: Npc;
+export default desertWolf;
+//# sourceMappingURL=DesertWolf.d.ts.map

package/dist/runescape/model/npc/npcs/DesertWolf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesertWolf.d.ts","sourceRoot":"","sources":["../../../../../source/runescape/model/npc/npcs/DesertWolf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAG7B;;;;;GAKG;AACH,eAAO,MAAM,UAAU,KA0DrB,CAAC;AAEH,eAAe,UAAU,CAAC"}

package/dist/runescape/model/npc/npcs/DesertWolf.js

@@ -0,0 +1,61 @@
+import { Npc } from "../Npc";
+import { NpcDrop } from "../NpcDrop";
+/**
+ * Desert Wolf
+ * Wiki reference: https://oldschool.runescape.wiki/w/Desert_Wolf
+ *
+ * A dangerous wolf adapted to life in the desert.
+ */
+export const desertWolf = new Npc({
+    id: 6593,
+    name: "Desert Wolf",
+    examine: "A wolf of the desert.",
+    members: true,
+    officialWikiUrl: "https://oldschool.runescape.wiki/w/Desert_Wolf",
+    combatLevel: 128,
+    stats: {
+        hitpoints: 80,
+        attack: 85,
+        strength: 90,
+        defence: 75,
+        magic: 1,
+        ranged: 1,
+    },
+    aggressiveStats: {
+        attackBonus: 30,
+        strengthBonus: 35,
+        magicStrengthBonus: 0,
+        rangedStrengthBonus: 0,
+    },
+    defences: {
+        melee: { stab: 15, slash: 15, crush: 15 },
+        magic: { bonus: -40, elementalWeakness: undefined },
+        ranged: { light: 10, standard: 10, heavy: 10 },
+    },
+    combat: {
+        maxHit: 28,
+        attackSpeed: 5,
+        respawnTime: 30,
+        isAggressive: true,
+        isAttackable: true,
+        attackStyles: ["Melee"],
+        isPoisonous: false,
+        hasWeaponVenom: false,
+        weaknesses: ["Crush"],
+    },
+    immunities: {
+        canBePoison: false,
+        isPoisonous: false,
+        canBeVenom: false,
+        canBeCannoned: false,
+        canBeThralled: true,
+    },
+    locations: ["Desert"],
+    drops: [new NpcDrop("Bones", 1, "Always")],
+    trivia: [
+        "Aggressive desert-dwelling predator",
+        "Adapted to hot arid climates",
+        "Members-only content",
+    ],
+});
+export default desertWolf;

package/dist/runescape/model/npc/npcs/DeviantSpectres.d.ts

@@ -0,0 +1,10 @@
+import { Npc } from "../Npc";
+/**
+ * Deviant Spectres
+ * Wiki reference: https://oldschool.runescape.wiki/w/Deviant_spectre
+ *
+ * An unusual variant of Aberrant spectre found in the Slayer Tower.
+ */
+export declare const deviantSpectres: Npc;
+export default deviantSpectres;
+//# sourceMappingURL=DeviantSpectres.d.ts.map

package/dist/runescape/model/npc/npcs/DeviantSpectres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviantSpectres.d.ts","sourceRoot":"","sources":["../../../../../source/runescape/model/npc/npcs/DeviantSpectres.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAG7B;;;;;GAKG;AACH,eAAO,MAAM,eAAe,KA6D1B,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/dist/runescape/model/npc/npcs/DeviantSpectres.js

@@ -0,0 +1,64 @@
+import { Npc } from "../Npc";
+import { NpcDrop } from "../NpcDrop";
+/**
+ * Deviant Spectres
+ * Wiki reference: https://oldschool.runescape.wiki/w/Deviant_spectre
+ *
+ * An unusual variant of Aberrant spectre found in the Slayer Tower.
+ */
+export const deviantSpectres = new Npc({
+    id: 7296,
+    name: "Deviant spectres",
+    examine: "An unusual Aberrant spectre.",
+    members: true,
+    officialWikiUrl: "https://oldschool.runescape.wiki/w/Deviant_spectre",
+    combatLevel: 162,
+    stats: {
+        hitpoints: 140,
+        attack: 90,
+        strength: 80,
+        defence: 85,
+        magic: 95,
+        ranged: 60,
+    },
+    aggressiveStats: {
+        attackBonus: 40,
+        strengthBonus: 30,
+        magicStrengthBonus: 45,
+        rangedStrengthBonus: 0,
+    },
+    defences: {
+        melee: { stab: 25, slash: 25, crush: 20 },
+        magic: { bonus: 30, elementalWeakness: undefined },
+        ranged: { light: 20, standard: 20, heavy: 15 },
+    },
+    combat: {
+        maxHit: 35,
+        attackSpeed: 5,
+        respawnTime: 30,
+        isAggressive: true,
+        isAttackable: true,
+        attackStyles: ["Magic"],
+        isPoisonous: true,
+        hasWeaponVenom: true,
+        weaknesses: ["Fire"],
+    },
+    immunities: {
+        canBePoison: true,
+        isPoisonous: true,
+        canBeVenom: false,
+        canBeCannoned: false,
+        canBeThralled: true,
+    },
+    locations: ["Slayer Tower"],
+    drops: [
+        new NpcDrop("Slayer's respite", 1, "1/64"),
+        new NpcDrop("Ancient shard", 1, "1/128"),
+    ],
+    trivia: [
+        "Unusual Aberrant spectre variant",
+        "Found in Slayer Tower",
+        "Poisonous creature",
+    ],
+});
+export default deviantSpectres;

package/dist/runescape/model/npc/npcs/DireWolf.d.ts

@@ -0,0 +1,10 @@
+import { Npc } from "../Npc";
+/**
+ * Dire Wolf
+ * Wiki reference: https://oldschool.runescape.wiki/w/Dire_wolf
+ *
+ * A fearsome wolf found in the Wilderness.
+ */
+export declare const direWolf: Npc;
+export default direWolf;
+//# sourceMappingURL=DireWolf.d.ts.map

package/dist/runescape/model/npc/npcs/DireWolf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DireWolf.d.ts","sourceRoot":"","sources":["../../../../../source/runescape/model/npc/npcs/DireWolf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAG7B;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,KA0DnB,CAAC;AAEH,eAAe,QAAQ,CAAC"}

package/dist/runescape/model/npc/npcs/DireWolf.js

@@ -0,0 +1,61 @@
+import { Npc } from "../Npc";
+import { NpcDrop } from "../NpcDrop";
+/**
+ * Dire Wolf
+ * Wiki reference: https://oldschool.runescape.wiki/w/Dire_wolf
+ *
+ * A fearsome wolf found in the Wilderness.
+ */
+export const direWolf = new Npc({
+    id: 6593,
+    name: "Dire Wolf",
+    examine: "A fearsome wolf.",
+    members: true,
+    officialWikiUrl: "https://oldschool.runescape.wiki/w/Dire_wolf",
+    combatLevel: 128,
+    stats: {
+        hitpoints: 80,
+        attack: 85,
+        strength: 90,
+        defence: 75,
+        magic: 1,
+        ranged: 1,
+    },
+    aggressiveStats: {
+        attackBonus: 30,
+        strengthBonus: 35,
+        magicStrengthBonus: 0,
+        rangedStrengthBonus: 0,
+    },
+    defences: {
+        melee: { stab: 15, slash: 15, crush: 15 },
+        magic: { bonus: -40, elementalWeakness: undefined },
+        ranged: { light: 10, standard: 10, heavy: 10 },
+    },
+    combat: {
+        maxHit: 28,
+        attackSpeed: 5,
+        respawnTime: 30,
+        isAggressive: true,
+        isAttackable: true,
+        attackStyles: ["Melee"],
+        isPoisonous: false,
+        hasWeaponVenom: false,
+        weaknesses: ["Crush"],
+    },
+    immunities: {
+        canBePoison: false,
+        isPoisonous: false,
+        canBeVenom: false,
+        canBeCannoned: false,
+        canBeThralled: true,
+    },
+    locations: ["Wilderness"],
+    drops: [new NpcDrop("Bones", 1, "Always")],
+    trivia: [
+        "Fearsome wilderness predator",
+        "High damage output",
+        "Members-only content",
+    ],
+});
+export default direWolf;

package/dist/runescape/model/npc/npcs/DropImplementationUtils.d.ts

@@ -0,0 +1,223 @@
+/**
+ * NPC Drop Implementation Utilities
+ * Helpers for efficiently implementing drops across all NPCs
+ *
+ * Usage:
+ * - Use templates for quick NPC generation
+ * - Leverage shared drop definitions
+ * - Validate drops before committing
+ * - Batch update similar NPCs
+ */
+import { NpcDrop } from "../NpcDrop";
+import { CompleteDropTable, WeightedDropTable } from "../ComplexDropSystems";
+/**
+ * ============================================================================
+ * SECTION 1: Common Drop Definitions (DRY Principle)
+ * ============================================================================
+ */
+/**
+ * Standard drops used by many NPCs
+ * Avoids duplication and keeps data consistent
+ */
+export declare const STANDARD_DROPS: {
+    readonly bones: NpcDrop;
+    readonly bigBones: NpcDrop;
+    readonly babyBones: NpcDrop;
+    readonly coinsSmall: () => NpcDrop;
+    readonly coinsMedium: () => NpcDrop;
+    readonly coinsLarge: () => NpcDrop;
+    readonly bones_tertiary: NpcDrop;
+    readonly ashesGrimy: NpcDrop;
+    readonly clueScrollEasy: NpcDrop;
+    readonly clueScrollMedium: NpcDrop;
+};
+/**
+ * ============================================================================
+ * SECTION 2: Drop Probability Helpers
+ * ============================================================================
+ */
+/**
+ * Common drop rate constants for easy reference
+ * Makes probabilities more readable in code
+ */
+export declare const DROP_RATES: {
+    readonly ALWAYS: "Always";
+    readonly COMMON_1_2: "1/2";
+    readonly COMMON_1_4: "1/4";
+    readonly COMMON_1_8: "1/8";
+    readonly FREQUENT_1_16: "1/16";
+    readonly FREQUENT_1_32: "1/32";
+    readonly FREQUENT_1_64: "1/64";
+    readonly UNCOMMON_1_128: "1/128";
+    readonly UNCOMMON_1_256: "1/256";
+    readonly RARE_1_512: "1/512";
+    readonly RARE_1_1024: "1/1024";
+    readonly VERY_RARE_1_5000: "1/5000";
+};
+/**
+ * ============================================================================
+ * SECTION 3: NPC Category Templates
+ * ============================================================================
+ */
+/**
+ * Template for simple combat NPCs (80% of NPCs)
+ * Usage: Copy and fill in the item names
+ */
+export interface SimpleNPCDropTemplate {
+    guaranteed: NpcDrop[];
+    tertiary?: NpcDrop[];
+    questOnly?: NpcDrop[];
+}
+/**
+ * Create a simple NPC drop list from template
+ */
+export declare function createSimpleNPCDrops(template: SimpleNPCDropTemplate): NpcDrop[];
+/**
+ * Template for boss NPCs with multi-roll systems
+ */
+export interface BossNPCDropTemplate {
+    primaryDrops: NpcDrop[];
+    secondaryDrops?: NpcDrop[];
+    tertiaryDrops?: NpcDrop[];
+    rareDrops?: {
+        item: NpcDrop;
+        weight: number;
+    }[];
+    uniqueRate?: string;
+}
+/**
+ * Create a boss drop table from template
+ */
+export declare function createBossNPCDrops(template: BossNPCDropTemplate): CompleteDropTable;
+/**
+ * ============================================================================
+ * SECTION 4: NPC Category Builders
+ * ============================================================================
+ */
+/**
+ * Build drops for dragon types
+ * Dragons share similar drop patterns with variations
+ */
+export declare function createDragonDrops(options: {
+    tier: "baby" | "chromatic" | "metallic" | "elder";
+    hasUniqueDrops?: boolean;
+}): NpcDrop[];
+/**
+ * Build drops for demon types
+ * Most demons have similar drops with rarity variations
+ */
+export declare function createDemonDrops(options: {
+    tier: "lesser" | "greater" | "black" | "abyssal";
+}): NpcDrop[];
+/**
+ * Build drops for various rats
+ * Rats have consistent patterns but vary in drop value
+ */
+export declare function createRatDrops(options: {
+    size: "small" | "giant" | "behemoth";
+    area?: "dungeon" | "crypt" | "cave";
+}): NpcDrop[];
+/**
+ * ============================================================================
+ * SECTION 5: Shared Drop Table Registry
+ * ============================================================================
+ */
+/**
+ * Centralized location for shared drop tables
+ * Prevents duplication across similar NPCs
+ */
+export declare const SharedDropTables: {
+    gwd: {
+        rareTable: WeightedDropTable | null;
+        initialize: () => WeightedDropTable;
+    };
+    bossUniqueSmallTable: WeightedDropTable | null;
+    initializeAll: () => void;
+};
+/**
+ * ============================================================================
+ * SECTION 6: Validation & Quality Checks
+ * ============================================================================
+ */
+export interface DropValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Validate a complete drop table
+ */
+export declare function validateNPCDrops(npcName: string, drops: NpcDrop[], options?: {
+    allowDuplicates?: boolean;
+    checkWikiUrl?: string;
+}): DropValidationResult;
+/**
+ * ============================================================================
+ * SECTION 7: Implementation Helpers
+ * ============================================================================
+ */
+/**
+ * Get all NPCs that should have drops by category
+ */
+export declare function getNPCsByCategory(category: "boss" | "combat" | "slayer" | "animal" | "other"): string[];
+/**
+ * Create implementation checklist for a batch of NPCs
+ */
+export declare function createImplementationChecklist(npcs: string[]): string;
+/**
+ * ============================================================================
+ * SECTION 8: Quick Start Examples
+ * ============================================================================
+ */
+/**
+ * Example 1: Quick implementation of a simple combat NPC
+ */
+export declare const EXAMPLE_SimpleCombat: {
+    name: string;
+    drops: NpcDrop[];
+};
+/**
+ * Example 2: Quick implementation of a dragon type
+ */
+export declare const EXAMPLE_Dragon: {
+    name: string;
+    drops: NpcDrop[];
+};
+/**
+ * Example 3: Quick implementation of a boss
+ */
+export declare function EXAMPLE_CreateBoss(): CompleteDropTable;
+/**
+ * ============================================================================
+ * USAGE GUIDE
+ * ============================================================================
+ *
+ * For Simple NPCs:
+ * ================
+ * const drops = createSimpleNPCDrops({
+ *   guaranteed: [STANDARD_DROPS.bones, coinDrop],
+ *   tertiary: [clueScroll],
+ * });
+ *
+ * For Dragons:
+ * ============
+ * const drops = createDragonDrops({ tier: 'baby', hasUniqueDrops: false });
+ *
+ * For Demons:
+ * ===========
+ * const drops = createDemonDrops({ tier: 'lesser' });
+ *
+ * For Bosses:
+ * ===========
+ * const table = createBossNPCDrops({
+ *   primaryDrops: [...],
+ *   rareDrops: [...],
+ *   uniqueRate: DROP_RATES.RARE_1_512,
+ * });
+ *
+ * For Validation:
+ * ================
+ * const result = validateNPCDrops('Boss Name', drops);
+ * if (!result.valid) console.error(result.errors);
+ */
+//# sourceMappingURL=DropImplementationUtils.d.ts.map

package/dist/runescape/model/npc/npcs/DropImplementationUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DropImplementationUtils.d.ts","sourceRoot":"","sources":["../../../../../source/runescape/model/npc/npcs/DropImplementationUtils.ts"],"names":[],"mappings":"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"}