World Activity System

v1.0.0

Quick Start Guide

Create your first discoverable activity and automated event in 10 minutes.

Prerequisites: This guide assumes you already have Game Creator 2 and World Activity System installed.

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

    With "Activity Manager" selected → Inspector → Add Component → Search "World Activity Manager"

  4. Assign Player

    Drag your player GameObject to the "Player Reference" field (or leave empty for auto-find by tag)

Step 2: Create Spatial 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, then in Inspector:

    • • Display Name: "Ancient Shrine"
    • • Category: Shrine
    • • Discovery Range: 10
    • • Auto Discover: ✓
  4. Add Discovery Actions

    In On Discovered section:

    • • Add Instruction: Debug → Debug Log
    • • Message: "You discovered an Ancient Shrine!"

Step 3: Place Anchor in Scene

  1. Create Anchor GameObject

    In Hierarchy → Right-click → Create Empty → Name: "Shrine Anchor"

  2. Add Anchor Component

    Add Component: Spatial Activity Anchor

  3. Assign Activity

    Drag "Ancient Shrine" asset to the "Activity" field

  4. Position It

    Move the anchor to a location in your scene (e.g., Position: 10, 0, 10)

Visual Feedback: The anchor shows a green sphere gizmo in Scene view representing the discovery range.

Step 4: Test Discovery

  1. Enter Play Mode
  2. Walk your player toward the shrine anchor
  3. When within range (10 units), check Console for "You discovered an Ancient Shrine!"
  4. Open Activity Manager window to see the shrine marked as "Discovered"
It works! Your spatial activity is discoverable. Let's add an automated event next.

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
    • • 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: Add Debug → Debug Log with "Merchant has arrived!"

  5. Enable Scheduler

    Select "Activity Manager" → EventScheduler section → ✓ Scheduler Enabled

Note: The event will trigger automatically every 5 minutes. Open the Event Scheduler Debug Window to monitor it in real-time.

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

🎉 Congratulations!

You've successfully created:

  • ✅ A discoverable spatial activity (shrine)
  • ✅ An automated temporal event (merchant)
  • ✅ Working proximity detection system
  • ✅ Functional event scheduler

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