Skip to content

Alpha v0.9: Analytics & Telemetry Update

Choose a tag to compare

View all tags
@binary-knight binary-knight released this 19 Jan 05:29
v0.9
6f4bead

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

Assets 7
Loading