Skip to main content

Game Event Editor

Your primary workspace for organizing, refining, and maintaining your event library. While the Game Event Creator is for birthing new events, the Editor is where you manage their entire lifecycle.

alt text


πŸš€ Opening the Editor​

Access the editor through the following method:

From the System Dashboard:

Game Event System Window β†’ Click "Game Event Editor"

alt text


πŸŽ›οΈ Configuration Bar​

Located at the top of the window, this bar determines the scope of your work.

Configuration Bar

Manager Selection​

Purpose: Connect the editor to the active GameEventManager in your scene.

Behavior:

  • βœ… Auto-detects manager on startup
  • πŸ”„ Updates when switching scenes
  • πŸ“Œ Pin button opens Manager Inspector
Multi-Scene Workflow

If you have multiple scenes open, the editor will target the manager in the active scene. Switch scenes to update the connection automatically.


Database Selector​

Switch between different event databases to focus your work.

alt text

Only Active Databases Appear

The dropdown only shows databases marked as Active in the Game Event Manager. If your database is missing, check its active state in the Manager Inspector.


πŸ› οΈ Toolbar & Display Modes​

Powerful filtering and view controls for managing large event libraries.

Editor Toolbar

View Modes​

Toggle between two display strategies:

ModeIconBest ForBehavior
Page Mode1 / 5Large databases (100+ events)Shows events in pages (10-100 per page)
Full ModeGrid iconSmall databases or bulk operationsSingle scrollable list with all events

Switching Modes:

  • Click the grid icon in the toolbar
  • Your preference is saved between sessions

Page Size Options: 10, 20, 50, or 100 events per page (click the number to change)


🧩 Smart Filtering System​

Three layers of filtering to find exactly what you need:

Category matching

Show events from a specific category.

Usage

  • Category: All βž” 🟦 Shows All events
  • Category: Combat βž” πŸŸ₯ Shows only Combat events (Damage, Death, Spawn)
  • Category: UI βž” 🟩 Shows only UI events (Click, Hover, Open)
Source

Categories are defined in the event's Category field (editable in the list).


πŸ”€ Multi-Layer Filtering (Combination)​

All three filters work in tandem using AND Logic to help you drill down into the most specific results.

Example Scenario To find a specific health-related combat event, you might set:

🟦 Category: Combat βž• πŸ”’ Type: Int32 βž• ⌨️ Search: damage

🎯 Result:

πŸ” Displays only Combat-category, Integer-type events with "damage" in the name (e.g., OnDamageTaken).

🧹 Quick Reset​

Need to start over? Returning to the full list is instant.

  • Action: Set Category & Type to All + Clear the Search Bar.
  • Shortcut: Pressing the Γ— button in the search bar and selecting "All" from the dropdowns will immediately restore the full view.
Pro Tip: Efficiency

The system remembers your filter settings even when you switch between different database tabs, ensuring a seamless workflow.


πŸ“ The Event List​

Each row represents one event asset with editable properties and action buttons.

Event List Row

Editable Fields​

Category Field​

Organize events into logical groups.

Usage:

  • Click to edit
  • Press Enter or click away to save
  • Changes apply immediately

Action Buttons​

Four buttons per row provide quick access to related tools:

πŸ“„ Reference Field (Read-Only)​

Shows the actual event asset with its full type signature.

Actions:

  • Left-Click: Select and ping asset in Project window
  • Right-Click: Context menu with options:
    • Copy GUID
    • Copy Name
    • Ping in Project
    • Open Asset

🎯 Behavior Button (Color-Coded)​

Configure advanced event behaviors (actions, conditions, delays, repeating, looping and persistent).

Button States:

ColorIconMeaningTooltip
🟒 Greenβœ“Configured (Inspector)Has Inspector bindings
πŸ”΅ Blueβ–ΆConfigured (Runtime)Has runtime listeners
🟑 Orange⚠Not configuredNo bindings yet
tip

Open Game Event Behavior Window to learn about the complete event behavior configuration.


πŸ” Reference Finder​

Discover where this event is used in the current scene.

Use Case: Before deleting an event, check if anything is using it.

tip

You can jump to Game Event Reference Window to learn more about its powerful scene reference lookup capabilities.


πŸ—‘οΈ Delete Button​

Remove the event asset from the database.

Behavior:

  1. Click trash icon
  2. Confirmation dialog appears
  3. Shows event details (name, type, category)
  4. Confirm β†’ Event deleted permanently

What Gets Deleted:

  • βœ… Event asset (.asset file)
  • βœ… Sub-asset entry in database
  • βœ… Any associated bindings in Manager

What Doesn't Break:

  • ❌ Scene won't break (references become Missing)
  • ❌ Scripts won't error (null checks should handle it)
Cannot Be Undone

Deletion is permanent. Use the Reference Finder first to check usage.


⚑ Global Actions (Top-Right Toolbar)​

Quick access to related workflows:

πŸ•ΈοΈ Flow Graph​

Build visual event chains and orchestration logic.

Button: "Flow Graph"

What It Opens: Game Event Flow Editor

When to Use:

  • You need Event A to trigger Events B, C, and D
  • You want sequential execution with delays
  • You're building complex conditional branching

βž• New Event​

Batch-create multiple events at once.

Button: "New Event"

What It Opens: Game Event Creator

When to Use:

  • Creating many events of the same or different type
  • Generating events from custom types
  • Bulk event creation workflow

πŸ—‘οΈ Delete Events (Batch Mode)​

For efficient maintenance of large databases, the Editor supports a dedicated batch deletion mode.

Entering Batch Mode​

Click the Delete Event button on the far right of the standard toolbar (see image below) to toggle the selection interface.

alt text

Selection Controls​

Once clicked, the toolbar transforms to provide batch operations, and selection checkboxes will appear next to each event row:

alt text

ActionDescription
Select AllChecks every event currently visible in the list (respects active filters).
DeleteOpens a final confirmation dialog listing all selected events for permanent removal.
CancelExits batch mode and clears all current selections without making changes.

Workflow Steps:

  1. Click Delete Event to enter selection mode.
  2. Manually check specific events or use Select All.
  3. Click Delete to process the removal, or Cancel to return to the standard view.
Bulk Deletion Safety
  • Irreversible: Bulk deletion cannot be undone.
  • Filter Sensitivity: "Select All" only affects events that meet your current filter criteria (Category/Type/Search).
  • Reordering Disabled: While in Batch Mode, the drag-and-drop reordering handles (☰) are hidden to prevent accidental moves.

🎨 Row Reordering (Drag & Drop)​

Change event order by dragging rows:

How to Reorder:

  1. Hover over the handle icon (☰) on the left of any row
  2. Click and drag vertically
  3. Release to drop in new position

When Available:

  • βœ… No active filters (Category: All, Type: All, Search: empty)
  • βœ… Not in batch selection mode

When Disabled:

  • ❌ Any filter active (would break visual continuity)
  • ❌ Batch selection mode enabled

Why Order Matters: Event order affects:

  • Display order in dropdowns
  • Alphabetical grouping in some tools
  • Personal organization preference
Order is Database-Specific

Each database has its own event order. Switching databases preserves their individual ordering.


πŸ“Š Statistics Badge​

Located in the header, shows real-time event count:

Display: 150 Events (example)

What It Counts:

  • Total events in currently selected database
  • Updates immediately when creating/deleting events
  • Reflects filtered count when filters are active

❓ Troubleshooting​

This section covers common issues and their solutions. If you encounter a problem not listed here, please check the console for error logs.


1. Events Not Appearing​

Problem: You created events, but they are not visible in the event list.

Check Active Database​

  1. Look at the Database dropdown menu.
  2. Confirm if the correct database is selected.
  3. Try switching databases to refresh the list.

Check Filters​

  • Set Category -> All
  • Set Type -> All
  • Clear the search bar.
  • Check if events appear after resetting filters.

Check Manager Status​

  1. Click the Manager field -> Ping Inspector.
  2. Verify the database is Active (green badge).
  3. If it shows Inactive, toggle the switch to Active.
dynamic compilation

If none of the above checks are abnormal, try modifying any code to trigger a Unity compilation, which will update the database status. Check again in the Editor window to see if the created event has occurred.

Unknown exception

If you still cannot create it, please contact me


2. Can't Edit Event Properties​

Problem: The Category or Name fields appear grayed out and cannot be edited.

Potential Cause: The event might be part of a locked asset, or the database file is set to read-only.

Solution:

  • Verify if the database file in your project is writable (not read-only in OS).
  • Ensure you are not currently in Prefab Isolation Mode.
  • Check if the event asset is locked/checked out in your version control system (e.g., Perforce or Git LFS).

3. Reordering Not Working​

Problem: Dragging rows to reorder events is not functioning.

Checklist: To enable drag & drop reordering, ensure the following conditions are met:

  • Are all filters (Category/Type) set to "All"?
  • Is the search bar empty?
  • Are you not in batch selection mode?
warning

Reordering is only available when viewing the full, unfiltered list.


4. Behavior Button Not Opening​

Problem: Clicking the behavior button does not trigger any action.

Check Manager Assignment​

If the Manager field shows None:

  1. The Auto-detect system should normally find it.
  2. If it fails, manually drag the manager object from your scene into the field.

Check Console for Errors​

  • Open the Console window (Ctrl+Shift+C).
  • Look for Red Errors (exceptions).
  • Fix any compilation issues first, as script errors can prevent UI events from firing.
Workflow Recommendation

Keep this window docked alongside your Inspector. When you select an event in the list, the Inspector shows its full asset detailsβ€”perfect for quick property checks without leaving your workspace.