Improve world authoring workflow

world/regions/starter_island_region.gd

@@ -1,21 +1,28 @@
+@tool
 class_name StarterIslandRegion
-extends GrayboxRegion
+extends WorldRegion
 
 const FishingShopInteractionType = preload(
 	"res://world/fishing_shop_interaction.gd"
 )
 
-@export var visual_mesh_path: NodePath = (
-	^"Visuals/StarterIslandModel/starter_island"
+@export_group("Owned Nodes")
+@export_node_path("MeshInstance3D")
+var visual_mesh_path: NodePath = (
+	^"Terrain/Visual/starter_island"
 )
-@export var terrain_collision_shape_path: NodePath = (
-	^"StaticCollision/Terrain/Shape"
+@export_node_path("CollisionShape3D")
+var terrain_collision_shape_path: NodePath = (
+	^"Terrain/Collision/Shape"
 )
-@export var player_spawn_path: NodePath = ^"PlayerSpawn"
-@export var fishing_shop_path: NodePath = (
-	^"Interactables/FishingShopWorld/FishingShopInteraction"
+@export_node_path("Marker3D")
+var player_spawn_path: NodePath = ^"PlayerSpawn"
+@export_node_path("Area3D")
+var fishing_shop_path: NodePath = (
+	^"Interactables/FishingShopWorld/InteractionArea"
 )
-@export var pelican_landmark_path: NodePath = (
+@export_node_path("Node3D")
+var pelican_landmark_path: NodePath = (
 	^"Interactables/PelicanCoolerPerch"
 )
 
@@ -27,6 +34,8 @@ const FishingShopInteractionType = preload(
 func _ready() -> void:
 	_apply_grass_material()
 	_build_terrain_collision()
+	if Engine.is_editor_hint():
+		update_configuration_warnings()
 
 
 func get_player_spawn_transform() -> Transform3D:
@@ -91,3 +100,25 @@ func _build_terrain_collision() -> void:
 		push_error("Starter island terrain collision could not be created.")
 		return
 	collision_shape.shape = terrain_shape
+
+
+func _get_configuration_warnings() -> PackedStringArray:
+	var warnings := PackedStringArray()
+	var visual_mesh := get_node_or_null(visual_mesh_path) as MeshInstance3D
+	if visual_mesh == null or visual_mesh.mesh == null:
+		warnings.append("Terrain/Visual must provide the island mesh.")
+	elif grass_surface_index >= visual_mesh.mesh.get_surface_count():
+		warnings.append("Grass surface index is outside the terrain mesh.")
+	elif visual_mesh.mesh.surface_get_name(grass_surface_index) != "grass":
+		warnings.append("Grass surface index must identify the grass surface.")
+	if grass_material == null:
+		warnings.append("Assign the starter-island grass material.")
+	if get_node_or_null(terrain_collision_shape_path) == null:
+		warnings.append("Terrain/Collision must provide a collision shape.")
+	if get_node_or_null(player_spawn_path) == null:
+		warnings.append("PlayerSpawn marker is missing.")
+	if get_node_or_null(fishing_shop_path) == null:
+		warnings.append("Fishing Shop placement is missing.")
+	if get_node_or_null(pelican_landmark_path) == null:
+		warnings.append("Pelican placement is missing.")
+	return warnings

world/regions/world_region.gd

@@ -0,0 +1,60 @@
+@tool
+class_name WorldRegion
+extends Node3D
+
+@export var region_id: StringName
+@export var fishable_water_root: NodePath = ^"FishingWater"
+@export var water_recovery_root: NodePath = ^"WaterRecovery"
+@export var safe_respawns_root: NodePath = ^"SafeRespawns"
+
+
+func get_fishable_water_regions() -> Array[FishableWaterRegion]:
+	var regions: Array[FishableWaterRegion] = []
+	var root: Node = get_node_or_null(fishable_water_root)
+	if root == null:
+		return regions
+	_collect_fishable_water_regions(root, regions)
+	return regions
+
+
+func get_water_recovery_triggers() -> Array[PlayerWaterTrigger]:
+	var triggers: Array[PlayerWaterTrigger] = []
+	var root: Node = get_node_or_null(water_recovery_root)
+	if root == null:
+		return triggers
+	_collect_water_recovery_triggers(root, triggers)
+	return triggers
+
+
+func get_safe_respawn_points() -> Array[SafeRespawnPoint]:
+	var points: Array[SafeRespawnPoint] = []
+	var root: Node = get_node_or_null(safe_respawns_root)
+	if root == null:
+		return points
+	for child: Node in root.get_children():
+		var point: SafeRespawnPoint = child as SafeRespawnPoint
+		if point != null:
+			points.append(point)
+	return points
+
+
+func _collect_fishable_water_regions(
+	root: Node,
+	regions: Array[FishableWaterRegion],
+) -> void:
+	for child: Node in root.get_children():
+		var water := child as FishableWaterRegion
+		if water != null:
+			regions.append(water)
+		_collect_fishable_water_regions(child, regions)
+
+
+func _collect_water_recovery_triggers(
+	root: Node,
+	triggers: Array[PlayerWaterTrigger],
+) -> void:
+	for child: Node in root.get_children():
+		var trigger := child as PlayerWaterTrigger
+		if trigger != null:
+			triggers.append(trigger)
+		_collect_water_recovery_triggers(child, triggers)

world/regions/world_region.gd.uid

@@ -0,0 +1 @@
+uid://bb1j0uhvrbf5n