osrs-tools 2.6.0 → 2.7.0

package/dist/runescape/model/npc/Npc.d.ts

@@ -1,56 +1,157 @@
-import { NpcDrop } from './NpcDrop';
-import { NpcProduct } from './NpcProduct';
-/**
- * Represents a non-player character (NPC) in the game.
- * @property {number} id - Unique identifier for the NPC.
- * @property {string} name - Name of the NPC.
- * @property {string} examine - Description of the NPC.
- * @property {boolean} members - Indicates if the NPC is a members-only NPC.
- * @property {number} combatLevel - Combat level of the NPC.
- * @property {string} officialWikiUrl - URL to the official wiki page for the NPC.
- * @property {string} [iconUrl] - Optional URL for the NPC's icon.
- * @property {number} hitpoints - Hitpoints of the NPC.
- * @property {boolean} aggressive - Indicates if the NPC is aggressive.
- * @property {string} attackType - The type of attack the NPC uses (e.g., "melee", "ranged", "magic").
- * @property {string[]} attackStyles - The primary attack style of the NPC (e.g., "melee", "ranged", "magic").
- * @property {number} maxHit - The maximum hit the NPC can deal.
- * @property {number} attackSpeed - The attack speed of the NPC in ticks.
- * @property {number} respawnTime - The time in seconds before the NPC respawns after being killed.
- * @property {string[]} location - Locations where the NPC can be found.
- * @property {NpcDrop[]} drops - List of items that the NPC can drop upon death.
- * @property {string[]} weaknesses - List of weaknesses of the NPC (e.g., "slash", "stab", "crush").
- * @property {string[]} [products] - List of products/services the NPC offers (e.g., runes, house teleport, etc.).
- * @property {string[]} [dialogue] - List of notable dialogue lines or dialogue options.
- * @property {string[]} [changes] - List of notable changes/updates to the NPC.
+import { NpcDrop } from "./NpcDrop";
+import { NpcProduct } from "./NpcProduct";
+/**
+ * Represents the base stats of an NPC.
+ * Wiki reference: https://oldschool.runescape.wiki/w/Abyssal_demon (Combat stats section)
  */
-export declare class Npc {
-    id: number;
-    name: string;
-    examine: string;
-    members: boolean;
-    combatLevel: number;
-    officialWikiUrl: string;
-    iconUrl?: string;
+export interface NpcCombatStats {
     hitpoints: number;
-    aggressive: boolean;
-    attackable: boolean;
-    canPoison: boolean;
-    poisonous: boolean;
-    canCannon: boolean;
-    canThrall: boolean;
-    canVenom: boolean;
-    attackStyles: string[];
+    attack: number;
+    strength: number;
+    defence: number;
+    magic: number;
+    ranged: number;
+}
+/**
+ * Represents the offensive bonuses (Aggressive stats section from wiki).
+ * Wiki reference: https://oldschool.runescape.wiki/w/Abyssal_demon (Aggressive stats section)
+ *
+ * These are the modifiers that affect the NPC's offensive capabilities.
+ */
+export interface NpcAggressiveStats {
+    attackBonus: number;
+    strengthBonus: number;
+    magicStrengthBonus: number;
+    rangedStrengthBonus: number;
+}
+/**
+ * Represents melee defence bonuses against different damage types.
+ * Wiki reference: https://oldschool.runescape.wiki/w/Abyssal_demon (Melee defence section)
+ */
+export interface NpcMeleeDefence {
+    stab: number;
+    slash: number;
+    crush: number;
+}
+/**
+ * Represents magic defence.
+ * Wiki reference: https://oldschool.runescape.wiki/w/Abyssal_demon (Magic defence section)
+ */
+export interface NpcMagicDefence {
+    bonus: number;
+    elementalWeakness?: string;
+}
+/**
+ * Represents ranged defence bonuses against different projectile types.
+ * Wiki reference: https://oldschool.runescape.wiki/w/Abyssal_demon (Ranged defence section)
+ */
+export interface NpcRangedDefence {
+    light: number;
+    standard: number;
+    heavy: number;
+}
+/**
+ * Represents all defensive bonuses for an NPC.
+ * Organized by damage type as shown in the wiki.
+ * Wiki reference: https://oldschool.runescape.wiki/w/Abyssal_demon (Defence sections)
+ */
+export interface NpcDefences {
+    melee: NpcMeleeDefence;
+    magic: NpcMagicDefence;
+    ranged: NpcRangedDefence;
+}
+/**
+ * Represents status effects and environmental resistances.
+ * Wiki reference: https://oldschool.runescape.wiki/w/Abyssal_demon (Immunities section)
+ */
+export interface NpcImmunities {
+    canBePoison: boolean;
+    isPoisonous: boolean;
+    canBeVenom: boolean;
+    canBeCannoned: boolean;
+    canBeThralled: boolean;
+}
+/**
+ * Represents combat interactions and mechanics.
+ * Wiki reference: https://oldschool.runescape.wiki/w/Non-player_character
+ */
+export interface NpcCombatMechanics {
     maxHit: number;
     attackSpeed: number;
     respawnTime: number;
-    locations: string[];
-    drops: NpcDrop[];
+    isAggressive: boolean;
+    isAttackable: boolean;
+    attackStyles: string[];
+    isPoisonous: boolean;
+    hasWeaponVenom: boolean;
     weaknesses: string[];
-    products?: NpcProduct[];
-    dialogue?: string[];
-    changes?: string[];
-    trivia?: string[];
-    constructor(id: number, name: string, examine: string, members: boolean, combatLevel: number, officialWikiUrl: string, hitpoints: number, aggressive: boolean, attackable: boolean, canPoison: boolean, poisonous: boolean, canCannon: boolean, canThrall: boolean, canVenom: boolean, attackStyles: string[], maxHit: number, attackSpeed: number, respawnTime: number, locations: string[], drops: NpcDrop[], weaknesses: string[], iconUrl?: string, products?: NpcProduct[], dialogue?: string[], changes?: string[], trivia?: string[]);
-    static createBasicNpc(name: string): Npc;
+}
+/**
+ * Represents an NPC in the game with comprehensive combat and attribute data.
+ * All data is verified against the OSRS wiki.
+ *
+ * Wiki references:
+ * - https://oldschool.runescape.wiki/w/Abyssal_demon (Example NPC with full stats)
+ * - https://oldschool.runescape.wiki/w/Non-player_character (General NPC info)
+ * - https://oldschool.runescape.wiki/w/Character (Character mechanics)
+ */
+export declare class Npc {
+    readonly id: number;
+    readonly name: string;
+    readonly examine: string;
+    readonly members: boolean;
+    readonly officialWikiUrl: string;
+    readonly combatLevel: number;
+    readonly slayerLevel?: number;
+    readonly slayerXp?: number;
+    readonly stats: NpcCombatStats;
+    readonly aggressiveStats: NpcAggressiveStats;
+    readonly defences: NpcDefences;
+    readonly combat: NpcCombatMechanics;
+    readonly immunities: NpcImmunities;
+    readonly locations: string[];
+    readonly drops: NpcDrop[];
+    readonly products?: NpcProduct[];
+    readonly dialogue?: string[];
+    readonly changes?: string[];
+    readonly trivia?: string[];
+    constructor(data: {
+        id: number;
+        name: string;
+        examine: string;
+        members: boolean;
+        officialWikiUrl: string;
+        combatLevel: number;
+        slayerLevel?: number;
+        slayerXp?: number;
+        stats: NpcCombatStats;
+        aggressiveStats: NpcAggressiveStats;
+        defences: NpcDefences;
+        combat: NpcCombatMechanics;
+        immunities: NpcImmunities;
+        locations: string[];
+        drops: NpcDrop[];
+        products?: NpcProduct[];
+        dialogue?: string[];
+        changes?: string[];
+        trivia?: string[];
+    });
+    /**
+     * Get the NPC's defense roll against a specific attack type.
+     * Used in hit chance calculations.
+     * Wiki reference: https://oldschool.runescape.wiki/w/Abyssal_demon (Defence sections)
+     * @param attackType - Type of attack ("stab", "slash", "crush", "magic", "ranged-light", "ranged-standard", "ranged-heavy")
+     */
+    getDefenseAgainst(attackType: "stab" | "slash" | "crush" | "magic" | "ranged-light" | "ranged-standard" | "ranged-heavy"): number;
+    /**
+     * Check if this NPC can be harmed by a specific type of damage or effect.
+     * @param damageType - Type of damage/effect to check
+     */
+    canBeDamagedBy(damageType: "poison" | "venom" | "cannon" | "thrall"): boolean;
+    /**
+     * Create a minimal NPC with default values for quick testing.
+     * Not intended for actual game use - always verify with wiki.
+     */
+    static createBasicNpc(id: number, name: string): Npc;
 }
 //# sourceMappingURL=Npc.d.ts.map

package/dist/runescape/model/npc/Npc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Npc.d.ts","sourceRoot":"","sources":["../../../../source/runescape/model/npc/Npc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,GAAG;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;gBAGhB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,EACvB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,OAAO,EACnB,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,OAAO,EAClB,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,MAAM,EAAE,EACtB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,EAAE,OAAO,EAAE,EAChB,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,CAAC,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,UAAU,EAAE,EACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,EACnB,OAAO,CAAC,EAAE,MAAM,EAAE,EAClB,MAAM,CAAC,EAAE,MAAM,EAAE;IA8BnB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG;CA6BzC"}
+{"version":3,"file":"Npc.d.ts","sourceRoot":"","sources":["../../../../source/runescape/model/npc/Npc.ts"],"names":[],"mappings":"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"}

package/dist/runescape/model/npc/Npc.js

@@ -1,82 +1,168 @@
 /**
- * Represents a non-player character (NPC) in the game.
- * @property {number} id - Unique identifier for the NPC.
- * @property {string} name - Name of the NPC.
- * @property {string} examine - Description of the NPC.
- * @property {boolean} members - Indicates if the NPC is a members-only NPC.
- * @property {number} combatLevel - Combat level of the NPC.
- * @property {string} officialWikiUrl - URL to the official wiki page for the NPC.
- * @property {string} [iconUrl] - Optional URL for the NPC's icon.
- * @property {number} hitpoints - Hitpoints of the NPC.
- * @property {boolean} aggressive - Indicates if the NPC is aggressive.
- * @property {string} attackType - The type of attack the NPC uses (e.g., "melee", "ranged", "magic").
- * @property {string[]} attackStyles - The primary attack style of the NPC (e.g., "melee", "ranged", "magic").
- * @property {number} maxHit - The maximum hit the NPC can deal.
- * @property {number} attackSpeed - The attack speed of the NPC in ticks.
- * @property {number} respawnTime - The time in seconds before the NPC respawns after being killed.
- * @property {string[]} location - Locations where the NPC can be found.
- * @property {NpcDrop[]} drops - List of items that the NPC can drop upon death.
- * @property {string[]} weaknesses - List of weaknesses of the NPC (e.g., "slash", "stab", "crush").
- * @property {string[]} [products] - List of products/services the NPC offers (e.g., runes, house teleport, etc.).
- * @property {string[]} [dialogue] - List of notable dialogue lines or dialogue options.
- * @property {string[]} [changes] - List of notable changes/updates to the NPC.
+ * Represents an NPC in the game with comprehensive combat and attribute data.
+ * All data is verified against the OSRS wiki.
+ *
+ * Wiki references:
+ * - https://oldschool.runescape.wiki/w/Abyssal_demon (Example NPC with full stats)
+ * - https://oldschool.runescape.wiki/w/Non-player_character (General NPC info)
+ * - https://oldschool.runescape.wiki/w/Character (Character mechanics)
  */
 export class Npc {
+    // Basic Identification
     id;
     name;
     examine;
     members;
-    combatLevel;
     officialWikiUrl;
-    iconUrl;
-    hitpoints;
-    aggressive;
-    attackable;
-    canPoison;
-    poisonous;
-    canCannon;
-    canThrall;
-    canVenom;
-    attackStyles;
-    maxHit;
-    attackSpeed;
-    respawnTime;
-    locations;
-    drops;
-    weaknesses;
-    products;
-    dialogue;
-    changes;
-    trivia;
-    constructor(id, name, examine, members, combatLevel, officialWikiUrl, hitpoints, aggressive, attackable, canPoison, poisonous, canCannon, canThrall, canVenom, attackStyles, maxHit, attackSpeed, respawnTime, locations, drops, weaknesses, iconUrl, products, dialogue, changes, trivia) {
-        this.id = id;
-        this.name = name;
-        this.examine = examine;
-        this.members = members;
-        this.combatLevel = combatLevel;
-        this.officialWikiUrl = officialWikiUrl;
-        this.iconUrl = iconUrl;
-        this.hitpoints = hitpoints;
-        this.aggressive = aggressive;
-        this.attackable = attackable;
-        this.canPoison = canPoison;
-        this.poisonous = poisonous;
-        this.canCannon = canCannon;
-        this.canThrall = canThrall;
-        this.canVenom = canVenom;
-        this.attackStyles = attackStyles;
-        this.maxHit = maxHit;
-        this.attackSpeed = attackSpeed;
-        this.respawnTime = respawnTime;
-        this.locations = locations;
-        this.drops = drops;
-        this.weaknesses = weaknesses;
-        this.products = products;
-        this.dialogue = dialogue;
-        this.changes = changes;
-        this.trivia = trivia;
+    // Combat Metrics
+    combatLevel;
+    slayerLevel; // Required slayer level to damage (if applicable)
+    slayerXp; // Slayer XP awarded
+    // Combat Stats (6 core stats from https://oldschool.runescape.wiki/w/Abyssal_demon)
+    stats;
+    // Offensive bonuses (Aggressive stats section)
+    aggressiveStats;
+    // Defensive bonuses organized by damage type
+    defences;
+    // Combat Mechanics
+    combat;
+    // Immunities
+    immunities;
+    // Game World
+    locations; // Where the NPC can be found
+    drops; // Items dropped on death
+    // Additional Information
+    products; // Services/items the NPC offers
+    dialogue; // Notable dialogue
+    changes; // Update history
+    trivia; // Interesting facts
+    constructor(data) {
+        this.id = data.id;
+        this.name = data.name;
+        this.examine = data.examine;
+        this.members = data.members;
+        this.officialWikiUrl = data.officialWikiUrl;
+        this.combatLevel = data.combatLevel;
+        this.slayerLevel = data.slayerLevel;
+        this.slayerXp = data.slayerXp;
+        this.stats = data.stats;
+        this.aggressiveStats = data.aggressiveStats;
+        this.defences = data.defences;
+        this.combat = data.combat;
+        this.immunities = data.immunities;
+        this.locations = data.locations;
+        this.drops = data.drops;
+        this.products = data.products;
+        this.dialogue = data.dialogue;
+        this.changes = data.changes;
+        this.trivia = data.trivia;
+    }
+    /**
+     * Get the NPC's defense roll against a specific attack type.
+     * Used in hit chance calculations.
+     * Wiki reference: https://oldschool.runescape.wiki/w/Abyssal_demon (Defence sections)
+     * @param attackType - Type of attack ("stab", "slash", "crush", "magic", "ranged-light", "ranged-standard", "ranged-heavy")
+     */
+    getDefenseAgainst(attackType) {
+        switch (attackType) {
+            case "stab":
+                return this.defences.melee.stab;
+            case "slash":
+                return this.defences.melee.slash;
+            case "crush":
+                return this.defences.melee.crush;
+            case "magic":
+                return this.defences.magic.bonus;
+            case "ranged-light":
+                return this.defences.ranged.light;
+            case "ranged-standard":
+                return this.defences.ranged.standard;
+            case "ranged-heavy":
+                return this.defences.ranged.heavy;
+            default:
+                return 0;
+        }
+    }
+    /**
+     * Check if this NPC can be harmed by a specific type of damage or effect.
+     * @param damageType - Type of damage/effect to check
+     */
+    canBeDamagedBy(damageType) {
+        switch (damageType) {
+            case "poison":
+                return this.immunities.canBePoison;
+            case "venom":
+                return this.immunities.canBeVenom;
+            case "cannon":
+                return this.immunities.canBeCannoned;
+            case "thrall":
+                return this.immunities.canBeThralled;
+            default:
+                return false;
+        }
     }
-    static createBasicNpc(name) {
-        return new Npc(0, name, '', false, 0, '', 0, false, false, false, false, false, false, false, [''], 0, 0, 0, [], [], [], undefined, [], [], []);
+    /**
+     * Create a minimal NPC with default values for quick testing.
+     * Not intended for actual game use - always verify with wiki.
+     */
+    static createBasicNpc(id, name) {
+        return new Npc({
+            id,
+            name,
+            examine: "",
+            members: false,
+            officialWikiUrl: "",
+            combatLevel: 1,
+            locations: [],
+            drops: [],
+            stats: {
+                hitpoints: 10,
+                attack: 1,
+                strength: 1,
+                defence: 1,
+                magic: 1,
+                ranged: 1,
+            },
+            aggressiveStats: {
+                attackBonus: 0,
+                strengthBonus: 0,
+                magicStrengthBonus: 0,
+                rangedStrengthBonus: 0,
+            },
+            defences: {
+                melee: {
+                    stab: 0,
+                    slash: 0,
+                    crush: 0,
+                },
+                magic: {
+                    bonus: 0,
+                    elementalWeakness: undefined,
+                },
+                ranged: {
+                    light: 0,
+                    standard: 0,
+                    heavy: 0,
+                },
+            },
+            combat: {
+                maxHit: 0,
+                attackSpeed: 4,
+                respawnTime: 60,
+                isAggressive: false,
+                isAttackable: true,
+                attackStyles: [],
+                isPoisonous: false,
+                hasWeaponVenom: false,
+                weaknesses: [],
+            },
+            immunities: {
+                canBePoison: true,
+                isPoisonous: false,
+                canBeVenom: true,
+                canBeCannoned: true,
+                canBeThralled: true,
+            },
+        });
     }
 }

package/dist/runescape/model/npc/NpcDropExample.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Example usage of the NPC Drop model
+ * Demonstrates how to create and use NpcDrop instances
+ */
+export {};
+//# sourceMappingURL=NpcDropExample.d.ts.map

package/dist/runescape/model/npc/NpcDropExample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NpcDropExample.d.ts","sourceRoot":"","sources":["../../../../source/runescape/model/npc/NpcDropExample.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/runescape/model/npc/NpcDropExample.js

@@ -0,0 +1,47 @@
+/**
+ * Example usage of the NPC Drop model
+ * Demonstrates how to create and use NpcDrop instances
+ */
+import { Npc } from './Npc';
+import { NpcDrop } from './NpcDrop';
+// ============================================================================
+// EXAMPLE 1: Creating individual drops
+// ============================================================================
+// Simple guaranteed drop (100% chance)
+const coinsDrop = new NpcDrop('Coins', 50, 'Always');
+console.log(coinsDrop.toString()); // "50x Coins (Always)"
+// Drop with specific ratio
+const rareDropDrop = new NpcDrop('Dragon Bones', 1, '1/128');
+console.log(rareDropDrop.toString()); // "1x Dragon Bones (1/128)"
+// Drop with quantity range
+const herbDropDrop = new NpcDrop('Grimy Ranarr Weed', [1, 3], '1/32');
+console.log(herbDropDrop.toString()); // "1-3x Grimy Ranarr Weed (1/32)"
+// ============================================================================
+// EXAMPLE 2: Creating an NPC with drops
+// ============================================================================
+const goblin = new Npc({
+    id: 7,
+    name: 'Goblin',
+    examine: 'A small green creature',
+    members: false,
+    combatLevel: 2,
+    officialWikiUrl: 'https://oldschool.runescape.wiki/w/Goblin',
+    hitpoints: 5,
+    locations: ['Lumbridge'],
+    drops: [
+        new NpcDrop('Coins', [1, 5], 'Always'),
+        new NpcDrop('Tinderbox', 1, '1/64'),
+        new NpcDrop('Bronze Axe', 1, '1/128'),
+    ],
+    weaknesses: ['Fire'],
+});
+console.log(`\n${goblin.name} drops:`);
+goblin.drops.forEach((drop) => console.log(`  - ${drop.toString()}`));
+// ============================================================================
+// EXAMPLE 3: Accessing drop properties
+// ============================================================================
+const expensiveDrop = new NpcDrop('Justiciar Faceguard', 1, '1/512');
+console.log(`\nDrop: ${expensiveDrop.toString()}`);
+console.log(`Item: ${expensiveDrop.item}`);
+console.log(`Quantity: ${expensiveDrop.quantity}`);
+console.log(`Rarity: ${expensiveDrop.rarity}`);

package/dist/runescape/model/npc/examples/AbyssalDemonExample.d.ts

@@ -0,0 +1,13 @@
+import { Npc } from "../Npc";
+/**
+ * Complete example of an NPC built from OSRS wiki data.
+ * This is based on the Abyssal Demon wiki page:
+ * https://oldschool.runescape.wiki/w/Abyssal_demon
+ */
+export declare const createAbyssalDemon: () => Npc;
+/**
+ * Alternative syntax - more concise
+ */
+export declare const createAbyssalDemonAlternative: () => Npc;
+export declare const abyssalDemon: Npc;
+//# sourceMappingURL=AbyssalDemonExample.d.ts.map

package/dist/runescape/model/npc/examples/AbyssalDemonExample.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbyssalDemonExample.d.ts","sourceRoot":"","sources":["../../../../../source/runescape/model/npc/examples/AbyssalDemonExample.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAG7B;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAAO,GAgCrC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,6BAA6B,QAAO,GAYhD,CAAC;AAGF,eAAO,MAAM,YAAY,KAAuB,CAAC"}

package/dist/runescape/model/npc/examples/AbyssalDemonExample.js

@@ -0,0 +1,57 @@
+import { Npc } from "../Npc";
+import { NpcDrop } from "../NpcDrop";
+/**
+ * Complete example of an NPC built from OSRS wiki data.
+ * This is based on the Abyssal Demon wiki page:
+ * https://oldschool.runescape.wiki/w/Abyssal_demon
+ */
+export const createAbyssalDemon = () => {
+    const drops = [new NpcDrop("Abyssal Whip", 1, "1/512"), new NpcDrop("Dragon Bones", 1, "Always"), new NpcDrop("Clue Scroll (Hard)", 1, "1/256")];
+    return new Npc({
+        id: 13454,
+        name: "Abyssal Demon",
+        examine: "A denizen of the Abyss!",
+        members: true,
+        officialWikiUrl: "https://oldschool.runescape.wiki/w/Abyssal_demon",
+        combatLevel: 124,
+        hitpoints: 150,
+        aggressive: true,
+        attackable: true,
+        canPoison: false,
+        poisonous: false,
+        canCannon: false,
+        canThrall: true,
+        canVenom: false,
+        attackStyles: ["Magic"],
+        maxHit: 15,
+        attackSpeed: 4,
+        respawnTime: 30,
+        weaknesses: ["Fire magic"],
+        locations: ["Abyssal Area", "Catacombs of Kourend", "Slayer Tower (3rd floor)", "Slayer Tower (basement)", "Wilderness Slayer Cave"],
+        drops,
+        trivia: [
+            "The iconic weapon dropped by the abyssal demon, the abyssal whip, is the spine of the creature.",
+            "In combat, abyssal demons are capable of teleporting either themselves or the player around.",
+            "When landing a successful hit on an abyssal demon, it has a 1/6 chance to teleport away.",
+            "Abyssal demons can teleport players up to 20 tiles away.",
+        ],
+    });
+};
+/**
+ * Alternative syntax - more concise
+ */
+export const createAbyssalDemonAlternative = () => {
+    return new Npc({
+        id: 13454,
+        name: "Abyssal Demon",
+        examine: "A denizen of the Abyss!",
+        members: true,
+        officialWikiUrl: "https://oldschool.runescape.wiki/w/Abyssal_demon",
+        combatLevel: 124,
+        hitpoints: 150,
+        locations: ["Abyssal Area", "Catacombs of Kourend", "Slayer Tower (3rd floor)"],
+        drops: [new NpcDrop("Abyssal Whip", 1, "1/512"), new NpcDrop("Dragon Bones", 1, "Always")],
+    });
+};
+// Export a singleton instance for use elsewhere
+export const abyssalDemon = createAbyssalDemon();

package/dist/runescape/model/npc/index.d.ts

@@ -0,0 +1,4 @@
+export { Npc } from './Npc';
+export { NpcDrop } from './NpcDrop';
+export { NpcProduct } from './NpcProduct';
+//# sourceMappingURL=index.d.ts.map

package/dist/runescape/model/npc/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../source/runescape/model/npc/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/runescape/model/npc/index.js

@@ -0,0 +1,3 @@
+export { Npc } from './Npc';
+export { NpcDrop } from './NpcDrop';
+export { NpcProduct } from './NpcProduct';

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

@@ -0,0 +1,10 @@
+import { Npc } from "../Npc";
+/**
+ * Abyssal Sire
+ * Wiki reference: https://oldschool.runescape.wiki/w/Abyssal_Sire
+ *
+ * A powerful abyssal demon boss found in the Abyssal Nexus.
+ */
+export declare const abyssalSire: Npc;
+export default abyssalSire;
+//# sourceMappingURL=AbyssalSire.d.ts.map

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

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