HOW HEALTHKIT DATA MAPS TO RPG STATS
The Complete Guide
By Samuel Coe, founder of Fitscape | Last Updated: February 2026
Apple HealthKit stores workout data in a standardized format — each workout has a type (e.g., HKWorkoutActivityType.running), a duration, a calorie burn, and sometimes distance or heart rate. Fitscape reads this data and maps each activity type to one of six D&D-inspired RPG stats: Strength (power training), Dexterity (speed sports), Constitution (endurance), Intelligence (mindful movement), Wisdom (meditation), and Charisma (group exercise). The amount of XP earned scales with workout duration and intensity. This creates a direct, transparent link between real-world fitness behavior and virtual character progression.
The Stat Mapping System: How It Was Designed
The HealthKit-to-stat mapping in Fitscape was designed around one principle: the fictional RPG category should match the real-world physiological benefit of the activity. Strength in D&D represents raw physical power — so activities that build muscle (weightlifting, HIIT) map to STR. Dexterity represents speed and agility — so fast-paced sports and running map to DEX. Constitution represents endurance and resilience — so long, sustained cardio maps to CON.
The less obvious mappings are the mindfulness stats. Intelligence in Fitscape represents the mind-body connection — activities like yoga and Pilates require focused concentration on body mechanics, making them the best analog. Wisdom represents inner clarity and awareness — meditation and Tai Chi directly cultivate these. Charisma represents social presence — group exercise is inherently social and communal.
Complete HealthKit-to-Stat Mapping Table
| RPG Stat | Abbrev. | HealthKit Activity Types | Real-World Benefit | Game Bonus |
|---|---|---|---|---|
| Strength | STR | Weightlifting, HIIT, Functional Strength, Core Training, Calisthenics | Muscle mass, power output | +1 Inventory slot/level |
| Dexterity | DEX | Running, Cycling, Soccer, Basketball, Tennis, Kickboxing, Martial Arts | Speed, agility, coordination | Agility weapon effectiveness |
| Constitution | CON | Hiking, Swimming, Long Walking, Elliptical, Rowing, Stair Climbing | Cardiovascular endurance, resilience | +5 max Health/level |
| Intelligence | INT | Yoga, Pilates, Barre, Mindful Cooldowns, Flexibility Training | Body awareness, flexibility, mind-body connection | +3 max Mana/level |
| Wisdom | WIS | Meditation, Tai Chi, Mindfulness Practice, Breathwork | Stress reduction, mental clarity, recovery | +2 max Stamina/level |
| Charisma | CHA | Group Fitness Classes, Dancing, Team Sports, CrossFit Groups, Zumba | Social accountability, community, motivation | NPC interaction bonuses |
How Is XP Calculated from HealthKit Data?
XP calculation uses two primary signals from HealthKit. First, the workout type determines which stat receives the XP. Second, the duration and, when available, the active calorie burn determine how much XP is awarded.
| XP Factor | Source in HealthKit | Effect on XP |
|---|---|---|
| Activity Type | HKWorkoutActivityType enum | Determines which stat (STR/DEX/CON/INT/WIS/CHA) receives the XP |
| Duration | Workout duration (seconds) | Base XP — longer sessions earn proportionally more |
| Active Calories | HKQuantityTypeIdentifier.activeEnergyBurned | Intensity multiplier — harder effort earns more per minute |
| Distance | HKQuantityTypeIdentifier.distanceWalkingRunning | Used for dungeon exploration progress tracking |
Practical Examples
45-min Weightlifting Session
Maps to STR. Earns significant STR XP scaled to duration and calorie burn. Each STR level unlocks +1 inventory slot.
10km Outdoor Run
Maps to DEX. Distance data advances dungeon progress. XP scales with pace and duration.
20-min Meditation Session
Maps to WIS via mindfulness minutes logged to Apple Health. Earns WIS XP that increases max Stamina by 2 per level.
60-min Yoga Class
Maps to INT. Earns substantial INT XP that increases max Mana by 3 per level, enabling more spell usage in dungeons.
How Stats Affect Your Resource Pools
Each stat level translates directly to a game resource. This is the core feedback loop: exercise more of a specific type, the matching stat grows, and your character's capabilities expand in that domain.
| Stat | Bonus Per Level | What It Unlocks In-Game |
|---|---|---|
| STR | +1 Inventory slot | Carry more items and loot from dungeons |
| DEX | Agility weapon & skill effectiveness | Better performance with speed-based combat options |
| CON | +5 max Health | Survive more dungeon encounters before defeat |
| INT | +3 max Mana | Cast more spells and use more magical skills per dungeon |
| WIS | +2 max Stamina | Explore dungeons further before exhausting Stamina |
| CHA | NPC interaction bonuses | Access exclusive dialogue, better merchant prices, social skills |
Stamina, Recovery, and the Readiness Score
One of the most innovative HealthKit integrations in Fitscape is the readiness-based Stamina restoration. Stamina is fully restored overnight, but the amount restored is proportional to your readiness score — a metric derived from your recent workout load and recovery patterns visible in HealthKit.
This mechanic creates a healthy feedback loop: overtraining without recovery leads to lower Stamina the next day, limiting your dungeon exploration. Balanced training with adequate rest results in high readiness and full Stamina pools. The game literally rewards healthy recovery behavior.
Frequently Asked Questions
How does Apple HealthKit connect to an RPG game?
Apple HealthKit provides a standardized API for reading workout and health data from iPhone and Apple Watch. Fitscape uses this API to read your workout sessions, identify the activity type, and convert duration and intensity into XP for the matching RPG character stat. No special hardware is required — any HealthKit-compatible tracker works.
Which activities in HealthKit map to which RPG stats?
In Fitscape: Strength training and HIIT map to STR (Strength). Running, cycling, and sports map to DEX (Dexterity). Hiking, swimming, and long cardio map to CON (Constitution). Yoga and Pilates map to INT (Intelligence). Meditation and Tai Chi map to WIS (Wisdom). Group fitness and dancing map to CHA (Charisma).
Do I need an Apple Watch for Fitscape to work?
No. Any HealthKit-compatible data source works: Apple Watch, Garmin, Strava, Peloton, Nike Run Club, or any app that writes to Apple Health. Even manual workout entries in the Health app are recognized by Fitscape.
Is my health data private when using Fitscape?
Yes. Fitscape reads only the HealthKit categories you explicitly authorize. Your health data is used solely to calculate XP and is never sold or shared with advertisers. You can revoke permissions at any time via iOS Settings.
How does Fitscape calculate XP from HealthKit data?
XP is based on workout type, duration, and intensity (active calories burned when available). A 30-minute intense weightlifting session earns more STR XP than a 30-minute casual walk. The formula rewards consistent, genuine effort over time.
Start Building Your RPG Character Today
Download Fitscape free and connect your Apple Health data to begin your adventure.
Download on the App Store