GTA
/
training-academy
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 3 Wiki Activity
training-academy/docs/MODULE_RANK_SYSTEM.md

13 KiB
Raw Permalink Blame History

Module Unlock Rank System

Training Module Progression by User Rank

System: Training Modules are unlocked as users gain XP and advance through User Ranks (not Campaign Levels). This creates progression without the rigid structure of the 30-level campaign, allowing users to gradually access more advanced training experiences.

📊 User Rank vs Campaign Level

Key Distinction:

  • User Rank = Global XP-based progression (20 ranks from Virgin to Omnipotent)
  • Campaign Level = 30-level story progression in Campaign Mode (separate system)

Why Separate?

  • User Rank applies across ALL game modes (Training Modules, Quick Play, Cinema, etc.)
  • Campaign Levels only exist within Campaign Mode
  • Users can advance in Rank without touching Campaign Mode
  • Prevents confusion between "Level 5 in Campaign" vs "Rank 5 (Lustful)"

🎖️ User Rank Progression Table

Based on playerStats.js XP system with adjusted progression (slows after Rank 10):

Rank Name XP Required Gain From Prev Icon Description
1 Virgin 0 - 🌱 Your first taste of pleasure awaits
2 Curious 10 +10 🌿 Start exploring your desires
3 Eager 25 +15 🌱 Developing your appetites
4 Aroused 48 +23 🌿 Your arousal is building
5 Lustful 82 +34 🌟 Consumed by lust and craving more
6 Passionate 133 +51 🔥 Your passion burns hot with desire
7 Addicted 209 +76 ⭐ Hopelessly addicted to pleasure
8 Obsessed 323 +114 🎯 Your obsession drives you to new heights
9 Deviant 494 +171 🏆 A true deviant exploring desire
10 Kinky 751 +257 💎 Welcome to the kinky elite
11 Perverted 1100 +349 🌟 A seasoned pervert with experience
12 Depraved 1500 +400 🔮 Mastered the art of depravity
13 Dominant 1950 +450 👑 A dominant force commanding respect
14 Submissive 2450 +500 🚀 Embracing submission and control
15 Hedonist 3000 +550 🌌 Pure hedonism guides your moves
16 Insatiable 3600 +600 ⚡ Your appetite knows no bounds
17 Transcendent 4250 +650 🔥 Transcending mortal desire
18 Enlightened 4950 +700 🌠 Achieved enlightened pleasure
19 Godlike 5700 +750 🏛️ Godlike levels of sexual prowess
20 Omnipotent 6500 +800 👁️ Ultimate master of pleasure

Progression Notes:

  • Ranks 1-10: Exponential growth (~1.5x multiplier per rank)
  • Ranks 11-20: Linear growth (+50 XP increase per rank)
  • Reasoning: Keeps early game exciting, prevents late game from becoming unreachable grind

🔓 Training Module Unlock Tiers

Tier 1: Beginner Modules (Unlocked at Rank 1 - Virgin)

Available Immediately - No XP Required

  1. 📸 Photo Session (Photography Studio)

    • Unlock: Rank 1 (0 XP)
    • Reason: Webcam-based, inventory-driven, good starter content
    • Complexity: Medium (scenario-based)

  2. 🌀 Goon Loop

    • Unlock: Rank 1 (0 XP)
    • Reason: Simple concept, repetitive content, easy to understand
    • Complexity: Low (basic looping)

Tier 2: Intermediate Modules (Ranks 3-5)

Light Experience Required

  1. 🎵 Rhythm Training

    • Unlock: Rank 3 - Eager (25 XP)
    • Reason: Requires understanding of pacing and control
    • Complexity: Medium (metronome coordination)

  2. 🙏 Worship Session ⚠️

    • Unlock: Rank 5 - Lustful (82 XP)
    • Reason: Requires curated library (content-gated) + understanding of categories
    • Complexity: Medium (library-dependent)
    • Additional Requirement: 20+ tagged items in chosen worship category

Tier 3: Advanced Modules (Ranks 7-10)

Dedicated Users

  1. 🎙️ JOI Session

    • Unlock: Rank 7 - Addicted (209 XP)
    • Reason: Complex TTS interaction, instruction-following mindset
    • Complexity: High (TTS coordination)

  2. 📺 Multi-Screen

    • Unlock: Rank 8 - Obsessed (323 XP)
    • Reason: Sensory overload, requires experience with simpler modes first
    • Complexity: High (multiple video streams)

Tier 4: Expert Modules (Ranks 10-12)

Elite Training

  1. 🎭 Tease & Denial

    • Unlock: Rank 10 - Kinky (751 XP)
    • Reason: Advanced control techniques, psychological challenge
    • Complexity: High (edge control discipline)

  2. 😈 Humiliation (Punishment Gauntlet)

    • Unlock: Rank 12 - Depraved (1716 XP)
    • Reason: Intense psychological content, branching narrative complexity
    • Complexity: Very High (scenario-adventure, multiple paths)

📋 Module Unlock Summary

Module Icon Unlock Rank XP Required Tier
Photo Session 📸 1 - Virgin 0 Beginner
Goon Loop 🌀 1 - Virgin 0 Beginner
Rhythm Training 🎵 3 - Eager 25 Intermediate
Worship Session 🙏 5 - Lustful 82 Intermediate
JOI Session 🎙️ 7 - Addicted 209 Advanced
Multi-Screen 📺 8 - Obsessed 323 Advanced
Tease & Denial 🎭 10 - Kinky 751 Expert
Humiliation 😈 12 - Depraved 1500 Expert

🎮 Unlock Progression Flow

Early Game (Ranks 1-2):

  • 2 modules available (Photo Session, Goon Loop)
  • Focus on basic training and earning first XP

Mid Game (Ranks 3-6):

  • +2 modules unlocked (Rhythm Training, Worship Session)
  • 4 total modules, variety increases

Late Game (Ranks 7-9):

  • +2 modules unlocked (JOI Session, Multi-Screen)
  • 6 total modules, advanced features

End Game (Ranks 10+):

  • +2 modules unlocked (Tease & Denial, Humiliation)
  • All 8 modules available
  • Full training suite accessible

🎯 Design Philosophy

Why Tiered Unlocks?

  1. Progressive Complexity

    • Simpler modules first (Goon Loop, Photo Session)
    • Advanced features later (Multi-Screen, Humiliation)
    • Users build skills before accessing complex content

  2. Reward Dedication

    • Unlocking modules feels earned
    • XP investment creates attachment
    • Progression motivates continued play

  3. Prevent Overwhelm

    • New users not bombarded with 8 modules
    • Gradual feature discovery
    • Clearer understanding of each module

  4. Encourage XP Earning

    • Drives engagement across all game modes
    • Quick Play, Cinema, Campaign all feed into Rank
    • Creates unified progression system

  5. Match Intensity to Experience

    • Beginners start gentle (Photo Session, Goon Loop)
    • Advanced users get intense content (Humiliation, Tease & Denial)
    • Psychological safety progression

🔒 Module Lock UI Design

Locked Module Display:

╔══════════════════════════════════════╗
║  🎭 Tease & Denial                   ║
║                                      ║
║  🔒 LOCKED                           ║
║  Unlock at Rank 10 - Kinky           ║
║  Current Rank: 7 - Addicted          ║
║                                      ║
║  Progress: 209 / 751 XP              ║
║  ▓▓▓▓▓▓▓▓░░░░░░░░░░░░ 27%           ║
║                                      ║
║  "Prove your dedication to unlock"   ║
╚══════════════════════════════════════╝

Unlocked Module Display:

╔══════════════════════════════════════╗
║  🎵 Rhythm Training                  ║
║                                      ║
║  ✅ UNLOCKED                         ║
║  Rank 3 - Eager                      ║
║                                      ║
║  [▶ START SESSION]                  ║
║  [⚙️ CUSTOMIZE]                      ║
╚══════════════════════════════════════╝

Nearly Unlocked (Teaser):

When user is within 50 XP of unlocking a module, show teaser:

╔══════════════════════════════════════╗
║  📺 Multi-Screen                     ║
║                                      ║
║  🔓 ALMOST UNLOCKED!                 ║
║  Only 47 XP away!                    ║
║                                      ║
║  Current: 276 / 323 XP               ║
║  ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓░░░ 85%           ║
║                                      ║
║  "So close... keep training"         ║
╚══════════════════════════════════════╝

💬 Unlock Notification Messages

When a module is unlocked, display a dominant unlock message:

Rank 3 - Rhythm Training Unlocked:

"You've earned access to Rhythm Training. Now prove you can follow a beat, or will you lose control?"

Rank 5 - Worship Session Unlocked:

"Worship Session is now available. But can you truly worship without a proper collection? Build your library first."

Rank 7 - JOI Session Unlocked:

"You've unlocked JOI Session. Time to let the voice control you. Can you follow instructions, or will you fail?"

Rank 8 - Multi-Screen Unlocked:

"Multi-Screen chaos awaits. Think you can handle multiple videos at once? Most can't."

Rank 10 - Tease & Denial Unlocked:

"Tease & Denial is yours. Can you edge without cumming? Doubtful. Prove me wrong."

Rank 12 - Humiliation Unlocked:

"You've reached Depraved. Humiliation training is unlocked. Let's see if you can handle what I have planned for you."

🎲 XP Earning Across Game Modes

How Users Earn XP to Unlock Modules:

Activity XP Gained Notes
Quick Play (per task) 5-15 XP Based on task difficulty
Quick Play (session completion) 10-30 XP Based on session length
Porn Cinema (per 5 min watched) 1 XP Passive viewing
Campaign Level Completion 20-50 XP Per level completed
Scenario Completion 15-40 XP Interactive scenarios
Training Module Completion 10-25 XP Per module session
Photo Session (tier completion) 15-50 XP Based on tier (1-5)
Achievements 5-25 XP One-time bonuses

Example XP Journey:

  • Start: Rank 1 (0 XP) - 2 modules available
  • After 3 Quick Play sessions: ~45 XP - Still Rank 2
  • After 1 campaign level: ~70 XP - Rank 3 unlocked (Rhythm Training)
  • After 2 more sessions: ~95 XP - Rank 5 unlocked (Worship Session)
  • Continue playing to unlock advanced modules

🔄 Migration & Implementation

Technical Implementation:

  1. Check User Rank on Module Screen Load

    const currentRank = window.playerStats.getCurrentLevel();
const unlockedModules = getUnlockedModules(currentRank.level);

  2. Module Lock Data Structure

    const moduleUnlockRequirements = {
    'photo-session': { rank: 1, xp: 0 },
    'goon-loop': { rank: 1, xp: 0 },
    'rhythm-training': { rank: 3, xp: 25 },
    'worship-session': { rank: 5, xp: 82 },
    'joi-session': { rank: 7, xp: 209 },
    'multi-screen': { rank: 8, xp: 323 },
    'tease-denial': { rank: 10, xp: 751 },
    'humiliation': { rank: 12, xp: 1716 }
};

  3. Display Logic

    function renderModuleCard(module) {
    const requirement = moduleUnlockRequirements[module.id];
    const currentXP = window.playerStats.stats.totalXP;
    const isUnlocked = currentXP >= requirement.xp;

    if (isUnlocked) {
        return renderUnlockedModule(module);
    } else {
        return renderLockedModule(module, requirement, currentXP);
    }
}

  4. Unlock Event Listener

    window.addEventListener('levelUp', (event) => {
    checkForNewlyUnlockedModules(event.detail.newLevel);
});

📈 Balancing Considerations

Current Balance:

  • Early unlock (Ranks 1-3): 2 modules → 3 modules (quick progression)
  • Mid game (Ranks 5-8): 4 modules → 6 modules (steady unlocks)
  • Late game (Ranks 10-12): 7 modules → 8 modules (final unlocks)

Why This Spread?

  • Keeps new users engaged (2 modules immediately)
  • Regular unlocks maintain excitement (every 2-3 ranks)
  • Advanced content reserved for dedicated users
  • Matches psychological intensity to experience level

Adjustable if Needed:

  • Can lower requirements if unlocks feel too slow
  • Can raise requirements if progression too fast
  • Can add more tiers if more modules added
  • Can tier within ranks (e.g., Rank 5 Early vs Late)

Last Updated: December 2, 2025 Status: Design Complete - Ready for Implementation Related Docs: TRAINING_MODULES.md, CAMPAIGN-STRUCTURE.md