osrs-tools 2.5.4 → 2.7.0

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

@@ -0,0 +1,10 @@
+import { Npc } from "../Npc";
+/**
+ * Guard Dog
+ * Wiki reference: https://oldschool.runescape.wiki/w/Guard_dog
+ *
+ * A fierce guard dog used to protect valuable locations.
+ */
+export declare const guardDog: Npc;
+export default guardDog;
+//# sourceMappingURL=GuardDog.d.ts.map

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

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

@@ -0,0 +1,61 @@
+import { Npc } from "../Npc";
+import { NpcDrop } from "../NpcDrop";
+/**
+ * Guard Dog
+ * Wiki reference: https://oldschool.runescape.wiki/w/Guard_dog
+ *
+ * A fierce guard dog used to protect valuable locations.
+ */
+export const guardDog = new Npc({
+    id: 1596,
+    name: "Guard dog",
+    examine: "A fierce guard dog.",
+    members: false,
+    officialWikiUrl: "https://oldschool.runescape.wiki/w/Guard_dog",
+    combatLevel: 26,
+    stats: {
+        hitpoints: 20,
+        attack: 23,
+        strength: 20,
+        defence: 16,
+        magic: 1,
+        ranged: 1,
+    },
+    aggressiveStats: {
+        attackBonus: -5,
+        strengthBonus: 5,
+        magicStrengthBonus: 0,
+        rangedStrengthBonus: 0,
+    },
+    defences: {
+        melee: { stab: 0, slash: 0, crush: 0 },
+        magic: { bonus: -25, elementalWeakness: undefined },
+        ranged: { light: 0, standard: 0, heavy: 0 },
+    },
+    combat: {
+        maxHit: 8,
+        attackSpeed: 5,
+        respawnTime: 30,
+        isAggressive: true,
+        isAttackable: true,
+        attackStyles: ["Melee"],
+        isPoisonous: false,
+        hasWeaponVenom: false,
+        weaknesses: ["Crush"],
+    },
+    immunities: {
+        canBePoison: false,
+        isPoisonous: false,
+        canBeVenom: false,
+        canBeCannoned: true,
+        canBeThralled: true,
+    },
+    locations: ["Various"],
+    drops: [new NpcDrop("Bones", 1, "Always")],
+    trivia: [
+        "Aggressive guard dog",
+        "Fierce protector of locations",
+        "Low-level combat",
+    ],
+});
+export default guardDog;

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

@@ -1,6 +1,10 @@
-import { Npc } from '../Npc';
-import { NpcDrop } from '../NpcDrop';
-export declare const hansDrops: NpcDrop[];
-export declare const hansLocations: string[];
-export declare const Hans: Npc;
+import { Npc } from "../Npc";
+/**
+ * Hans
+ * Wiki reference: https://oldschool.runescape.wiki/w/Hans
+ *
+ * The loyal servant of Duke Horacio. Hans is a non-attackable NPC.
+ */
+export declare const hans: Npc;
+export default hans;
 //# sourceMappingURL=Hans.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Hans.d.ts","sourceRoot":"","sources":["../../../../../source/runescape/model/npc/npcs/Hans.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAErC,eAAO,MAAM,SAAS,EAAE,OAAO,EAE9B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,MAAM,EAAyB,CAAC;AAE5D,eAAO,MAAM,IAAI,KAsBhB,CAAC"}
+{"version":3,"file":"Hans.d.ts","sourceRoot":"","sources":["../../../../../source/runescape/model/npc/npcs/Hans.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAG7B;;;;;GAKG;AACH,eAAO,MAAM,IAAI,KAsDf,CAAC;AAEH,eAAe,IAAI,CAAC"}

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

@@ -1,21 +1,56 @@
-import { Npc } from '../Npc';
-export const hansDrops = [
-// Hans does not drop anything when killed (not attackable in OSRS)
-];
-export const hansLocations = ['Lumbridge Castle'];
-export const Hans = new Npc(2, // id (arbitrary, unique within your system)
-'Hans', 'The loyal servant of Duke Horacio, found walking around Lumbridge Castle.', false, // members
-1, // combat level (not attackable, but shown as 1 in some sources)
-'https://oldschool.runescape.wiki/w/Hans', 1, // hitpoints (not attackable, but set to 1 for completeness)
-false, // aggressive
-false, // attackable
-false, // canPoison
-false, // poisonous
-false, // canCannon
-false, // canThrall
-false, // canVenom
-['none'], // attackStyle
-0, // maxHit
-0, // attackSpeed
-0, // respawnTime
-hansLocations, hansDrops, []);
+import { Npc } from "../Npc";
+/**
+ * Hans
+ * Wiki reference: https://oldschool.runescape.wiki/w/Hans
+ *
+ * The loyal servant of Duke Horacio. Hans is a non-attackable NPC.
+ */
+export const hans = new Npc({
+    id: 2,
+    name: "Hans",
+    examine: "The loyal servant of Duke Horacio, found walking around Lumbridge Castle.",
+    members: false,
+    officialWikiUrl: "https://oldschool.runescape.wiki/w/Hans",
+    combatLevel: 1,
+    stats: {
+        hitpoints: 1,
+        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: 0,
+        respawnTime: 0,
+        isAggressive: false,
+        isAttackable: false,
+        attackStyles: [],
+        isPoisonous: false,
+        hasWeaponVenom: false,
+        weaknesses: [],
+    },
+    immunities: {
+        canBePoison: false,
+        isPoisonous: false,
+        canBeVenom: false,
+        canBeCannoned: false,
+        canBeThralled: false,
+    },
+    locations: ["Lumbridge Castle"],
+    drops: [],
+    trivia: ["The loyal servant of Duke Horacio", "Non-attackable NPC", "Found walking around Lumbridge Castle"],
+});
+export default hans;

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

@@ -0,0 +1,8 @@
+import { Npc } from '../Npc';
+/**
+ * Hell-Rat Behemoth
+ * A massive rat from the infernal depths of the Warped Dungeon, a creature of pure demonic nature.
+ * Wiki: https://oldschool.runescape.wiki/w/Hell-Rat_Behemoth
+ */
+export declare const hellRatBehemoth: Npc;
+//# sourceMappingURL=HellRatBehemoth.d.ts.map

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

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

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

@@ -0,0 +1,66 @@
+import { Npc } from '../Npc';
+import { NpcDrop } from '../NpcDrop';
+/**
+ * Hell-Rat Behemoth
+ * A massive rat from the infernal depths of the Warped Dungeon, a creature of pure demonic nature.
+ * Wiki: https://oldschool.runescape.wiki/w/Hell-Rat_Behemoth
+ */
+export const hellRatBehemoth = new Npc({
+    id: 1300,
+    name: 'Hell-Rat Behemoth',
+    examine: 'A massive rat from hell.',
+    members: true,
+    officialWikiUrl: 'https://oldschool.runescape.wiki/w/Hell-Rat_Behemoth',
+    combatLevel: 275,
+    stats: {
+        hitpoints: 300,
+        attack: 180,
+        strength: 200,
+        defence: 160,
+        magic: 80,
+        ranged: 80,
+    },
+    aggressiveStats: {
+        attackBonus: 140,
+        strengthBonus: 160,
+        magicStrengthBonus: 0,
+        rangedStrengthBonus: 0,
+    },
+    defences: {
+        melee: { stab: 40, slash: 50, crush: 35 },
+        magic: { bonus: 20, elementalWeakness: 'None' },
+        ranged: { light: 45, standard: 45, heavy: 45 },
+    },
+    combat: {
+        maxHit: 50,
+        attackSpeed: 5,
+        respawnTime: 30,
+        isAggressive: true,
+        isAttackable: true,
+        attackStyles: ['Crush'],
+        isPoisonous: false,
+        hasWeaponVenom: false,
+        weaknesses: [],
+    },
+    immunities: {
+        canBePoison: true,
+        isPoisonous: false,
+        canBeVenom: true,
+        canBeCannoned: true,
+        canBeThralled: true,
+    },
+    locations: ['Warped Dungeon'],
+    drops: [
+        new NpcDrop(`Bones, `, 1, `1),
+  ],
+  trivia: [
+    'The Hell-Rat Behemoth is one of the most dangerous creatures in the Warped Dungeon.',
+    'It comes from the infernal depths of the demon realm.',
+    'This massive rat is a manifestation of pure hellish power.',
+  ],
+});
+
+export default HellRatBehemoth;
+        )
+    ]
+});

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

@@ -0,0 +1,143 @@
+/**
+ * PRACTICAL IMPLEMENTATION EXAMPLE
+ * ==============================================================
+ *
+ * This file demonstrates how to implement drops for multiple NPCs
+ * following the recommendations from IMPLEMENTATION_STRATEGY.md
+ * and using the utilities from DropImplementationUtils.ts
+ *
+ * BATCH 1: Dragon Types (5 NPCs)
+ * - Baby Black Dragon
+ * - Baby Blue Dragon
+ * - Baby Green Dragon
+ * - Baby Red Dragon
+ * - Chromatic Dragons (parent type)
+ */
+import { Npc } from '../Npc';
+import { NpcDrop } from '../NpcDrop';
+/**
+ * Baby Black Dragon
+ * Location: Taverly Dungeon
+ * Level: 79 Combat
+ * Wiki: https://oldschool.runescape.wiki/w/Baby_black_dragon
+ */
+export declare const BabyBlackDragon: Npc;
+/**
+ * Baby Blue Dragon
+ * Location: Taverley Dungeon
+ * Level: 49 Combat
+ * Wiki: https://oldschool.runescape.wiki/w/Baby_blue_dragon
+ */
+export declare const BabyBlueDragon: Npc;
+/**
+ * Baby Green Dragon
+ * Location: Taverly Dungeon
+ * Level: 42 Combat
+ * Wiki: https://oldschool.runescape.wiki/w/Baby_green_dragon
+ *
+ * NOTE: This could use shared drops via template since all baby dragons
+ *       have essentially identical drops
+ */
+export declare const BabyGreenDragon: Npc;
+/**
+ * Lesser Demon
+ * Locations: Dungeons across RuneScape
+ * Level: 7 Combat
+ * Wiki: https://oldschool.runescape.wiki/w/Lesser_demon
+ */
+export declare const LesserDemon: Npc;
+/**
+ * Greater Demon
+ * Location: Demonic Ruins, Wilderness
+ * Level: 82 Combat
+ * Wiki: https://oldschool.runescape.wiki/w/Greater_demon
+ */
+export declare const GreaterDemon: Npc;
+/**
+ * Chicken
+ * Location: Various (Lumbridge, Falador, etc.)
+ * Level: 1 Combat
+ * Wiki: https://oldschool.runescape.wiki/w/Chicken
+ *
+ * Simple template - easily replicable for other animals
+ */
+export declare const ChickenDrops: NpcDrop[];
+export declare const Chicken: Npc;
+export declare const Cerberus: Npc;
+/**
+ * Copy this for each new batch:
+ *
+ * BATCH [X]: [Category] NPCs ([Count] NPCs)
+ * ==========================================
+ *
+ * NPCs to implement:
+ * [ ] NPC Name 1
+ * [ ] NPC Name 2
+ * [ ] NPC Name 3
+ *
+ * Research phase:
+ * [ ] All wiki pages reviewed
+ * [ ] Drop rates verified
+ * [ ] Shared drops identified
+ *
+ * Implementation:
+ * [ ] Drop utilities/templates prepared
+ * [ ] Code written and reviewed
+ * [ ] Tests added
+ * [ ] Validation passes
+ * [ ] No syntax errors
+ *
+ * Quality assurance:
+ * [ ] All drop rates match wiki
+ * [ ] No duplicate item drops
+ * [ ] Proper probability distribution
+ * [ ] Edge cases handled
+ *
+ * Documentation:
+ * [ ] Wiki URLs included in code
+ * [ ] Comments explain non-obvious drops
+ * [ ] Team notified of new drops
+ */
+/**
+ * 1. USE TEMPLATES FOR SIMILAR NPCs
+ *    - All baby dragons use createDragonDrops({ tier: 'baby' })
+ *    - Reduces duplication and maintains consistency
+ *
+ * 2. INCLUDE WIKI REFERENCES
+ *    - Every NPC has officialWikiUrl
+ *    - Comments reference wiki for verification
+ *
+ * 3. USE HELPER FUNCTIONS
+ *    - createDragonDrops()
+ *    - createDemonDrops()
+ *    - createBossNPCDrops()
+ *    - Makes code cleaner and more maintainable
+ *
+ * 4. LEVERAGE CONSTANTS
+ *    - DROP_RATES.RARE_1_512 is clearer than '1/512'
+ *    - STANDARD_DROPS.bones is reusable
+ *
+ * 5. BATCH SIMILAR NPCS TOGETHER
+ *    - Dragons together (share templates)
+ *    - Demons together (share templates)
+ *    - Makes it easier to verify consistency
+ *
+ * 6. VALIDATE BEFORE COMMITTING
+ *    - Use validateNPCDrops() to check for errors
+ *    - Run tests to ensure no breaking changes
+ *
+ * 7. DOCUMENT NON-OBVIOUS DROPS
+ *    - Note when drops are special/quest-only
+ *    - Include conditions that affect drops
+ */
+declare const _default: {
+    BabyBlackDragon: Npc;
+    BabyBlueDragon: Npc;
+    BabyGreenDragon: Npc;
+    LesserDemon: Npc;
+    GreaterDemon: Npc;
+    Chicken: Npc;
+    Cerberus: Npc;
+};
+export default _default;
+//# sourceMappingURL=IMPLEMENTATION_EXAMPLES.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IMPLEMENTATION_EXAMPLES.d.ts","sourceRoot":"","sources":["../../../../../source/runescape/model/npc/npcs/IMPLEMENTATION_EXAMPLES.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAQrC;;;;;GAKG;AACH,eAAO,MAAM,eAAe,KAyB3B,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,KAyB1B,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,KAyB3B,CAAC;AAQF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,KAwBvB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,YAAY,KAwBxB,CAAC;AAMF;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,WASxB,CAAC;AAEF,eAAO,MAAM,OAAO,KAsBnB,CAAC;AA0CF,eAAO,MAAM,QAAQ,KAyBpB,CAAC;AAMF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAMH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;;;;;;;;;AAEH,wBAQE"}

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

@@ -0,0 +1,218 @@
+/**
+ * PRACTICAL IMPLEMENTATION EXAMPLE
+ * ==============================================================
+ *
+ * This file demonstrates how to implement drops for multiple NPCs
+ * following the recommendations from IMPLEMENTATION_STRATEGY.md
+ * and using the utilities from DropImplementationUtils.ts
+ *
+ * BATCH 1: Dragon Types (5 NPCs)
+ * - Baby Black Dragon
+ * - Baby Blue Dragon
+ * - Baby Green Dragon
+ * - Baby Red Dragon
+ * - Chromatic Dragons (parent type)
+ */
+import { Npc } from '../Npc';
+import { NpcDrop } from '../NpcDrop';
+import { createDragonDrops, DROP_RATES, createBossNPCDrops } from './DropImplementationUtils';
+// ============================================================================
+// BATCH 1: Dragon Implementation Example
+// ============================================================================
+/**
+ * Baby Black Dragon
+ * Location: Taverly Dungeon
+ * Level: 79 Combat
+ * Wiki: https://oldschool.runescape.wiki/w/Baby_black_dragon
+ */
+export const BabyBlackDragon = new Npc(1590, 'Baby black dragon', 'A small black dragon.', false, 79, 'https://oldschool.runescape.wiki/w/Baby_black_dragon', 80, true, true, false, true, // Can be venom'd
+true, // Can use cannon
+false, true, // Can use thralls
+['Magic', 'Melee'], 15, 6, 30, ['Taverly Dungeon'], createDragonDrops({
+    tier: 'baby',
+    hasUniqueDrops: false,
+}), ['Stab', 'Slash', 'Crush', 'Magic', 'Ranged']);
+/**
+ * Baby Blue Dragon
+ * Location: Taverley Dungeon
+ * Level: 49 Combat
+ * Wiki: https://oldschool.runescape.wiki/w/Baby_blue_dragon
+ */
+export const BabyBlueDragon = new Npc(1594, 'Baby blue dragon', 'A small blue dragon.', false, 49, 'https://oldschool.runescape.wiki/w/Baby_blue_dragon', 50, true, true, false, false, true, // Can use cannon
+false, false, ['Magic', 'Melee'], 10, 6, 30, ['Taverly Dungeon'], createDragonDrops({
+    tier: 'baby',
+    hasUniqueDrops: false,
+}), ['Stab', 'Slash', 'Crush', 'Magic', 'Ranged']);
+/**
+ * Baby Green Dragon
+ * Location: Taverly Dungeon
+ * Level: 42 Combat
+ * Wiki: https://oldschool.runescape.wiki/w/Baby_green_dragon
+ *
+ * NOTE: This could use shared drops via template since all baby dragons
+ *       have essentially identical drops
+ */
+export const BabyGreenDragon = new Npc(1591, 'Baby green dragon', 'A small green dragon.', false, 42, 'https://oldschool.runescape.wiki/w/Baby_green_dragon', 40, true, true, false, false, true, false, false, ['Magic', 'Melee'], 8, 6, 30, ['Taverly Dungeon'], createDragonDrops({
+    tier: 'baby',
+    hasUniqueDrops: false,
+}), ['Stab', 'Slash', 'Crush', 'Magic', 'Ranged']);
+// ============================================================================
+// BATCH 2: Demon Implementation Example
+// ============================================================================
+import { createDemonDrops } from './DropImplementationUtils';
+/**
+ * Lesser Demon
+ * Locations: Dungeons across RuneScape
+ * Level: 7 Combat
+ * Wiki: https://oldschool.runescape.wiki/w/Lesser_demon
+ */
+export const LesserDemon = new Npc(1629, 'Lesser demon', 'An evil demon.', false, 7, 'https://oldschool.runescape.wiki/w/Lesser_demon', 10, true, true, false, false, false, false, false, ['Melee', 'Magic'], 4, 5, 30, ['Dungeons'], createDemonDrops({
+    tier: 'lesser',
+}), ['Slash', 'Crush']);
+/**
+ * Greater Demon
+ * Location: Demonic Ruins, Wilderness
+ * Level: 82 Combat
+ * Wiki: https://oldschool.runescape.wiki/w/Greater_demon
+ */
+export const GreaterDemon = new Npc(2025, 'Greater demon', 'A powerful demon.', false, 82, 'https://oldschool.runescape.wiki/w/Greater_demon', 100, true, true, false, false, false, false, false, ['Melee', 'Magic'], 16, 5, 30, ['Demonic Ruins'], createDemonDrops({
+    tier: 'greater',
+}), ['Slash', 'Crush', 'Magic']);
+// ============================================================================
+// BATCH 3: Basic Animal Implementation Example
+// ============================================================================
+/**
+ * Chicken
+ * Location: Various (Lumbridge, Falador, etc.)
+ * Level: 1 Combat
+ * Wiki: https://oldschool.runescape.wiki/w/Chicken
+ *
+ * Simple template - easily replicable for other animals
+ */
+export const ChickenDrops = [
+    // Guaranteed drops (rare, but possible)
+    new NpcDrop('Chicken', 1, '1/8', false, 'Can be caught with Hunting'),
+    // Flesh drops
+    new NpcDrop('Raw Chicken', 1, '1/4'),
+    // Clue scrolls
+    new NpcDrop('Clue Scroll (Beginner)', 1, DROP_RATES.UNCOMMON_1_128),
+];
+export const Chicken = new Npc(1017, 'Chicken', 'A young fowl.', false, 1, 'https://oldschool.runescape.wiki/w/Chicken', 3, false, true, false, false, false, false, false, ['Melee'], 1, 5, 15, ['Lumbridge', 'Falador', 'Ardougne'], ChickenDrops, ['Stab']);
+// ============================================================================
+// BATCH 4: Complex Boss Implementation Example
+// ============================================================================
+/**
+ * Cerberus
+ * Location: Cerberus' Lair (Taverley Dungeon)
+ * Level: 203 Combat
+ * Wiki: https://oldschool.runescape.wiki/w/Cerberus
+ *
+ * Multi-roll boss example
+ */
+function createCerberusDrops() {
+    return createBossNPCDrops({
+        // Primary drops - always present
+        primaryDrops: [
+            new NpcDrop('Cerberus\' Prime', [1, 2], 'Always'),
+            new NpcDrop('Hellhound Bones', 1, 'Always'),
+            new NpcDrop('Coins', [500, 1000], 'Always'),
+        ],
+        // Tertiary drops - guaranteed
+        tertiaryDrops: [
+            new NpcDrop('Ashes', [1, 2], 'Always'),
+            new NpcDrop('Mithril Ore', [2, 4], 'Always'),
+        ],
+        // Rare unique drops from a weighted table
+        rareDrops: [
+            { item: new NpcDrop('Primordial Boots', 1, 'Always'), weight: 1 },
+            { item: new NpcDrop('Pegasian Boots', 1, 'Always'), weight: 1 },
+            { item: new NpcDrop('Eternal Boots', 1, 'Always'), weight: 1 },
+        ],
+        uniqueRate: DROP_RATES.RARE_1_512,
+    });
+}
+export const Cerberus = new Npc(5862, 'Cerberus', 'The three-headed hellhound.', true, 203, 'https://oldschool.runescape.wiki/w/Cerberus', 600, true, true, false, true, false, false, true, ['Melee', 'Magic'], 58, 6, 0, // Boss doesn't respawn like normal monsters
+['Cerberus\' Lair'], createCerberusDrops().getAllPossibleDrops(), ['Stab', 'Slash', 'Crush', 'Magic', 'Ranged'], undefined, // No products
+undefined, // No dialogue
+['Cerberus was added in version 1.0.0']);
+// ============================================================================
+// IMPLEMENTATION CHECKLIST TEMPLATE
+// ============================================================================
+/**
+ * Copy this for each new batch:
+ *
+ * BATCH [X]: [Category] NPCs ([Count] NPCs)
+ * ==========================================
+ *
+ * NPCs to implement:
+ * [ ] NPC Name 1
+ * [ ] NPC Name 2
+ * [ ] NPC Name 3
+ *
+ * Research phase:
+ * [ ] All wiki pages reviewed
+ * [ ] Drop rates verified
+ * [ ] Shared drops identified
+ *
+ * Implementation:
+ * [ ] Drop utilities/templates prepared
+ * [ ] Code written and reviewed
+ * [ ] Tests added
+ * [ ] Validation passes
+ * [ ] No syntax errors
+ *
+ * Quality assurance:
+ * [ ] All drop rates match wiki
+ * [ ] No duplicate item drops
+ * [ ] Proper probability distribution
+ * [ ] Edge cases handled
+ *
+ * Documentation:
+ * [ ] Wiki URLs included in code
+ * [ ] Comments explain non-obvious drops
+ * [ ] Team notified of new drops
+ */
+// ============================================================================
+// KEY TAKEAWAYS FROM THIS EXAMPLE
+// ============================================================================
+/**
+ * 1. USE TEMPLATES FOR SIMILAR NPCs
+ *    - All baby dragons use createDragonDrops({ tier: 'baby' })
+ *    - Reduces duplication and maintains consistency
+ *
+ * 2. INCLUDE WIKI REFERENCES
+ *    - Every NPC has officialWikiUrl
+ *    - Comments reference wiki for verification
+ *
+ * 3. USE HELPER FUNCTIONS
+ *    - createDragonDrops()
+ *    - createDemonDrops()
+ *    - createBossNPCDrops()
+ *    - Makes code cleaner and more maintainable
+ *
+ * 4. LEVERAGE CONSTANTS
+ *    - DROP_RATES.RARE_1_512 is clearer than '1/512'
+ *    - STANDARD_DROPS.bones is reusable
+ *
+ * 5. BATCH SIMILAR NPCS TOGETHER
+ *    - Dragons together (share templates)
+ *    - Demons together (share templates)
+ *    - Makes it easier to verify consistency
+ *
+ * 6. VALIDATE BEFORE COMMITTING
+ *    - Use validateNPCDrops() to check for errors
+ *    - Run tests to ensure no breaking changes
+ *
+ * 7. DOCUMENT NON-OBVIOUS DROPS
+ *    - Note when drops are special/quest-only
+ *    - Include conditions that affect drops
+ */
+export default {
+    BabyBlackDragon,
+    BabyBlueDragon,
+    BabyGreenDragon,
+    LesserDemon,
+    GreaterDemon,
+    Chicken,
+    Cerberus,
+};

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

@@ -0,0 +1,9 @@
+import { Npc } from "../Npc";
+/**
+ * Ice Troll
+ * A troll adapted to icy environments, found in Fremennik Isles.
+ * Wiki: https://oldschool.runescape.wiki/w/Ice_troll
+ */
+export declare const iceTroll: Npc;
+export default iceTroll;
+//# sourceMappingURL=IceTroll.d.ts.map

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

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