World Activity System

What You'll Build

By the end of this guide, you'll have:

• A discoverable Ancient Shrine that gives a health bonus
• An automated Merchant NPC that spawns every 5 minutes
• Working proximity discovery system
• Functional event scheduler

Step 1: Setup Manager

1. Create New Scene

   File → New Scene → Basic (Built-in)

2. Create Manager GameObject

   Right-click in Hierarchy → Create Empty → Name: "Activity Manager"

3. Add Component

   Select "Activity Manager" → Add Component → World Activity Manager

4. Configure Settings

   In Inspector:

   • • Time Provider Type: GameTime
   • • Player Tag: "Player"
   • • Debug Logging: ✓ Enabled (for learning)

Step 2: Create First Activity

1. Create Activity Asset

   Project window → Right-click → Create → World Activity System → Spatial Activity

2. Name It

   Name: "Ancient Shrine"

3. Configure Properties

   Select the asset in Project window, then in Inspector:

   • • Display Name: "Ancient Shrine"
   • • Category: Shrine
   • • Requires Discovery: ✓ Checked
4. Add Health Bonus

   In Inspector, expand On Activate section:

   • • Click + button
   • • Add Instruction: Stats → Modify Stat Value
   • • Stat: Health
   • • Operation: Add
   • • Value: 20

Step 3: Place Anchor in Scene

1. Open Activity Manager Window

   Menu: Window → Game Creator → Activity Manager

2. Select Activity

   In Activity Manager window, find "Ancient Shrine" in the list

3. Create Anchor

   Click "Create Anchor in Scene" button

4. Position Anchor

   A new GameObject appears in Hierarchy → Move it to desired location in Scene view

5. Adjust Trigger Size

   Select anchor → In Inspector, find Sphere Collider → Adjust Radius: 5

Step 4: Test Discovery

1. Setup Player

   Create or use existing Player GameObject:

   • • Tag it as "Player"
   • • Add Character component (GC2)
   • • Add Traits component (GC2) with Health stat
2. Enter Play Mode

   Press Play button in Unity Editor

3. Move to Shrine

   Move player close to the shrine anchor

4. Verify Discovery

   Check Console window - you should see: "Activity discovered: Ancient Shrine"

5. Check Health

   Health stat should increase by 20 points

Step 5: Create Automated Event

1. Create Temporal Activity

   Project window → Right-click → Create → World Activity System → Temporal Activity

2. Name It

   Name: "Merchant Spawn"

3. Configure Event

   Select the asset, then in Inspector:

   • • Display Name: "Traveling Merchant"
   • • Trigger Type: Interval
   • • Interval: 300 (5 minutes in seconds)
   • • Event Duration: 180 (3 minutes)
   • • Event Priority: 0.5
4. Add Debug Message

   In On Activate section:

   • • Add Instruction: Debug → Debug Log
   • • Message: "Merchant has arrived!"
5. Enable Scheduler

   Select "Activity Manager" in Hierarchy → In Inspector, find EventScheduler section → ✓ Scheduler Enabled

Test Automated Event

1. Enter Play Mode
2. Open Event Scheduler Debug Window: Window → Game Creator → Event Scheduler Debug
3. Go to Dashboard tab - verify event is scheduled
4. Go to Tools tab - click [Trigger] next to "Merchant Spawn" to test immediately
5. Check Console for "Merchant has arrived!" message
6. Go to Timeline tab - see event scheduled in future

Next Steps

Now that you have the basics working, explore these topics:

• Core Concepts — Learn about spatial vs temporal activities, manager architecture
• Components Reference — Explore all properties and settings
• Event Scheduler — Master automated scheduling, time-of-day events, conditionals
• Debug Window — Use Timeline, History, Performance tabs for monitoring
• Workflow Examples — Study complete examples (quests, achievements, boss fights)