Add ConfigurableEventManager implementation with example and guide

EVENTS_GUIDE.md

@@ -0,0 +1,96 @@
+# ConfigurableEventManager Implementation Guide
+
+## What is ConfigurableEventManager?
+
+The ConfigurableEventManager is a Godot Node that provides a visual, inspector-based way to define and manage events in your game without writing code for each event.
+
+## How to Set It Up
+
+### Step 1: Add EventManager to Your Scene
+
+1. Open `Scenes/Main.tscn` in Godot
+2. The EventManager node should already be added as a child of Main
+3. Select the EventManager node in the scene tree
+
+### Step 2: Create GameEventResource Assets
+
+You need to create `.tres` resource files that define your events:
+
+1. In Godot, right-click in the FileSystem dock → **New Resource**
+2. Search for **GameEventResource** and select it
+3. Click **Create**
+4. Save it in `Resources/Events/` (you may need to create this folder)
+
+Example event resources to create:
+
+#### GameStarted.tres
+- **Event Name**: `GameStarted`
+- **Description**: `Fired when the game begins`
+- **Parameter Count**: `0`
+- **Category**: `Game`
+
+#### ScoreChanged.tres
+- **Event Name**: `ScoreChanged`
+- **Description**: `Fired when player score changes`
+- **Parameter Count**: `1`
+- **Parameter1 Type**: `int`
+- **Parameter1 Description**: `The new score value`
+- **Category**: `Player`
+
+#### PlayerLevelUp.tres
+- **Event Name**: `PlayerLevelUp`
+- **Description**: `Fired when player gains a level`
+- **Parameter Count**: `2`
+- **Parameter1 Type**: `string`
+- **Parameter1 Description**: `Player name`
+- **Parameter2 Type**: `int`
+- **Parameter2 Description**: `New level number`
+- **Category**: `Player`
+
+### Step 3: Configure EventManager in Inspector
+
+1. Select the EventManager node in your scene
+2. In the Inspector, find the **Events** array property
+3. Click to expand it and set the **Size** to match your number of events (e.g., 3)
+4. Drag your `.tres` event resource files into each array slot
+5. Optionally enable **Enable Debug Logging** to see event activity in the console
+
+### Step 4: Use Events in Your Scripts
+
+See `Scripts/EventExample.cs` for a complete example of:
+- Getting a reference to the EventManager
+- Subscribing to events
+- Raising events
+- Unsubscribing from events
+
+## Key Benefits
+
+✅ **Visual Configuration** - Define events in the Inspector without code
+✅ **Type Safety** - Still get compile-time checking in C#
+✅ **Documentation** - Event descriptions and parameter info built-in
+✅ **Debug Logging** - Optional logging for all event activity
+✅ **Validation** - Warns if you subscribe with wrong parameter count
+
+## Usage Pattern
+
+```csharp
+// 1. Get reference
+_eventManager = GetNode<ConfigurableEventManager>("/root/Main/EventManager");
+
+// 2. Subscribe
+_eventManager.Subscribe<int>("ScoreChanged", OnScoreChanged);
+
+// 3. Raise event somewhere
+_eventManager.Raise("ScoreChanged", 100);
+
+// 4. Unsubscribe when done
+_eventManager.Unsubscribe<int>("ScoreChanged", OnScoreChanged);
+```
+
+## Next Steps
+
+1. Open the project in Godot 4.5
+2. Create your GameEventResource assets in the editor
+3. Add them to the EventManager's Events array
+4. Use the example script as a template for your game objects
+5. Enable debug logging to see events firing in real-time