@ak--47/dungeon-master 1.0.0

package/dungeons/rpg.js

@@ -0,0 +1,919 @@
+import dayjs from "dayjs";
+import utc from "dayjs/plugin/utc.js";
+import "dotenv/config";
+import * as u from "../lib/utils/utils.js";
+import * as v from "ak-tools";
+
+const SEED = "harness-gaming";
+dayjs.extend(utc);
+const chance = u.initChance(SEED);
+const num_users = 5_000;
+const days = 100;
+
+/** @typedef  {import("../types.d.ts").Dungeon} Config */
+
+/*
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * DATASET OVERVIEW
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * D&D-Style Action RPG — a fantasy adventure game with deep strategic gameplay
+ * and a player-driven economy.
+ *
+ * CORE LOOP: Players create characters (6 classes, 5 races) and progress through
+ * quests, dungeon crawls, and combat encounters. Strategic preparation (inspect,
+ * search for clues, Ancient Compass) creates skill gaps. Guild membership drives
+ * social retention. Monetization via premium currency, lucky charms, season pass,
+ * and subscription tiers (Free / Premium / Elite).
+ *
+ * SCALE: 5,000 users × 120 events = 600K events over 100 days
+ * 20 event types, 7 funnels, guild group analytics, subscription tiers
+ *
+ * KEY SYSTEMS:
+ * - Quests: accept → objective → turn in (5 quest types, gold/XP rewards)
+ * - Dungeons: enter → find treasure → exit (50 dungeons, party-based, 3 outcomes)
+ * - Combat: initiate → complete (6 enemy types, level scaling, loot)
+ * - Economy: item purchase/sell, real money purchases, vendor types
+ * - Progression: level up (1-50), character classes, stat points
+ * - Social: guild join/leave (5-100 members, guild levels 1-20)
+ * - Monetization: premium currency, lucky charms, legendary chests, season pass
+ * - Subscriptions: Free / Premium ($9.99/mo) / Elite ($19.99/mo)
+ */
+
+/*
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * ANALYTICS HOOKS (8 architected patterns)
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * 1. CONVERSION: Ancient Compass Effect
+ *    Players who use the "Ancient Compass" item have 3x quest completion rate
+ *    and earn 1.5x more rewards.
+ *    → Mixpanel: Segment users by "use item" where item_type = "Ancient Compass"
+ *    → Compare quest completion rate and average reward_gold / reward_xp
+ *    → Look for compass_user = true on quest turned in events
+ *
+ * 2. TIME-BASED: Cursed Week (days 40-47)
+ *    Death rates spike 5x, dungeon completion plummets, resurrection usage 4x.
+ *    → Mixpanel: Chart "player death" count by day — clear spike days 40-47
+ *    → Filter cause_of_death = "Curse" and cursed_week = true
+ *    → Compare completion_status distribution before/during/after
+ *
+ * 3. RETENTION: Early Guild Joiners
+ *    Players who join a guild within first 3 days have 80% D30 retention vs 20%.
+ *    → Mixpanel: Create cohort of users who did "guild joined" within first 3 days
+ *    → Compare D30 retention rate and average events per user
+ *    → Look for guild_member_retained = true on late engagement events
+ *
+ * 4. CHURN: Death Spiral
+ *    Players with 3+ deaths in first week have 70% churn rate (events removed).
+ *    → Mixpanel: Segment users by count of "player death" in first 7 days
+ *    → Bucket: 0-2, 3-4, 5+ deaths — compare events after day 7
+ *    → Users with 3+ early deaths have 70% fewer post-week-1 events
+ *
+ * 5. PURCHASE VALUE: Lucky Charm LTV
+ *    Lucky Charm Pack buyers become 5x higher LTV customers — higher purchase
+ *    frequency, upgraded tiers, more total spend.
+ *    → Mixpanel: Segment by "real money purchase" where product contains "Lucky Charm"
+ *    → Compare total revenue per user, purchase frequency, average order value
+ *    → Look for lucky_charm_effect = true on subsequent purchases
+ *
+ * 6. BEHAVIORS TOGETHER: Strategic Explorers
+ *    Players who both "inspect" AND "search for clues" before dungeons have
+ *    85% dungeon completion (vs 45%) and 2x treasure value.
+ *    → Mixpanel: Segment users who did BOTH "inspect" AND "search for clues"
+ *    → Filter dungeon funnel: enter → exit, compare completion_status rates
+ *    → Look for strategic_explorer = true on exit dungeon / find treasure events
+ *
+ * 7. TIMED RELEASE: Shadowmourne Legendary Weapon (day 45)
+ *    2% of players find the legendary weapon after release. They get 90% combat
+ *    win rate (vs 60%) and complete dungeons 40% faster.
+ *    → Mixpanel: Filter "find treasure" where treasure_type = "Shadowmourne Legendary"
+ *    → Compare combat win rate and dungeon time_spent_mins before/after day 45
+ *    → Look for legendary_weapon_equipped = true
+ *
+ * 8. SUBSCRIPTION TIER: Premium/Elite Advantage
+ *    Premium: 50% better combat wins, 1.4x rewards, 45% higher dungeon completion
+ *    Elite: 70% better combat wins, 1.8x rewards, 65% higher dungeon completion,
+ *    bonus treasure events, reduced death rates.
+ *    → Mixpanel: Segment by subscription_tier super property
+ *    → Compare combat win rates, reward_gold, dungeon completion, death rates
+ *    → Look for subscriber_advantage = "Premium" or "Elite"
+ *
+ * ───────────────────────────────────────────────────────────────────────────────
+ * EXPECTED METRICS SUMMARY
+ * ───────────────────────────────────────────────────────────────────────────────
+ *
+ * Hook                  | Metric               | Baseline | Hook Effect | Ratio
+ * ──────────────────────|──────────────────────|──────────|─────────────|──────
+ * Ancient Compass       | Quest completion     | 55%      | 85-90%      | ~1.6x
+ * Cursed Week           | Death rate           | 8%       | 40%         | 5x
+ * Early Guild Join      | D30 Retention        | 20%      | 80%         | 4x
+ * Death Spiral          | Retention (3+ deaths)| 100%     | 30%         | 0.3x
+ * Lucky Charm           | LTV                  | $15      | $75         | 5x
+ * Strategic Explorer    | Dungeon completion   | 45%      | 85%         | ~1.9x
+ * Legendary Weapon      | Combat win rate      | 60%      | 90%         | 1.5x
+ * Premium Tier          | Combat win rate      | 60%      | 90%         | 1.5x
+ * Elite Tier            | Combat win rate      | 60%      | 102%        | 1.7x
+ *
+ * ───────────────────────────────────────────────────────────────────────────────
+ * ADVANCED ANALYSIS IDEAS
+ * ───────────────────────────────────────────────────────────────────────────────
+ *
+ * CROSS-HOOK PATTERNS:
+ *
+ * 1. The Ultimate Player: Users who use Ancient Compass (Hook #1), join guild
+ *    early (Hook #3), buy Lucky Charm (Hook #5), get legendary weapon (Hook #7),
+ *    and have Elite subscription (Hook #8) — exceptional metrics across all dims.
+ *
+ * 2. The Cursed Compass: Do Ancient Compass users survive the Cursed Week
+ *    better than others?
+ *
+ * 3. Guild Churn Prevention: Does early guild joining (Hook #3) prevent
+ *    death-spiral churn (Hook #4)?
+ *
+ * 4. LTV + Retention: Compare Lucky Charm buyers who joined guilds early vs.
+ *    those who didn't.
+ *
+ * 5. Subscription Impact on Churn: Do Premium/Elite subscribers avoid the
+ *    death spiral churn pattern?
+ *
+ * COHORT ANALYSIS:
+ *
+ * - Cohort by starting week: Users who started during Cursed Week (days 40-47)
+ *   should show different patterns
+ * - Cohort by character class: Do certain classes show different hook patterns?
+ * - Cohort by platform: Do PC users vs. console users exhibit different
+ *   strategic explorer behavior?
+ * - Cohort by subscription tier: Track retention, engagement, and monetization
+ *   differences
+ *
+ * FUNNEL ANALYSIS:
+ *
+ * - Onboarding Funnel: How does Ancient Compass usage affect tutorial → first
+ *   quest conversion?
+ * - Dungeon Funnel: Compare enter → treasure → exit completion by strategic
+ *   explorers and subscription tier
+ * - Quest Funnel: Compare quest accepted → completed rates before and during
+ *   Cursed Week
+ */
+
+// Generate consistent item/location IDs for lookup tables
+const dungeonIds = v.range(1, 51).map(n => `dungeon_${v.uid(6)}`);
+const questIds = v.range(1, 201).map(n => `quest_${v.uid(8)}`);
+const itemIds = v.range(1, 301).map(n => `item_${v.uid(7)}`);
+
+/** @type {Config} */
+const config = {
+	token: "",
+	seed: SEED,
+	numDays: days,
+	numEvents: num_users * 120,
+	numUsers: num_users,
+	hasAnonIds: false,
+	hasSessionIds: true,
+	format: "json",
+	gzip: true,
+	alsoInferFunnels: false,
+	hasLocation: true,
+	hasAndroidDevices: true,
+	hasIOSDevices: true,
+	hasDesktopDevices: true,
+	hasBrowser: false,
+	hasCampaigns: false,
+	isAnonymous: false,
+	hasAdSpend: false,
+	percentUsersBornInDataset: 50,
+
+	hasAvatar: true,
+
+	batchSize: 2_500_000,
+	concurrency: 1,
+	writeToDisk: false,
+
+	funnels: [
+		{
+			sequence: ["character created", "tutorial completed", "quest accepted"],
+			isFirstFunnel: true,
+			conversionRate: 75,
+			timeToConvert: 0.5,
+		},
+		{
+			// Core combat loop: most frequent player activity
+			sequence: ["combat initiated", "combat completed", "use item"],
+			conversionRate: 75,
+			timeToConvert: 0.5,
+			weight: 5,
+		},
+		{
+			// Dungeon crawl: enter, explore, loot, exit
+			sequence: ["enter dungeon", "find treasure", "exit dungeon"],
+			conversionRate: 60,
+			timeToConvert: 2,
+			weight: 4,
+			props: {
+				"dungeon_id": u.pickAWinner(dungeonIds),
+				"difficulty": ["Easy", "Medium", "Hard", "Deadly"],
+			}
+		},
+		{
+			// Quest lifecycle
+			sequence: ["quest accepted", "quest objective completed", "quest turned in"],
+			conversionRate: 55,
+			timeToConvert: 3,
+			weight: 3,
+			props: { "quest_id": u.pickAWinner(questIds) },
+		},
+		{
+			// Preparation before dungeon: inspect + search for strategic explorer hook
+			sequence: ["inspect", "search for clues", "enter dungeon"],
+			conversionRate: 50,
+			timeToConvert: 1,
+			weight: 3,
+		},
+		{
+			// Economy: buy gear, sell loot
+			sequence: ["item purchased", "use item", "item sold"],
+			conversionRate: 45,
+			timeToConvert: 6,
+			weight: 2,
+		},
+		{
+			// Social and progression
+			sequence: ["guild joined", "level up", "real money purchase"],
+			conversionRate: 25,
+			timeToConvert: 24,
+			weight: 1,
+		},
+	],
+
+	events: [
+		{
+			event: "character created",
+			weight: 1,
+			isFirstEvent: true,
+			properties: {
+				"character_class": [
+					"Warrior",
+					"Mage",
+					"Rogue",
+					"Cleric",
+					"Ranger",
+					"Paladin"
+				],
+				"starting_race": [
+					"Human",
+					"Elf",
+					"Dwarf",
+					"Halfling",
+					"Orc"
+				],
+			}
+		},
+		{
+			event: "tutorial completed",
+			weight: 2,
+			properties: {
+				"completion_time_mins": u.weighNumRange(3, 25, 0.8, 10),
+				"skipped": u.pickAWinner([true, false], 0.15),
+			}
+		},
+		{
+			event: "quest accepted",
+			weight: 15,
+			properties: {
+				"quest_id": u.pickAWinner(questIds),
+				"quest_type": [
+					"Main Story",
+					"Side Quest",
+					"Bounty",
+					"Exploration",
+					"Escort"
+				],
+				"recommended_level": u.weighNumRange(1, 50),
+			}
+		},
+		{
+			event: "quest objective completed",
+			weight: 12,
+			properties: {
+				"quest_id": u.pickAWinner(questIds),
+				"objective_number": u.weighNumRange(1, 5),
+			}
+		},
+		{
+			event: "quest turned in",
+			weight: 10,
+			properties: {
+				"quest_id": u.pickAWinner(questIds),
+				"reward_gold": u.weighNumRange(10, 500, 0.5, 100),
+				"reward_xp": u.weighNumRange(50, 2000, 0.5, 500),
+			}
+		},
+		{
+			event: "enter dungeon",
+			weight: 18,
+			properties: {
+				"dungeon_id": u.pickAWinner(dungeonIds),
+				"difficulty": ["Easy", "Medium", "Hard", "Deadly"],
+				"party_size": u.weighNumRange(1, 5),
+			}
+		},
+		{
+			event: "exit dungeon",
+			weight: 14,
+			properties: {
+				"dungeon_id": u.pickAWinner(dungeonIds),
+				"time_spent_mins": u.weighNumRange(5, 120, 0.6, 30),
+				"completion_status": ["completed", "abandoned", "died"],
+			}
+		},
+		{
+			event: "find treasure",
+			weight: 16,
+			properties: {
+				"treasure_type": [
+					"Gold",
+					"Weapon",
+					"Armor",
+					"Potion",
+					"Scroll",
+					"Rare Artifact"
+				],
+				"treasure_value": u.weighNumRange(5, 1000, 1.2, 50),
+			}
+		},
+		{
+			event: "player death",
+			weight: 8,
+			properties: {
+				"cause_of_death": [
+					"Monster",
+					"Trap",
+					"Fall Damage",
+					"Poison",
+					"Friendly Fire"
+				],
+				"player_level": u.weighNumRange(1, 50),
+				"resurrection_used": u.pickAWinner([true, false], 0.25),
+			}
+		},
+		{
+			event: "level up",
+			weight: 5,
+			properties: {
+				"new_level": u.weighNumRange(2, 50),
+				"stat_points_gained": u.weighNumRange(1, 5),
+			}
+		},
+		{
+			event: "item purchased",
+			weight: 11,
+			properties: {
+				"item_id": u.pickAWinner(itemIds),
+				"item_type": [
+					"Weapon",
+					"Armor",
+					"Potion",
+					"Scroll",
+					"Mount",
+					"Cosmetic"
+				],
+				"price_gold": u.weighNumRange(10, 500, 0.8, 100),
+				"vendor_type": ["Town", "Dungeon", "Special Event"],
+			}
+		},
+		{
+			event: "item sold",
+			weight: 7,
+			properties: {
+				"item_id": u.pickAWinner(itemIds),
+				"item_type": [
+					"Weapon",
+					"Armor",
+					"Potion",
+					"Scroll",
+					"Junk"
+				],
+				"sell_price": u.weighNumRange(5, 250, 0.5, 50),
+			}
+		},
+		{
+			event: "real money purchase",
+			weight: 3,
+			properties: {
+				"product": [
+					"Premium Currency (1000)",
+					"Premium Currency (5000)",
+					"Lucky Charm Pack",
+					"Legendary Weapon Chest",
+					"Cosmetic Bundle",
+					"Season Pass"
+				],
+				"price_usd": u.pickAWinner([4.99, 9.99, 19.99, 49.99, 99.99]),
+				"payment_method": ["Credit Card", "PayPal", "Apple Pay", "Google Pay"],
+			}
+		},
+		{
+			event: "guild joined",
+			weight: 4,
+			properties: {
+				"guild_size": u.weighNumRange(5, 100),
+				"guild_level": u.weighNumRange(1, 20),
+			}
+		},
+		{
+			event: "guild left",
+			weight: 1,
+			properties: {
+				"reason": [
+					"Inactive",
+					"Found Better Guild",
+					"Conflict",
+					"Disbanded"
+				],
+			}
+		},
+		{
+			event: "inspect",
+			weight: 9,
+			properties: {
+				"inspect_target": [
+					"NPC",
+					"Monster",
+					"Treasure Chest",
+					"Door",
+					"Statue",
+					"Bookshelf"
+				],
+			}
+		},
+		{
+			event: "search for clues",
+			weight: 8,
+			properties: {
+				"location_type": [
+					"Dungeon Entrance",
+					"Hidden Room",
+					"Quest Location",
+					"Town Square"
+				],
+				"clue_found": u.pickAWinner([true, false], 0.6),
+			}
+		},
+		{
+			event: "use item",
+			weight: 14,
+			properties: {
+				"item_id": u.pickAWinner(itemIds),
+				"item_type": [
+					"Health Potion",
+					"Mana Potion",
+					"Buff Scroll",
+					"Ancient Compass",
+					"Lucky Charm",
+					"Resurrection Stone"
+				],
+				"context": ["Combat", "Exploration", "Boss Fight", "Casual"],
+			}
+		},
+		{
+			event: "combat initiated",
+			weight: 20,
+			properties: {
+				"enemy_type": [
+					"Goblin",
+					"Skeleton",
+					"Dragon",
+					"Demon",
+					"Undead",
+					"Beast"
+				],
+				"enemy_level": u.weighNumRange(1, 50),
+				"combat_duration_sec": u.weighNumRange(10, 300, 0.7, 60),
+			}
+		},
+		{
+			event: "combat completed",
+			weight: 18,
+			properties: {
+				"outcome": ["Victory", "Defeat", "Fled"],
+				"loot_gained": u.pickAWinner([true, false], 0.7),
+			}
+		}
+	],
+
+	superProps: {
+		platform: [
+			"PC",
+			"Mac",
+			"PlayStation",
+			"Xbox",
+			"Switch"
+		],
+		graphics_quality: [
+			"Low",
+			"Medium",
+			"High",
+			"Ultra"
+		],
+		subscription_tier: u.pickAWinner(["Free", "Free", "Free", "Premium", "Elite"]),
+	},
+
+	scdProps: {},
+
+	userProps: {
+		"preferred_playstyle": [
+			"Solo Explorer",
+			"Group Raider",
+			"PvP Fighter",
+			"Quest Completionist",
+			"Treasure Hunter"
+		],
+		"total_playtime_hours": u.weighNumRange(1, 500, 1.5, 50),
+		"achievement_points": u.weighNumRange(0, 5000, 0.8, 500),
+		"favorite_class": [
+			"Warrior",
+			"Mage",
+			"Rogue",
+			"Cleric",
+			"Ranger",
+			"Paladin"
+		],
+	},
+
+	groupKeys: [
+		["guild_id", 500, ["guild joined", "guild left", "quest turned in", "combat completed"]],
+	],
+
+	groupProps: {
+		guild_id: {
+			"name": () => `${chance.word()} ${chance.pickone(["Knights", "Dragons", "Warriors", "Seekers", "Legends"])}`,
+			"member_count": u.weighNumRange(5, 100),
+			"guild_level": u.weighNumRange(1, 20),
+			"total_wealth": u.weighNumRange(1000, 1000000, 0.5, 50000),
+		}
+	},
+
+	lookupTables: [],
+
+	/**
+	 * 🎯 ARCHITECTED ANALYTICS HOOKS
+	 *
+	 * This hook function creates 8 deliberate patterns in the data:
+	 *
+	 * 1. CONVERSION: Ancient Compass users have 3x quest completion rate
+	 * 2. TIME-BASED: "Cursed Week" (days 40-47) has 5x death rates & low completion
+	 * 3. RETENTION: Early guild joiners (first 3 days) have 80% 30-day retention vs 20%
+	 * 4. CHURN: Players with 3+ deaths in first week have 70% churn rate
+	 * 5. PURCHASE VALUE: Lucky Charm buyers spend 5x more (LTV pattern)
+	 * 6. BEHAVIORS TOGETHER: inspect + search before dungeon = 85% completion vs 45%
+	 * 7. TIMED RELEASE: Legendary weapon released day 45, early adopters dominate
+	 * 8. SUBSCRIPTION TIER: Premium/Elite users have higher engagement and success rates
+	 */
+	hook: function (record, type, meta) {
+		const NOW = dayjs();
+		const DATASET_START = NOW.subtract(days, 'days');
+		const CURSED_WEEK_START = DATASET_START.add(40, 'days');
+		const CURSED_WEEK_END = DATASET_START.add(47, 'days');
+		const LEGENDARY_WEAPON_RELEASE = DATASET_START.add(45, 'days');
+
+		// Hook #2: TIME-BASED TREND - Cursed Week
+		if (type === "event") {
+			const EVENT_TIME = dayjs(record.time);
+
+			// During cursed week, dramatically increase death rates
+			if (EVENT_TIME.isAfter(CURSED_WEEK_START) && EVENT_TIME.isBefore(CURSED_WEEK_END)) {
+				// 50% chance to inject a death event
+				if (chance.bool({ likelihood: 30 })) {
+					const deathEvent = {
+						event: "player death",
+						time: record.time,
+						user_id: record.user_id,
+						cause_of_death: "Curse",
+						player_level: chance.integer({ min: 1, max: 50 }),
+						resurrection_used: chance.bool({ likelihood: 80 }), // More res usage during curse
+						cursed_week: true,
+					};
+					// Return death event instead sometimes
+					if (chance.bool({ likelihood: 50 })) {
+						return deathEvent;
+					}
+				}
+			}
+		}
+
+		// Hook #7: TIMED RELEASE - Legendary Weapon
+		if (type === "event") {
+			const EVENT_TIME = dayjs(record.time);
+
+			if (record.event === "find treasure") {
+				// After legendary weapon release, some lucky players get it
+				if (EVENT_TIME.isAfter(LEGENDARY_WEAPON_RELEASE) && chance.bool({ likelihood: 2 })) {
+					record.treasure_type = "Shadowmourne Legendary";
+					record.treasure_value = 50000;
+					record.legendary_drop = true;
+				} else {
+					record.legendary_drop = false;
+				}
+			}
+		}
+
+		// Hook #3, #4, #5, #6, #1: EVERYTHING - Complex behavioral patterns
+		if (type === "everything") {
+			const userEvents = record;
+			const firstEventTime = userEvents.length > 0 ? dayjs(userEvents[0].time) : null;
+
+			// Track user behaviors
+			let usedAncientCompass = false;
+			let boughtLuckyCharm = false;
+			let joinedGuildEarly = false;
+			let earlyDeaths = 0;
+			let hasLegendaryWeapon = false;
+			let inspectedBeforeDungeon = false;
+			let searchedBeforeDungeon = false;
+			let subscriptionTier = "Free"; // Hook #8: Track subscription tier
+
+			// First pass: identify user patterns
+			userEvents.forEach((event, idx) => {
+				const eventTime = dayjs(event.time);
+				const daysSinceStart = firstEventTime ? eventTime.diff(firstEventTime, 'days', true) : 0;
+
+				// Hook #8: Capture subscription tier from any event that has it
+				if (event.subscription_tier) {
+					subscriptionTier = event.subscription_tier;
+				}
+
+				// Hook #1: Track Ancient Compass usage
+				if (event.event === "use item" && event.item_type === "Ancient Compass") {
+					usedAncientCompass = true;
+				}
+
+				// Hook #5: Track Lucky Charm purchases
+				if (event.event === "real money purchase" && event.product === "Lucky Charm Pack") {
+					boughtLuckyCharm = true;
+				}
+
+				// Hook #3: Track early guild joining
+				if (event.event === "guild joined" && daysSinceStart < 3) {
+					joinedGuildEarly = true;
+				}
+
+				// Hook #4: Track early deaths (first 7 days)
+				if (event.event === "player death" && daysSinceStart < 7) {
+					earlyDeaths++;
+				}
+
+				// Hook #7: Track legendary weapon ownership
+				if (event.event === "find treasure" && event.legendary_drop) {
+					hasLegendaryWeapon = true;
+				}
+
+				// Hook #6: Track inspect + search patterns
+				if (event.event === "inspect") {
+					inspectedBeforeDungeon = true;
+				}
+				if (event.event === "search for clues") {
+					searchedBeforeDungeon = true;
+				}
+			});
+
+			// Second pass: modify events based on patterns
+			userEvents.forEach((event, idx) => {
+				const eventTime = dayjs(event.time);
+
+				// Set schema defaults for conditional properties
+				if (event.event === "quest turned in") {
+					event.compass_user = false;
+					event.subscriber_advantage = "Free";
+				}
+				if (event.event === "exit dungeon") {
+					event.strategic_explorer = false;
+					event.legendary_weapon_equipped = false;
+					event.subscriber_advantage = "Free";
+				}
+				if (event.event === "find treasure") {
+					event.strategic_explorer = false;
+					event.subscriber_advantage = "Free";
+				}
+				if (event.event === "combat completed") {
+					event.legendary_weapon_equipped = false;
+					event.subscriber_advantage = "Free";
+					event.near_death_survival = false;
+				}
+				if (event.event === "player death") {
+					event.near_death_survival = false;
+					event.subscriber_advantage = "Free";
+				}
+
+				// Hook #1: CONVERSION - Ancient Compass users complete more quests
+				if (usedAncientCompass && event.event === "quest turned in") {
+					// Triple the rewards for compass users (they're more successful)
+					event.reward_gold = Math.floor((event.reward_gold || 100) * 1.5);
+					event.reward_xp = Math.floor((event.reward_xp || 500) * 1.5);
+					event.compass_user = true;
+
+					// Add extra quest completions for compass users
+					if (chance.bool({ likelihood: 40 })) {
+						const extraQuest = {
+							event: "quest turned in",
+							time: eventTime.add(chance.integer({ min: 10, max: 120 }), 'minutes').toISOString(),
+							user_id: event.user_id,
+							quest_id: chance.pickone(questIds),
+							reward_gold: chance.integer({ min: 100, max: 500 }),
+							reward_xp: chance.integer({ min: 500, max: 2000 }),
+							compass_user: true,
+						};
+						userEvents.splice(idx + 1, 0, extraQuest);
+					}
+				}
+
+				// Hook #5: PURCHASE VALUE - Lucky charm buyers spend 5x more
+				if (boughtLuckyCharm) {
+					if (event.event === "real money purchase") {
+						// Increase purchase amounts
+						if (event.price_usd) {
+							const currentPrice = event.price_usd;
+							if (currentPrice < 49.99) {
+								event.price_usd = currentPrice * 2; // Upgrade tier
+							}
+							event.lucky_charm_effect = true;
+						}
+					}
+
+					// Add additional purchase events (higher LTV)
+					if (event.event === "item purchased" && chance.bool({ likelihood: 35 })) {
+						const extraPurchase = {
+							event: "real money purchase",
+							time: eventTime.add(chance.integer({ min: 1, max: 3 }), 'days').toISOString(),
+							user_id: event.user_id,
+							product: chance.pickone([
+								"Premium Currency (5000)",
+								"Legendary Weapon Chest",
+								"Season Pass"
+							]),
+							price_usd: chance.pickone([19.99, 49.99, 99.99]),
+							payment_method: chance.pickone(["Credit Card", "PayPal"]),
+							lucky_charm_effect: true,
+						};
+						userEvents.splice(idx + 1, 0, extraPurchase);
+					}
+				}
+
+				// Hook #6: BEHAVIORS TOGETHER - Inspect + Search before dungeon
+				if (inspectedBeforeDungeon && searchedBeforeDungeon) {
+					if (event.event === "exit dungeon") {
+						// Much higher completion rate
+						if (event.completion_status !== "completed") {
+							// Convert 85% of non-completions to completions
+							if (chance.bool({ likelihood: 85 })) {
+								event.completion_status = "completed";
+								event.strategic_explorer = true;
+							}
+						}
+					}
+
+					// Find more treasure
+					if (event.event === "find treasure") {
+						event.treasure_value = Math.floor((event.treasure_value || 50) * 2);
+						event.strategic_explorer = true;
+					}
+				}
+
+				// Hook #7: TIMED RELEASE - Legendary weapon owners dominate
+				if (hasLegendaryWeapon) {
+					// Higher combat success
+					if (event.event === "combat completed") {
+						if (event.outcome !== "Victory") {
+							// Convert 90% of losses to victories
+							if (chance.bool({ likelihood: 90 })) {
+								event.outcome = "Victory";
+								event.legendary_weapon_equipped = true;
+							}
+						}
+					}
+
+					// Complete dungeons faster and more successfully
+					if (event.event === "exit dungeon") {
+						event.completion_status = "completed";
+						event.time_spent_mins = Math.floor((event.time_spent_mins || 60) * 0.6);
+						event.legendary_weapon_equipped = true;
+					}
+				}
+
+				// Hook #8: SUBSCRIPTION TIER - Premium/Elite users have better outcomes
+				if (subscriptionTier === "Premium" || subscriptionTier === "Elite") {
+					const isElite = subscriptionTier === "Elite";
+
+					// Better combat outcomes
+					if (event.event === "combat completed") {
+						if (event.outcome !== "Victory") {
+							const winBoost = isElite ? 70 : 50; // Elite: 70%, Premium: 50%
+							if (Math.random() * 100 < winBoost) {
+								event.outcome = "Victory";
+								event.loot_gained = true;
+								event.subscriber_advantage = subscriptionTier;
+							}
+						}
+					}
+
+					// Higher quest completion and rewards
+					if (event.event === "quest turned in") {
+						const rewardMultiplier = isElite ? 1.8 : 1.4; // Elite: 1.8x, Premium: 1.4x
+						event.reward_gold = Math.floor((event.reward_gold || 100) * rewardMultiplier);
+						event.reward_xp = Math.floor((event.reward_xp || 500) * rewardMultiplier);
+						event.subscriber_advantage = subscriptionTier;
+					}
+
+					// Higher dungeon completion rates
+					if (event.event === "exit dungeon") {
+						if (event.completion_status !== "completed") {
+							const completionBoost = isElite ? 65 : 45; // Elite: 65%, Premium: 45%
+							if (Math.random() * 100 < completionBoost) {
+								event.completion_status = "completed";
+								event.subscriber_advantage = subscriptionTier;
+							}
+						}
+						// Faster completion times
+						if (event.completion_status === "completed") {
+							const speedBoost = isElite ? 0.7 : 0.85; // Elite: 30% faster, Premium: 15% faster
+							event.time_spent_mins = Math.floor((event.time_spent_mins || 60) * speedBoost);
+						}
+					}
+
+					// Better treasure finds
+					if (event.event === "find treasure") {
+						const treasureBoost = isElite ? 2.0 : 1.5; // Elite: 2x, Premium: 1.5x
+						event.treasure_value = Math.floor((event.treasure_value || 50) * treasureBoost);
+						event.subscriber_advantage = subscriptionTier;
+					}
+
+					// Reduced death rates (subscribers have advantages)
+					if (event.event === "player death") {
+						const survivalChance = isElite ? 50 : 30; // Elite: 50% avoid death, Premium: 30%
+						if (Math.random() * 100 < survivalChance) {
+							// Convert death to combat completed with victory
+							event.event = "combat completed";
+							event.outcome = "Victory";
+							event.loot_gained = true;
+							event.subscriber_advantage = subscriptionTier;
+							event.near_death_survival = true;
+						}
+					}
+
+					// Elite users get bonus engagement events
+					if (isElite && Math.random() * 100 < 15) {
+						if (event.event === "quest turned in" || event.event === "exit dungeon") {
+							const treasureTypes = ["Rare Artifact", "Gold", "Weapon", "Armor"];
+							const bonusEvent = {
+								event: "find treasure",
+								time: eventTime.add(Math.floor(Math.random() * 26) + 5, 'minutes').toISOString(),
+								user_id: event.user_id,
+								treasure_type: treasureTypes[Math.floor(Math.random() * treasureTypes.length)],
+								treasure_value: Math.floor(Math.random() * 601) + 200,
+								subscriber_advantage: "Elite",
+								elite_bonus: true,
+							};
+							userEvents.splice(idx + 1, 0, bonusEvent);
+						}
+					}
+				}
+			});
+
+			// Hook #3: RETENTION - Early guild joiners retained
+			// Hook #4: CHURN - High early death = churn
+			const shouldChurn = (!joinedGuildEarly && earlyDeaths >= 3) ||
+			                    (earlyDeaths >= 5);
+
+			if (shouldChurn) {
+				// Remove 70% of events after first week (churn)
+				const firstWeekEnd = firstEventTime ? firstEventTime.add(7, 'days') : null;
+				for (let i = userEvents.length - 1; i >= 0; i--) {
+					const evt = userEvents[i];
+					if (firstWeekEnd && dayjs(evt.time).isAfter(firstWeekEnd)) {
+						if (chance.bool({ likelihood: 70 })) {
+							userEvents.splice(i, 1);
+						}
+					}
+				}
+			} else if (joinedGuildEarly) {
+				// Add extra engagement events for retained users
+				const lastEvent = userEvents[userEvents.length - 1];
+				if (lastEvent && chance.bool({ likelihood: 60 })) {
+					const retentionEvent = {
+						event: "combat completed",
+						time: dayjs(lastEvent.time).add(chance.integer({ min: 1, max: 5 }), 'days').toISOString(),
+						user_id: lastEvent.user_id,
+						outcome: "Victory",
+						loot_gained: true,
+						guild_member_retained: true,
+					};
+					userEvents.push(retentionEvent);
+				}
+			}
+		}
+
+		return record;
+	}
+};
+
+export default config;