Adds bushes and flowers to ground tiles

Implements bush and flower spawning on ground tiles based on vegetation density.
Adds new assets for bushes and flowers, and introduces multi-mesh rendering for optimized performance.
Introduces seasonal color variations for vegetation using a shader for bushes and materials for flowers and grass.
Refactors material application into a MaterialManager to handle material assignments over multiple frames.
Moves ground tile scripts into a subfolder.
Adds floating particles to test scene.

Entities/GroundTile/scripts/bush_multimesh.gd

@@ -0,0 +1,56 @@
+extends MultiMeshInstance3D
+var mm: MultiMesh
+var parent_node: BushController
+static var bush_mesh: Mesh = null
+var material: ShaderMaterial
+
+func _ready() -> void:
+	parent_node = get_parent() as BushController
+	if parent_node == null:
+		Log.pr("Error: Parent node is not a BushController!")
+	
+	# Load mesh once and reuse
+	if bush_mesh == null:
+		bush_mesh = load("res://Entities/Bush/assets/bush_large.res")
+
+func setup_multimesh() -> void:
+	if parent_node == null:
+		return
+	
+	if bush_mesh == null:
+		Log.pr("Error: Could not load bush mesh")
+		return
+	
+	# Reuse existing MultiMesh if possible, or create new one
+	if mm == null:
+		mm = MultiMesh.new()
+		mm.transform_format = MultiMesh.TRANSFORM_3D
+		mm.mesh = bush_mesh
+
+		material = ColorData.get_random_bush_material(Season.current)
+		mm.mesh.surface_set_material(0, material)
+	
+	# Configure instance count
+	mm.instance_count = parent_node.bush_instance_range
+	
+	# Get shared RNG from GroundTile
+	var rng = parent_node.parent_node.get_rng()
+	
+	# Generate positions using shared RNG
+	for i in range(mm.instance_count):
+		var random_pos = Vector3(
+			rng.randf_range(-1.0, 1.0),
+			0.0,
+			rng.randf_range(-1.0, 1.0)
+		)
+		
+		var random_rotation = rng.randf_range(0.0, TAU)
+		var basis = Basis(Vector3.UP, random_rotation)
+		
+		var random_scale = rng.randf_range(0.3, 0.9)
+		basis = basis.scaled(Vector3(random_scale, random_scale, random_scale))
+		
+		var tx = Transform3D(basis, random_pos)
+		mm.set_instance_transform(i, tx)
+
+	multimesh = mm

Entities/GroundTile/scripts/bush_multimesh.gd.uid

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

Entities/GroundTile/scripts/bushes.gd

@@ -0,0 +1,36 @@
+# GrassController.gd
+extends Node3D
+class_name BushController
+
+@onready var bush_multimesh: MultiMeshInstance3D = $BushMultimesh
+var parent_node: GroundTile = null
+var bush_density: float = 0.5
+var bush_instance_range: int = 10
+
+func _ready() -> void:
+	parent_node = get_parent() as GroundTile
+
+func spawn_bushes_for_cell(value):
+	if value == null:
+		return
+	
+	bush_density = value.vegetation_density
+	update_bush_density()
+	
+	if bush_multimesh and bush_multimesh.has_method("setup_multimesh"):
+		bush_multimesh.setup_multimesh()
+
+func update_bush_density() -> void:
+	if parent_node == null:
+		return
+
+	var rng = parent_node.get_rng()
+
+	if bush_density > 0.8:
+			bush_instance_range = rng.randi_range(5, 10)
+	elif bush_density > 0.6:
+			bush_instance_range = rng.randi_range(2, 7)
+	elif bush_density > 0.3:
+			bush_instance_range = rng.randi_range(0, 1)
+	else:
+			bush_instance_range = rng.randi_range(0, 0)

Entities/GroundTile/scripts/bushes.gd.uid

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

Entities/GroundTile/scripts/flower_multimesh.gd

@@ -0,0 +1,59 @@
+extends MultiMeshInstance3D
+
+var mm: MultiMesh
+var parent_node: FlowerController
+static var flower_mesh: Mesh = null
+var material: StandardMaterial3D
+
+func _ready() -> void:
+	parent_node = get_parent() as FlowerController
+	if parent_node == null:
+		Log.pr("Error: Parent node is not a FlowerController!")
+	
+	# Load mesh once and reuse
+	if flower_mesh == null:
+		flower_mesh = load("res://Entities/Plant/assets/flower_tall.res")
+
+func setup_multimesh() -> void:
+	if parent_node == null:
+		return
+	
+	if flower_mesh == null:
+		Log.pr("Error: Could not load flower mesh")
+		return
+	
+	# Reuse existing MultiMesh if possible, or create new one
+	if mm == null:
+		mm = MultiMesh.new()
+		mm.transform_format = MultiMesh.TRANSFORM_3D
+		mm.mesh = flower_mesh
+
+		var flower_material = ColorData.flower_materials[Season.current]["flower"]
+		var stem_material = ColorData.flower_materials[Season.current]["stem"]
+		mm.mesh.surface_set_material(0, stem_material)
+		mm.mesh.surface_set_material(1, flower_material)
+	
+	# Configure instance count
+	mm.instance_count = parent_node.flower_instance_range
+	
+	# Get shared RNG from GroundTile
+	var rng = parent_node.parent_node.get_rng()
+	
+	# Generate positions using shared RNG
+	for i in range(mm.instance_count):
+		var random_pos = Vector3(
+			rng.randf_range(-1.0, 1.0),
+			0.0,
+			rng.randf_range(-1.0, 1.0)
+		)
+		
+		var random_rotation = rng.randf_range(0.0, TAU)
+		var basis = Basis(Vector3.UP, random_rotation)
+		
+		var random_scale = rng.randf_range(0.2, 0.4)
+		basis = basis.scaled(Vector3(random_scale, random_scale, random_scale))
+		
+		var tx = Transform3D(basis, random_pos)
+		mm.set_instance_transform(i, tx)
+
+	multimesh = mm

Entities/GroundTile/scripts/flower_multimesh.gd.uid

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

Entities/GroundTile/scripts/flowers.gd

@@ -0,0 +1,36 @@
+# GrassController.gd
+extends Node3D
+class_name FlowerController
+
+@onready var flower_multimesh: MultiMeshInstance3D = $FlowerMultimesh
+var parent_node: GroundTile = null
+var flower_density: float = 0.5
+var flower_instance_range: int = 10
+
+func _ready() -> void:
+	parent_node = get_parent() as GroundTile
+
+func spawn_flowers_for_cell(value):
+	if value == null:
+		return
+	
+	flower_density = value.vegetation_density
+	update_flower_density()
+	
+	if flower_multimesh and flower_multimesh.has_method("setup_multimesh"):
+		flower_multimesh.setup_multimesh()
+
+func update_flower_density() -> void:
+	if parent_node == null:
+		return
+
+	var rng = parent_node.get_rng()
+
+	if flower_density > 0.8:
+			flower_instance_range = rng.randi_range(1, 3)
+	elif flower_density > 0.6:
+			flower_instance_range = rng.randi_range(3, 4)
+	elif flower_density > 0.3:
+			flower_instance_range = rng.randi_range(4, 7)
+	else:
+			flower_instance_range = rng.randi_range(5, 10)

Entities/GroundTile/scripts/flowers.gd.uid

@@ -0,0 +1 @@
+uid://18vxtm3ua4x0

Entities/GroundTile/scripts/grass_multimesh.gd

@@ -25,6 +25,8 @@ func setup_multimesh() -> void:
 		mm = MultiMesh.new()
 		mm.transform_format = MultiMesh.TRANSFORM_3D
 		mm.mesh = grass_mesh
+		update_shader_parameter('top_color', ColorData.grass_materials[Season.current]['top'])
+		update_shader_parameter('bottom_color', ColorData.grass_materials[Season.current]['base'])
 	
 	# Configure instance count
 	mm.instance_count = parent_node.grass_instance_range
@@ -51,3 +53,18 @@ func setup_multimesh() -> void:
 	
 	multimesh = mm
 	cast_shadow = GeometryInstance3D.SHADOW_CASTING_SETTING_OFF
+
+
+func update_shader_parameter(param_name: String, value) -> void:
+	if material_override == null:
+		Log.pr("Error: No material override found")
+		return
+
+	# Check if it's a ShaderMaterial
+	if material_override is ShaderMaterial:
+		var shader_material = material_override as ShaderMaterial
+		shader_material.set_shader_parameter(param_name, value)
+	else:
+		Log.pr("Error: Material override is not a ShaderMaterial")
+
+	return

Entities/GroundTile/scripts/ground_tile.gd

@@ -0,0 +1,59 @@
+class_name GroundTile
+extends Node3D
+@onready var debug_text: Label = $DebugText/DebugTextViewport/DebugTextLabel
+@onready var tree_spawner = $Trees
+@onready var grass_spawner = $Grass
+@onready var bush_spawner = $Bushes
+@onready var flower_spawner = $Flowers
+@onready var ground = $Ground
+var grid_x: int
+var grid_z: int
+var cell_info: CellDataResource = null
+var spawners_ready: bool = false
+var cached_rng: RandomClass = null
+
+# 326432  229379
+# Grass - 1a7761 1f6051
+
+func _ready() -> void:
+	spawners_ready = true
+
+	if cell_info != null:
+		spawn_content()
+		update_text_label()
+
+	ground.material_override.albedo_color = ColorData.grass_materials[Season.current]['base']
+
+func get_rng() -> RandomClass:
+	if cached_rng == null and cell_info:
+		cached_rng = RandomClass.get_seeded_instance(cell_info.cell_seed)
+	elif cached_rng == null:
+		cached_rng = RandomClass.get_shared_instance()
+	
+	return cached_rng
+
+func set_grid_location(x, z) -> void:
+	grid_x = x
+	grid_z = z
+	cell_info = MapData.get_map_data(grid_x, grid_z)
+	
+	# Only spawn if spawners are ready
+	if spawners_ready and cell_info != null:
+		spawn_content()
+
+func spawn_content():
+	if cell_info == null:
+		return
+		
+	if tree_spawner:
+		tree_spawner.spawn_trees_for_cell(cell_info)
+	if grass_spawner:
+		grass_spawner.spawn_grass_for_cell(cell_info)
+	if bush_spawner:
+		bush_spawner.spawn_bushes_for_cell(cell_info)
+	if flower_spawner:
+		flower_spawner.spawn_flowers_for_cell(cell_info)
+	
+
+func update_text_label() -> void:
+	debug_text.text = str(cell_info.vegetation_density)

Entities/GroundTile/scripts/ground_tile.gd.uid

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