Usurper Reborn v0.9 - Analytics & Telemetry Update

This release adds an opt-in PostHog analytics system to help gather insights during alpha testing, enabling better game balance decisions and understanding player behavior.

New Features

PostHog Telemetry System

A privacy-focused, opt-in analytics system for alpha testing insights:

• Combat Tracking - Outcomes, damage dealt, monsters killed, boss fights
• Shop Transactions - Items bought/sold at weapon, armor, and healer shops
• Achievement Unlocks - Track which achievements players are earning
• Dungeon Exploration - Floor progression, feature interactions, room discoveries
• Level Ups - Track level progression and stat choices
• Quest System - Quest acceptance and completion rates
• Player Deaths - Death tracking for difficulty balancing
• Session Analytics - Playtime, final level, kills, and deaths on session end

Privacy Features

• Opt-In Only - Telemetry is disabled by default
• GeoIP Disabled - No location tracking from IP addresses
• Anonymous IDs - No personal information collected
• Local ID Storage - Persistent ID stored locally in .telemetry_id

Dashboard Support

Powers PostHog's built-in analytics dashboards:

• Daily Active Users (DAU)
• Weekly Active Users (WAU)
• Monthly Active Users (MAU)
• Growth Accounting (new/returning/churned users)
• Retention Analysis

Technical Details

• Event Batching - Up to 20 events batched together, flushed every 10 seconds
• Background Threading - Telemetry doesn't block gameplay
• Graceful Degradation - Failures silently ignored, game continues normally
• API Integration - Uses PostHog Batch API (/batch/ endpoint)

Files Changed

New Files

• Scripts/Systems/TelemetrySystem.cs - Core telemetry implementation

Modified Files

• Scripts/Core/GameEngine.cs - Session start/end, game load, character creation
• Scripts/Core/GameConfig.cs - Telemetry opt-in setting
• Scripts/Systems/CombatEngine.cs - Combat outcomes, deaths
• Scripts/Systems/QuestSystem.cs - Quest accept/complete tracking
• Scripts/Systems/AchievementSystem.cs - Achievement unlocks
• Scripts/Systems/CompanionSystem.cs - Companion join/death events
• Scripts/Systems/SaveSystem.cs - Telemetry state persistence
• Scripts/Locations/WeaponShopLocation.cs - Shop transactions
• Scripts/Locations/ArmorShopLocation.cs - Shop transactions
• Scripts/Locations/HealerLocation.cs - Shop transactions
• Scripts/Locations/DungeonLocation.cs - Dungeon exploration
• Scripts/Locations/LevelMasterLocation.cs - Level ups
• Scripts/Locations/MainStreetLocation.cs - Session end
• .gitignore - Exclude telemetry config file

How to Enable Telemetry

Telemetry is opt-in only. To enable:

1. In-game, telemetry can be toggled via the preferences menu or at new game creation.

Upgrade Notes

• Save files from v0.8 are fully compatible
• No breaking changes to existing systems

Full Changelog: v0.8...v0.9

Download: Check the Releases page for packaged builds.

Report Issues: https://discord.gg/BqY66QkPGE or GitHub Issues