Add object-based event sheet support to FlowKit

- Modified flowkit_inspector_section.gd to add Event Sheet section in the inspector
- Added New, Assign, Edit, and Clear buttons for event sheet management
- Updated flowkit_engine.gd to scan nodes for attached event sheets (flowkit_event_sheet metadata)
- Updated editor.gd to support editing both scene-based and object-based event sheets
- Event sheets can now be assigned to individual nodes like regular Godot scripts

Co-authored-by: Lexian-droid <83799577+Lexian-droid@users.noreply.github.com>

Author: Copilot

addons/flowkit/runtime/flowkit_engine.gd

@@ -70,7 +70,8 @@ func _on_scene_changed(scene_root: Node) -> void:
 	# Scan and activate behaviors for all nodes in the scene
 	_scan_and_activate_behaviors(scene_root)
 
-	# Load event sheets for the scene root and any instanced child scenes
+	# Load event sheets for nodes with attached event sheets (object-based)
+	# and also load scene-based sheets for backward compatibility
 	_load_sheets_for_scene(scene_root)
 
 
@@ -79,6 +80,44 @@ func _load_sheets_for_scene(scene_root: Node) -> void:
 	# Clear previous sheets
 	active_sheets.clear()
 
+	# First, scan for object-based event sheets (nodes with flowkit_event_sheet metadata)
+	_scan_and_load_object_sheets(scene_root)
+
+	# Then, load scene-based sheets for backward compatibility
+	_load_scene_based_sheets(scene_root)
+
+
+func _scan_and_load_object_sheets(node: Node) -> void:
+	"""Recursively scan nodes for attached event sheets (object-based)."""
+	# Check if this node has an event sheet assigned
+	if node.has_meta("flowkit_event_sheet"):
+		var sheet_path: String = node.get_meta("flowkit_event_sheet", "")
+		if not sheet_path.is_empty() and ResourceLoader.exists(sheet_path):
+			var sheet: FKEventSheet = load(sheet_path)
+			if sheet:
+				# Ensure all blocks have unique IDs
+				for block in sheet.events:
+					if block:
+						block.ensure_block_id()
+				_ensure_block_ids_in_groups(sheet.groups)
+				
+				# Add entry with this node as the root context
+				active_sheets.append({
+					"sheet": sheet,
+					"root": node,
+					"scene_name": sheet_path.get_file().get_basename(),
+					"uid": -1,  # Object-based sheets use -1 to indicate not scene-based
+					"object_based": true
+				})
+				print("[FlowKit] Loaded object-based event sheet for node: ", node.name, " (", sheet_path.get_file(), ") with ", sheet.events.size(), " events")
+	
+	# Recursively scan children
+	for child in node.get_children():
+		_scan_and_load_object_sheets(child)
+
+
+func _load_scene_based_sheets(scene_root: Node) -> void:
+	"""Load scene-based event sheets (legacy/backward compatibility)."""
 	# Collect unique scene_file_path UIDs and map to their root node instances
 	var uid_to_node: Dictionary = {}
 

addons/flowkit/ui/editor.gd

@@ -6,6 +6,11 @@ var registry: Node
 var generator
 var current_scene_uid: int = 0
 
+# Object-based event sheet editing
+var editing_object_sheet: bool = false  # True when editing an object-based sheet (not scene-based)
+var current_sheet_path: String = ""  # Path to the currently edited event sheet
+var current_object_node: Node = null  # The node that has this sheet attached (for object-based editing)
+
 # Scene preloads - GDevelop-style event rows
 const EVENT_ROW_SCENE = preload("res://addons/flowkit/ui/workspace/event_row.tscn")
 const COMMENT_SCENE = preload("res://addons/flowkit/ui/workspace/comment.tscn")
@@ -885,6 +890,10 @@ func _process(delta: float) -> void:
 	if not editor_interface:
 		return
 
+	# If editing an object-based sheet, don't auto-switch to scene-based
+	if editing_object_sheet:
+		return
+
 	var scene_root = editor_interface.get_edited_scene_root()
 	if not scene_root:
 		if current_scene_uid != 0:
@@ -944,13 +953,55 @@ func _show_content_state() -> void:
 # === File Operations ===
 
 func _get_sheet_path() -> String:
-	"""Get the file path for current scene's event sheet."""
+	"""Get the file path for current event sheet (object-based or scene-based)."""
+	# Object-based sheet path takes precedence
+	if editing_object_sheet and not current_sheet_path.is_empty():
+		return current_sheet_path
+	
+	# Scene-based path
 	if current_scene_uid == 0:
 		return ""
 	return "res://addons/flowkit/saved/event_sheet/%d.tres" % current_scene_uid
 
+func edit_event_sheet(sheet_path: String) -> void:
+	"""Edit a specific event sheet file (called from inspector for object-based sheets)."""
+	editing_object_sheet = true
+	current_sheet_path = sheet_path
+	current_scene_uid = 0  # Clear scene-based tracking
+	
+	_clear_undo_history()
+	_clear_all_blocks()
+	
+	if not FileAccess.file_exists(sheet_path):
+		# Create a new empty sheet at this path
+		var new_sheet = FKEventSheet.new()
+		var dir_path = sheet_path.get_base_dir()
+		DirAccess.make_dir_recursive_absolute(dir_path)
+		var error = ResourceSaver.save(new_sheet, sheet_path)
+		if error != OK:
+			push_error("[FlowKit] Failed to create event sheet: ", sheet_path)
+			_show_empty_state()
+			return
+		print("[FlowKit] Created new event sheet: ", sheet_path)
+		_show_empty_blocks_state()
+		return
+	
+	var sheet = ResourceLoader.load(sheet_path)
+	if not (sheet is FKEventSheet):
+		push_error("[FlowKit] Invalid event sheet resource: ", sheet_path)
+		_show_empty_blocks_state()
+		return
+	
+	_populate_from_sheet(sheet)
+	_show_content_state()
+	print("[FlowKit] Editing object-based event sheet: ", sheet_path)
+
 func _load_scene_sheet() -> void:
-	"""Load event sheet for current scene."""
+	"""Load event sheet for current scene (scene-based mode)."""
+	# Reset object-based mode when loading scene sheet
+	editing_object_sheet = false
+	current_sheet_path = ""
+	
 	_clear_all_blocks()
 
 	var sheet_path = _get_sheet_path()
@@ -991,16 +1042,19 @@ func _populate_from_sheet(sheet: FKEventSheet) -> void:
 
 func _save_sheet() -> void:
 	"""Generate and save event sheet from current blocks."""
-	if current_scene_uid == 0:
-		push_warning("No scene open to save event sheet.")
+	var sheet_path = _get_sheet_path()
+	
+	# Check if we have a valid path (either object-based or scene-based)
+	if sheet_path.is_empty():
+		if not editing_object_sheet and current_scene_uid == 0:
+			push_warning("No scene open to save event sheet.")
 		return
 
 	var sheet = _generate_sheet_from_blocks()
 
-	var dir_path = "res://addons/flowkit/saved/event_sheet"
+	var dir_path = sheet_path.get_base_dir()
 	DirAccess.make_dir_recursive_absolute(dir_path)
 
-	var sheet_path = _get_sheet_path()
 	var error = ResourceSaver.save(sheet, sheet_path)
 
 	if error == OK:
@@ -1011,7 +1065,10 @@ func _save_sheet() -> void:
 func _save_and_reload_sheet() -> void:
 	"""Save sheet and reload UI to ensure visual/data sync (for drag-drop operations)."""
 	_save_sheet()
-	_load_scene_sheet()
+	if editing_object_sheet and not current_sheet_path.is_empty():
+		edit_event_sheet(current_sheet_path)
+	else:
+		_load_scene_sheet()
 
 func _generate_sheet_from_blocks() -> FKEventSheet:
 	"""Build event sheet from event rows, comments, and groups (GDevelop-style)."""
@@ -1102,6 +1159,14 @@ func _copy_group_block(data: FKGroupBlock) -> FKGroupBlock:
 
 func _new_sheet() -> void:
 	"""Create new empty sheet."""
+	# In object-based mode, clear the current sheet
+	if editing_object_sheet and not current_sheet_path.is_empty():
+		_clear_all_blocks()
+		_save_sheet()  # Save the empty sheet
+		_show_content_state()
+		return
+	
+	# In scene-based mode, require a scene
 	if current_scene_uid == 0:
 		push_warning("No scene open to create event sheet.")
 		return