make-mp-data 3.0.3 → 3.0.5

package/dungeons/gaming.js

@@ -11,7 +11,146 @@ const chance = u.initChance(SEED);
 const num_users = 12_000;
 const days = 180;
 
-/** @typedef  {import("../types.js").Dungeon} Config */
+/** @typedef  {import("../types.d.ts").Dungeon} Config */
+
+/*
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * DATASET OVERVIEW
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * QuestForge — A D&D-inspired action RPG where players create characters,
+ * join parties, embark on quests, fight bosses, and level up. Think Baldur's
+ * Gate meets a mobile RPG with in-game purchases and seasonal content.
+ *
+ * CORE USER LOOP:
+ * Players install the app, create a character (race + class + alignment),
+ * and join a party. They then cycle through quests — starting quests,
+ * engaging in gameplay (attacks, defenses, enemy defeats), completing quests
+ * for gold rewards, fighting bosses, and leveling up. In-game purchases
+ * (gold, gems, weapons, armor, boosts) monetize the experience.
+ *
+ * SCALE: 12,000 users, ~1.08M events, 180 days
+ *
+ * KEY DIMENSIONS:
+ * - Platform: Mobile, Xbox, Playstation, Switch, Web
+ * - Game mode: Single Player vs Multiplayer (biased toward Multiplayer)
+ * - Character: 9 races, 12 classes, 9 alignments, 13 backgrounds
+ * - Quests: 5 types, 4 difficulties, 5 locations
+ * - Experiment: fast leveling / tension economy / free trial with A/B/C/Control
+ *
+ * FUNNELS:
+ * 1. Onboarding: app install → character creation → join party (80% conversion)
+ * 2. Quest loop: start quest → gameplay summary → complete quest (99% conversion)
+ */
+
+/*
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * ANALYTICS HOOKS
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * This dungeon has 3 deliberate patterns engineered via hooks:
+ *
+ * ───────────────────────────────────────────────────────────────────────────────
+ * 1. GOLD SCALING BY LEVEL (event hook)
+ * ───────────────────────────────────────────────────────────────────────────────
+ *
+ * PATTERN: On "complete quest" events, the quest reward (gold) is multiplied by
+ * (1 + level * 0.1), so a level-10 player earns 2x gold and a level-20 player
+ * earns 3x gold compared to level-1.
+ *
+ * HOW TO FIND IT IN MIXPANEL:
+ *   - Report type: Insights
+ *   - Event: "complete quest"
+ *   - Measure: Average of "quest reward (gold)"
+ *   - Breakdown: "level at end"
+ *   - Expected: Linear increase — level 1 ≈ 55 gold, level 10 ≈ 110 gold,
+ *     level 20 ≈ 165 gold. Clear positive correlation between level and reward.
+ *
+ * ───────────────────────────────────────────────────────────────────────────────
+ * 2. WHALE PURCHASES (event hook)
+ * ───────────────────────────────────────────────────────────────────────────────
+ *
+ * PATTERN: ~33% of users (determined by first character of user_id hash) are
+ * "whales" who spend 1.8x on in-game purchases and are tagged is_whale: true.
+ *
+ * HOW TO FIND IT IN MIXPANEL:
+ *
+ *   Report 1: Whale vs Normal Purchase Amounts
+ *   - Report type: Insights
+ *   - Event: "in-game purchase"
+ *   - Measure: Average of "purchase amount"
+ *   - Breakdown: "is_whale"
+ *   - Expected: is_whale=true shows ~1.8x higher avg purchase amount than
+ *     is_whale=false (e.g., ~18 vs ~10)
+ *
+ *   Report 2: Revenue Concentration
+ *   - Report type: Insights
+ *   - Event: "in-game purchase"
+ *   - Measure: Sum of "purchase amount"
+ *   - Breakdown: "is_whale"
+ *   - Expected: ~33% of users (whales) contribute disproportionate total revenue
+ *
+ * ───────────────────────────────────────────────────────────────────────────────
+ * 3. ALIGNMENT ARCHETYPE (user hook)
+ * ───────────────────────────────────────────────────────────────────────────────
+ *
+ * PATTERN: User profiles are enriched with an "archetype" property based on
+ * alignment. Evil alignments → "villain", Good alignments → "hero", others → "neutral".
+ *
+ * HOW TO FIND IT IN MIXPANEL:
+ *
+ *   Report 1: Archetype Distribution
+ *   - Report type: Insights
+ *   - Event: Any event (e.g., "complete quest")
+ *   - Measure: Total unique users
+ *   - Breakdown: User profile "archetype"
+ *   - Expected: Three segments — "hero" (~22%), "villain" (~22%), "neutral" (~56%)
+ *     matching the 2/9, 2/9, 5/9 alignment split
+ *
+ *   Report 2: Archetype Behavior Comparison
+ *   - Report type: Insights
+ *   - Event: "fight boss"
+ *   - Measure: Total events per user
+ *   - Breakdown: User profile "archetype"
+ *   - Expected: All three archetypes should show similar event volumes
+ *     (archetype doesn't affect gameplay — just a profiling hook)
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * EXPECTED METRICS SUMMARY
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * Hook                    | Metric                  | Baseline | Hook Effect  | Ratio
+ * ────────────────────────|─────────────────────────|──────────|──────────────|──────
+ * Gold Scaling            | Avg gold at level 1     | ~55      | ~55          | 1.0x
+ * Gold Scaling            | Avg gold at level 10    | ~55      | ~110         | 2.0x
+ * Gold Scaling            | Avg gold at level 20    | ~55      | ~165         | 3.0x
+ * Whale Purchases         | Avg purchase (whale)    | ~10      | ~18          | 1.8x
+ * Whale Purchases         | Revenue share (whale)   | ~33%     | >50%         | disprop.
+ * Alignment Archetype     | Hero users              | —        | ~22%         | 2/9
+ * Alignment Archetype     | Villain users           | —        | ~22%         | 2/9
+ * Alignment Archetype     | Neutral users           | —        | ~56%         | 5/9
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ * ADVANCED ANALYSIS IDEAS
+ * ═══════════════════════════════════════════════════════════════════════════════
+ *
+ * 1. Gold Economy Analysis: Plot avg gold earned by level AND quest difficulty.
+ *    Do Legendary quests at high levels create outsized gold rewards?
+ *
+ * 2. Whale Segmentation: Cross-reference is_whale with platform and game mode.
+ *    Are whales concentrated on mobile? Do multiplayer whales spend more?
+ *
+ * 3. Archetype × Class Matrix: Do certain class/archetype combos correlate
+ *    with higher boss fight rates or quest completion?
+ *
+ * 4. Experiment Impact: Compare "fast leveling" vs "tension economy" vs
+ *    "free trial" on purchase amounts, level progression, and retention.
+ *
+ * 5. Quest Difficulty Funnel: How does quest difficulty affect completion
+ *    rate, death count, and hint/boost usage? Is "Legendary" too hard?
+ *
+ * ═══════════════════════════════════════════════════════════════════════════════
+ */
 
 /** @type {Config} */
 const config = {
@@ -51,26 +190,26 @@ const config = {
 			conversionRate: 0.99,
 			timeToConvert: 1,
 			props: {
-				"quest type": u.pickAWinner([
+				"quest type": [
 					"Rescue",
 					"Retrieve",
 					"Explore",
 					"Destroy",
 					"Investigate",
-				]),
-				"quest difficulty": u.pickAWinner([
+				],
+				"quest difficulty": [
 					"Easy",
 					"Medium",
 					"Hard",
 					"Legendary",
-				]),
-				"quest location": u.pickAWinner([
+				],
+				"quest location": [
 					"Forest",
 					"Dungeon",
 					"Mountain",
 					"City",
 					"Desert",
-				])
+				]
 			}
 		},
 	],
@@ -80,7 +219,7 @@ const config = {
 			event: "character creation",
 			weight: 2,
 			properties: {
-				mode: u.pickAWinner(["fast", "slow", "template"]),
+				mode: ["fast", "slow", "template"],
 			},
 		},
 		{
@@ -88,7 +227,7 @@ const config = {
 			weight: 8,
 			properties: {
 				"party size": u.weighNumRange(1, 6),
-				"party leader": u.pickAWinner([
+				"party leader": [
 					"Bard",
 					"Cleric",
 					"Fighter",
@@ -98,33 +237,33 @@ const config = {
 					"Ranger",
 					"Sorcerer",
 					"Warlock",
-				]),
+				],
 			},
 		},
 		{
 			event: "start quest",
 			weight: 12,
 			properties: {
-				"quest type": u.pickAWinner([
+				"quest type": [
 					"Rescue",
 					"Retrieve",
 					"Explore",
 					"Destroy",
 					"Investigate",
-				]),
-				"quest difficulty": u.pickAWinner([
+				],
+				"quest difficulty": [
 					"Easy",
 					"Medium",
 					"Hard",
 					"Legendary",
-				]),
-				"quest location": u.pickAWinner([
+				],
+				"quest location": [
 					"Forest",
 					"Dungeon",
 					"Mountain",
 					"City",
 					"Desert",
-				]),
+				],
 				"party size": u.weighNumRange(1, 6),
 				"used hint": u.pickAWinner(["yes", "no"], 0.3),
 				"used boost": u.pickAWinner(["yes", "no"], 0.2),
@@ -159,7 +298,7 @@ const config = {
 			"event": "in-game purchase",
 			"weight": 2,
 			"properties": {
-				"purchase type": u.pickAWinner([
+				"purchase type": [
 					"Gold",
 					"Gems",
 					"Items: Weapons",
@@ -168,7 +307,7 @@ const config = {
 					"Items: Scrolls",
 					"Boosts",
 					"Currency",
-				]),
+				],
 				"purchase amount": u.weighNumRange(1, 50, 1, 20),
 			}
 		},
@@ -176,63 +315,63 @@ const config = {
 			event: "fight boss",
 			weight: 3,
 			properties: {
-				"boss type": u.pickAWinner([
+				"boss type": [
 					"Dragon",
 					"Demon",
 					"Lich",
 					"Vampire",
 					"Beholder",
-				]),
+				],
 				"boss level": u.weighNumRange(10, 20),
-				"boss difficulty": u.pickAWinner([
+				"boss difficulty": [
 					"Hard",
 					"Legendary",
 					"Impossible",
-				]),
+				],
 				"fight duration (mins)": u.weighNumRange(1, 60),
-				
+
 			},
 		},
 		{
 			event: "level up",
 			weight: 1,
 			properties: {
-				"new abilities": u.pickAWinner([
+				"new abilities": [
 					"Attack",
 					"Spell",
 					"Feat",
 					"Skill",
-				]),
+				],
 			},
 		},
 		{
 			event: "attack",
 			weight: 5,
 			properties: {
-				generic_prop: u.pickAWinner(["foo", "bar", "baz", "qux"]),
+				generic_prop: ["foo", "bar", "baz", "qux"],
 			}
 		},
 		{
 			event: "defend",
 			weight: 3,
 			properties: {
-				generic_prop: u.pickAWinner(["foo", "bar", "baz", "qux"]),
+				generic_prop: ["foo", "bar", "baz", "qux"],
 			}
 		},
 	],
 	superProps: {
-		platform: u.pickAWinner([
+		platform: [
 			"Mobile",
 			"Xbox",
 			"Playstation",
 			"Switch",
 			"Web"
-		]),
+		],
 		"game mode": u.pickAWinner([
 			"Single Player",
 			"Multiplayer",
 		], 1),
-		language: u.pickAWinner([
+		language: [
 			"English",
 			"Spanish",
 			"French",
@@ -240,7 +379,7 @@ const config = {
 			"Japanese",
 			"Korean",
 			"Chinese",
-		], 0),
+		],
 
 	},
 	scdProps: {
@@ -249,18 +388,18 @@ const config = {
 		// 	"type": "number",
 		// 	values: u.weighNumRange(0, 250, 1, 200),
 		// 	timing: "fixed",
-		// 	max: 250,			
+		// 	max: 250,
 		// }
 	},
 	userProps: {
-		experiment: u.pickAWinner([
+		experiment: [
 			"fast leveling",
 			"tension economy",
 			"free trial",
-		]),
+		],
 		variant: ["A", "B", "C", "Control"],
 
-		race: u.pickAWinner([
+		race: [
 			"Human",
 			"Elf",
 			"Dwarf",
@@ -270,8 +409,8 @@ const config = {
 			"Half-Elf",
 			"Half-Orc",
 			"Tiefling",
-		]),
-		class: u.pickAWinner([
+		],
+		class: [
 			"Barbarian",
 			"Bard",
 			"Cleric",
@@ -284,8 +423,8 @@ const config = {
 			"Sorcerer",
 			"Warlock",
 			"Wizard",
-		]),
-		alignment: u.pickAWinner([
+		],
+		alignment: [
 			"Lawful Good",
 			"Neutral Good",
 			"Chaotic Good",
@@ -295,9 +434,9 @@ const config = {
 			"Lawful Evil",
 			"Neutral Evil",
 			"Chaotic Evil",
-		]),
+		],
 		level: u.weighNumRange(1, 20),
-		background: u.pickAWinner([
+		background: [
 			"Acolyte",
 			"Charlatan",
 			"Criminal",
@@ -311,9 +450,10 @@ const config = {
 			"Sailor",
 			"Soldier",
 			"Urchin",
-		]),
+		],
 		"subscription MRR": u.weighNumRange(0, 250, 1, 200)
 	},
+	// HOOK: 3 patterns — gold scaling by level, whale purchases, alignment archetype
 	hook: function (record, type, meta) {
 
 		if (type === "event") {

package/dungeons/insurance-application-schema.json

@@ -0,0 +1,204 @@
+{
+  "events": [
+    {
+      "event": "account created",
+      "weight": 1,
+      "isFirstEvent": true,
+      "properties": {
+        "signup_source": ["web", "mobile", "agent_referral", "partner"],
+        "account_type": ["individual", "family", "business"]
+      }
+    },
+    {
+      "event": "page viewed",
+      "weight": 10,
+      "properties": {
+        "page_name": ["home", "quotes", "coverage_options", "claims", "faq", "profile", "payment", "documents"],
+        "referrer": ["direct", "google", "email", "social_media"]
+      }
+    },
+    {
+      "event": "quote requested",
+      "weight": 5,
+      "properties": {
+        "coverage_level": ["basic", "standard", "premium"],
+        "deductible": { "$range": [250, 5000] }
+      }
+    },
+    {
+      "event": "quote received",
+      "weight": 4,
+      "properties": {
+        "monthly_premium": { "$range": [30, 800] },
+        "coverage_amount": { "$range": [10000, 500000] },
+        "quote_comparison_count": { "$range": [1, 5] }
+      }
+    },
+    {
+      "event": "application started",
+      "weight": 4,
+      "properties": {
+        "coverage_level": ["basic", "standard", "premium"],
+        "estimated_premium": { "$range": [30, 800] }
+      }
+    },
+    {
+      "event": "application step completed",
+      "weight": 6,
+      "properties": {
+        "step_name": ["personal_info", "coverage_selection", "medical_history", "vehicle_info", "beneficiary", "review"],
+        "step_number": { "$range": [1, 6] },
+        "time_on_step_sec": { "$range": [15, 600] }
+      }
+    },
+    {
+      "event": "document uploaded",
+      "weight": 3,
+      "properties": {
+        "document_type": ["drivers_license", "proof_of_address", "vehicle_registration", "medical_records", "property_photos"],
+        "file_size_kb": { "$range": [50, 5000] }
+      }
+    },
+    {
+      "event": "application submitted",
+      "weight": 3,
+      "properties": {
+        "documents_attached": { "$range": [1, 5] },
+        "application_time_min": { "$range": [5, 60] }
+      }
+    },
+    {
+      "event": "application approved",
+      "weight": 2,
+      "properties": {
+        "approved_premium": { "$range": [30, 800] },
+        "approval_time_hours": { "$range": [1, 72] }
+      }
+    },
+    {
+      "event": "policy activated",
+      "weight": 2,
+      "properties": {
+        "policy_term_months": [6, 12, 12, 12, 24],
+        "effective_date_offset_days": { "$range": [0, 30] }
+      }
+    },
+    {
+      "event": "claim filed",
+      "weight": 2,
+      "properties": {
+        "claim_type": ["collision", "theft", "water_damage", "fire", "medical", "liability"],
+        "estimated_amount": { "$range": [100, 50000] }
+      }
+    },
+    {
+      "event": "claim status checked",
+      "weight": 4,
+      "properties": {
+        "claim_status": ["submitted", "under_review", "approved", "denied", "payment_pending"],
+        "days_since_filed": { "$range": [1, 60] }
+      }
+    },
+    {
+      "event": "payment made",
+      "weight": 5,
+      "properties": {
+        "payment_method": ["credit_card", "bank_transfer", "auto_pay", "check"],
+        "amount": { "$range": [30, 800] },
+        "payment_status": ["success", "success", "success", "success", "failed"]
+      }
+    },
+    {
+      "event": "support ticket created",
+      "weight": 4,
+      "properties": {
+        "issue_category": ["billing", "claims", "coverage", "technical", "policy_change"],
+        "priority": ["low", "medium", "medium", "high"],
+        "channel": ["chat", "phone", "email", "web_form"]
+      }
+    },
+    {
+      "event": "support ticket resolved",
+      "weight": 3,
+      "properties": {
+        "resolution_type": ["self_service", "agent_assisted", "escalated", "auto_resolved"],
+        "satisfaction_score": { "$range": [1, 5] },
+        "resolution_time_hours": { "$range": [1, 72] }
+      }
+    },
+    {
+      "event": "coverage reviewed",
+      "weight": 4,
+      "properties": {
+        "current_premium": { "$range": [30, 800] },
+        "coverage_adequate": [true, true, true, false]
+      }
+    },
+    {
+      "event": "profile updated",
+      "weight": 2,
+      "properties": {
+        "field_updated": ["address", "phone", "email", "beneficiary", "payment_method", "vehicle_info"]
+      }
+    },
+    {
+      "event": "renewal completed",
+      "weight": 2,
+      "properties": {
+        "renewal_premium": { "$range": [30, 800] },
+        "premium_change_pct": { "$range": [-15, 20] },
+        "auto_renewed": [true, true, false]
+      }
+    }
+  ],
+  "superProps": {
+    "platform": ["web", "ios", "android"],
+    "insurance_type": ["auto", "home", "life", "health", "renters"]
+  },
+  "userProps": {
+    "age_range": ["18-25", "26-35", "36-45", "46-55", "56-65", "65+"],
+    "risk_profile": ["low", "medium", "high"],
+    "policy_count": { "$range": [0, 5] },
+    "lifetime_premium": { "$range": [0, 50000] },
+    "preferred_contact": ["email", "phone", "app_notification"]
+  },
+  "funnels": [
+    {
+      "name": "Onboarding",
+      "sequence": ["account created", "page viewed", "quote requested"],
+      "isFirstFunnel": true,
+      "conversionRate": 85,
+      "timeToConvert": 0.5
+    },
+    {
+      "name": "Application Completion",
+      "sequence": ["application started", "application step completed", "document uploaded", "application submitted"],
+      "conversionRate": 60,
+      "timeToConvert": 48,
+      "weight": 4,
+      "order": "sequential"
+    },
+    {
+      "name": "Application Approval",
+      "sequence": ["application submitted", "application approved", "policy activated"],
+      "conversionRate": 70,
+      "timeToConvert": 72,
+      "weight": 3,
+      "order": "sequential"
+    },
+    {
+      "name": "Claims Process",
+      "sequence": ["claim filed", "claim status checked", "support ticket created"],
+      "conversionRate": 50,
+      "timeToConvert": 24,
+      "weight": 2
+    },
+    {
+      "name": "Policy Renewal",
+      "sequence": ["coverage reviewed", "payment made", "renewal completed"],
+      "conversionRate": 65,
+      "timeToConvert": 72,
+      "weight": 3
+    }
+  ]
+}