add river chunk

core/biome_generator/biome_generator.gd

@@ -1,5 +1,9 @@
 extends Node3D
 
+const CHUNK_GENERATION_STEPS_PER_FRAME: int = 2
+const CHUNK_CLEANUP_STEPS_PER_FRAME: int = 4
+const LAMPPOST_WIRE_STEPS_PER_FRAME: int = 1
+
 @export_group("Rails")
 @export var rail_path: Path3D 
 
@@ -20,6 +24,12 @@ var last_pos_train: Vector2i = Vector2i(999999, 999999)
 var noise_generator: FastNoiseLite 
 var altitude_generator: FastNoiseLite
 var wire_connections: Dictionary = {}
+var chunk_candidate_cache: Dictionary = {}
+var pending_generation_cells: Array[Vector2i] = []
+var pending_cleanup_cells: Array[Vector2i] = []
+var pending_wire_cells: Array[Vector2i] = []
+var pending_wire_lookup: Dictionary = {}
+var pending_radar_update: bool = false
 
 var manual_biome: Biome = null
 
@@ -36,6 +46,7 @@ func _ready() -> void:
 	altitude_generator.seed = randi() 
 	altitude_generator.frequency = district_scale * 0.5 
 	
+	_warm_chunk_candidate_cache()
 	_update_set_pieces()
 
 func _update_set_pieces() -> void:
@@ -67,15 +78,18 @@ func _update_set_pieces() -> void:
 			print("   ❌ Temple is an invisible ghost.")
 	
 func _destroy_and_regenrate_world() -> void:
+	_warm_chunk_candidate_cache()
+	_clear_pending_world_work()
+
 	#Turn off old temples
 	_update_set_pieces() 
 	
 	#Destroy all models
 	for pos in board.keys():
 		var cella = board[pos]
-		if cella["tipo"] == "bioma":
+		if cella["type"] != "obstacle":
-			if cella.has("nodo") and is_instance_valid(cella["nodo"]):
+			if cella.has("node") and is_instance_valid(cella["node"]):
-				cella["nodo"].queue_free()
+				cella["node"].queue_free()
 				
 	#Clean board and wire connections
 	board.clear()
@@ -83,8 +97,19 @@ func _destroy_and_regenrate_world() -> void:
 		
 	#Create train
 	last_pos_train = Vector2i(999999, 999999)
-	_train_radar()
+	if rail_path != null and rail_path.train_instance != null:
-	last_pos_train = Vector2i(999999, 999999)
+		var train_pos = rail_path.train_instance.global_position
+		var current_pos = Vector2i(roundi(train_pos.x / chunk_size), roundi(train_pos.z / chunk_size))
+		_refresh_world_work(current_pos)
+		pending_radar_update = true
+
+func _process(_delta: float) -> void:
+	_drain_cleanup_queue()
+	_drain_generation_queue()
+	_drain_wire_queue()
+
+	if pending_radar_update:
+		pending_radar_update = false
 		_train_radar()
 
 func _physics_process(_delta: float) -> void:
@@ -97,9 +122,8 @@ func _physics_process(_delta: float) -> void:
 	
 	if current_pos != last_pos_train:
 		last_pos_train = current_pos
-		_generate_pieces_around_train(current_pos)
+		_refresh_world_work(current_pos)
-		_clean_far_chunks(current_pos)
+		pending_radar_update = true
-		_train_radar()
 
 func collect_all_chunkinfo(root: Node, list: Array[Node]) -> void:
 	if root == null: return
@@ -110,6 +134,168 @@ func collect_all_chunkinfo(root: Node, list: Array[Node]) -> void:
 	for child in root.get_children():
 		collect_all_chunkinfo(child, list)
 
+func _warm_chunk_candidate_cache() -> void:
+	var unique_scenes: Dictionary = {}
+
+	for biome in biome_list:
+		if biome == null:
+			continue
+		for scene in biome.available_chunks:
+			if scene == null:
+				continue
+			unique_scenes[_get_chunk_scene_cache_key(scene)] = scene
+
+	if manual_biome != null:
+		for scene in manual_biome.available_chunks:
+			if scene == null:
+				continue
+			unique_scenes[_get_chunk_scene_cache_key(scene)] = scene
+
+	for scene in unique_scenes.values():
+		_get_chunk_scene_metadata(scene)
+
+func _get_chunk_scene_cache_key(scene: PackedScene) -> String:
+	if scene == null:
+		return ""
+	if scene.resource_path != "":
+		return scene.resource_path
+	return "scene_%s" % scene.get_instance_id()
+
+func _get_chunk_scene_metadata(scene: PackedScene) -> Dictionary:
+	if scene == null:
+		return {}
+
+	var key = _get_chunk_scene_cache_key(scene)
+	if chunk_candidate_cache.has(key):
+		return chunk_candidate_cache[key]
+
+	var preview_chunk = scene.instantiate()
+	var info_list: Array[Node] = []
+	collect_all_chunkinfo(preview_chunk, info_list)
+	var info_node = info_list[0] if info_list.size() > 0 else null
+
+	if info_node == null or not info_node.has_method("get_rotated_data"):
+		preview_chunk.queue_free()
+		chunk_candidate_cache[key] = {}
+		return {}
+
+	var info_path: NodePath = NodePath(".")
+	if info_node != preview_chunk:
+		info_path = preview_chunk.get_path_to(info_node)
+
+	var rotations = []
+	for rot in range(4):
+		rotations.append({
+			"rotation": rot,
+			"data": info_node.get_rotated_data(rot)
+		})
+
+	var metadata = {
+		"info_path": info_path,
+		"rotations": rotations,
+		"has_lamppost": "have_lamppost" in info_node and info_node.have_lamppost,
+	}
+	preview_chunk.queue_free()
+	chunk_candidate_cache[key] = metadata
+	return metadata
+
+func _get_cached_chunk_info(instance: Node, scene: PackedScene) -> Node:
+	var metadata = _get_chunk_scene_metadata(scene)
+	if metadata.is_empty():
+		return null
+
+	var info_path: NodePath = metadata["info_path"]
+	if String(info_path) == ".":
+		return instance
+	return instance.get_node_or_null(info_path)
+
+func _clear_pending_world_work() -> void:
+	pending_generation_cells.clear()
+	pending_cleanup_cells.clear()
+	pending_wire_cells.clear()
+	pending_wire_lookup.clear()
+	pending_radar_update = false
+
+func _refresh_world_work(center: Vector2i) -> void:
+	_rebuild_generation_queue(center)
+	_rebuild_cleanup_queue(center)
+
+func _rebuild_generation_queue(center: Vector2i) -> void:
+	pending_generation_cells.clear()
+
+	for radius in range(eye_line + 1):
+		for x in range(-radius, radius + 1):
+			for z in range(-radius, radius + 1):
+				if maxi(abs(x), abs(z)) != radius:
+					continue
+
+				var grid_pos = center + Vector2i(x, z)
+				if board.has(grid_pos):
+					continue
+				pending_generation_cells.append(grid_pos)
+
+func _rebuild_cleanup_queue(center: Vector2i) -> void:
+	pending_cleanup_cells.clear()
+	var safe_margin = 2
+
+	for grid_pos in board.keys():
+		var cell = board[grid_pos]
+		if cell["type"] == "obstacle":
+			continue
+
+		var dist_x = abs(grid_pos.x - center.x)
+		var dist_z = abs(grid_pos.y - center.y)
+		if dist_x > eye_line + safe_margin or dist_z > eye_line + safe_margin:
+			pending_cleanup_cells.append(grid_pos)
+
+func _drain_generation_queue() -> void:
+	var processed = 0
+	while processed < CHUNK_GENERATION_STEPS_PER_FRAME and not pending_generation_cells.is_empty():
+		var grid_pos = pending_generation_cells.pop_front()
+		if board.has(grid_pos):
+			continue
+
+		var is_obstacle = _register_cell_with_ray(grid_pos)
+		if not is_obstacle:
+			_add_compatible_biome(grid_pos)
+		processed += 1
+
+func _drain_cleanup_queue() -> void:
+	var processed = 0
+	while processed < CHUNK_CLEANUP_STEPS_PER_FRAME and not pending_cleanup_cells.is_empty():
+		var grid_pos = pending_cleanup_cells.pop_front()
+		if not board.has(grid_pos):
+			continue
+
+		var cell = board[grid_pos]
+		if cell["type"] == "obstacle":
+			continue
+
+		if cell.has("node") and is_instance_valid(cell["node"]):
+			cell["node"].queue_free()
+		board.erase(grid_pos)
+		processed += 1
+
+func _queue_lamppost_wire_connection(grid_pos: Vector2i) -> void:
+	if pending_wire_lookup.has(grid_pos):
+		return
+	pending_wire_lookup[grid_pos] = true
+	pending_wire_cells.append(grid_pos)
+
+func _drain_wire_queue() -> void:
+	var processed = 0
+	while processed < LAMPPOST_WIRE_STEPS_PER_FRAME and not pending_wire_cells.is_empty():
+		var grid_pos = pending_wire_cells.pop_front()
+		pending_wire_lookup.erase(grid_pos)
+
+		if not board.has(grid_pos):
+			continue
+		if not board[grid_pos].get("have_lamppost", false):
+			continue
+
+		_connect_lamppost_wires(grid_pos)
+		processed += 1
+
 func _generate_pieces_around_train(center: Vector2i) -> void:
 	for x in range(-eye_line, eye_line + 1):
 		for z in range(-eye_line, eye_line + 1):
@@ -181,6 +367,7 @@ func _register_cell_with_ray(grid_pos: Vector2i) -> bool:
 			right_info_node = info_list[0]
 
 		var exit_found = {"north": false, "est": false, "south": false, "west": false}
+		var river_exit_found = {"north": false, "est": false, "south": false, "west": false}
 		var height_found = {"north": 0, "est": 0, "south": 0, "west": 0}
 		var have_lamppost = false
 		
@@ -190,6 +377,7 @@ func _register_cell_with_ray(grid_pos: Vector2i) -> bool:
 				var rotation_steps = roundi(rad_to_deg(right_info_node.global_rotation.y) / -90.0)
 				var data = right_info_node.get_rotated_data(rotation_steps)
 				exit_found = data["connections"]
+				river_exit_found = data["river_connections"]
 				height_found = data["heights"]
 
 			if "have_lamppost" in right_info_node:
@@ -199,6 +387,7 @@ func _register_cell_with_ray(grid_pos: Vector2i) -> bool:
 		board[grid_pos] = {
 			"type": "obstacle", 
 			"exit": exit_found, 
+			"river_exit": river_exit_found,
 			"heights": height_found, 
 			"node": root_chunk,  
 			"info": right_info_node,     
@@ -206,7 +395,7 @@ func _register_cell_with_ray(grid_pos: Vector2i) -> bool:
 		}
 		
 		if have_lamppost:
-			_connect_lamppost_wires(grid_pos)
+			_queue_lamppost_wire_connection(grid_pos)
 			
 		return true 
 	return false 
@@ -216,6 +405,10 @@ func _add_compatible_biome(grid_pos: Vector2i) -> void:
 	var req_conn_est = _needed_connection(grid_pos + Vector2i(1, 0), "west")
 	var req_conn_south = _needed_connection(grid_pos + Vector2i(0, 1), "north")
 	var req_conn_west = _needed_connection(grid_pos + Vector2i(-1, 0), "est")
+	var req_river_north = _needed_river_connection(grid_pos + Vector2i(0, -1), "south")
+	var req_river_est = _needed_river_connection(grid_pos + Vector2i(1, 0), "west")
+	var req_river_south = _needed_river_connection(grid_pos + Vector2i(0, 1), "north")
+	var req_river_west = _needed_river_connection(grid_pos + Vector2i(-1, 0), "est")
 	
 	var req_height_north = _needed_heights(grid_pos + Vector2i(0, -1), "south")
 	var req_height_est = _needed_heights(grid_pos + Vector2i(1, 0), "west")
@@ -229,21 +422,25 @@ func _add_compatible_biome(grid_pos: Vector2i) -> void:
 	var valid_candidates = []
 	
 	for scene in zone_catalogue:
-		var test_chunk = scene.instantiate()
+		var metadata = _get_chunk_scene_metadata(scene)
-		var test_list: Array[Node] = []
+		if metadata.is_empty():
-		collect_all_chunkinfo(test_chunk, test_list)
+			continue
-		var info_test = test_list[0] if test_list.size() > 0 else null
 
-		if info_test != null and info_test.has_method("get_rotated_data"):
+		for candidate in metadata["rotations"]:
-			for rot in range(4):
+			var rot = candidate["rotation"]
-				var data = test_chunk.get_rotated_data(rot)
+			var data = candidate["data"]
 			var u_conn = data["connections"]
+			var u_river_conn = data["river_connections"]
 			var u_height = data["heights"]
 			
 			var match_conn_n = (req_conn_north == -1) or ((req_conn_north == 1) == u_conn["north"])
 			var match_conn_e = (req_conn_est == -1)  or ((req_conn_est == 1) == u_conn["est"])
 			var match_conn_s = (req_conn_south == -1)  or ((req_conn_south == 1) == u_conn["south"])
 			var match_conn_o = (req_conn_west == -1) or ((req_conn_west == 1) == u_conn["west"])
+			var match_river_n = (req_river_north == -1) or ((req_river_north == 1) == u_river_conn["north"])
+			var match_river_e = (req_river_est == -1) or ((req_river_est == 1) == u_river_conn["est"])
+			var match_river_s = (req_river_south == -1) or ((req_river_south == 1) == u_river_conn["south"])
+			var match_river_o = (req_river_west == -1) or ((req_river_west == 1) == u_river_conn["west"])
 			
 			var match_alt_n = (req_height_north == -1) or (req_height_north == u_height["north"])
 			var match_alt_e = (req_height_est == -1)  or (req_height_est == u_height["est"])
@@ -256,7 +453,7 @@ func _add_compatible_biome(grid_pos: Vector2i) -> void:
 			var diff_o = abs(u_height["west"] - height_target) if req_height_west == -1 else 0
 			var excessive_jumps = diff_n > 1 or diff_e > 1 or diff_s > 1 or diff_o > 1
 			
-				if match_conn_n and match_conn_e and match_conn_s and match_conn_o and match_alt_n and match_alt_e and match_alt_s and match_alt_o and not excessive_jumps:
+			if match_conn_n and match_conn_e and match_conn_s and match_conn_o and match_river_n and match_river_e and match_river_s and match_river_o and match_alt_n and match_alt_e and match_alt_s and match_alt_o and not excessive_jumps:
 				var score = 0
 				if req_height_north == -1 and u_height["north"] == height_target: score += 1
 				if req_height_est == -1 and u_height["est"] == height_target: score += 1
@@ -265,8 +462,6 @@ func _add_compatible_biome(grid_pos: Vector2i) -> void:
 				
 				valid_candidates.append({"scene": scene, "rotation": rot, "data": data, "score": score})
 		
-		test_chunk.queue_free()
-		
 	if valid_candidates.size() > 0:
 		var max_score = -1
 		for c in valid_candidates:
@@ -278,21 +473,20 @@ func _add_compatible_biome(grid_pos: Vector2i) -> void:
 				
 		var choise = best_candidate.pick_random()
 		var new_chunk = choise.scene.instantiate()
-		add_child(new_chunk)
 		new_chunk.position = Vector3(grid_pos.x * chunk_size, 0, grid_pos.y * chunk_size)
 		new_chunk.rotation.y = choise.rotation * (-PI / 2.0)
+		add_child(new_chunk)
 		
-		var new_list: Array[Node] = []
+		var info_new = _get_cached_chunk_info(new_chunk, choise.scene)
-		collect_all_chunkinfo(new_chunk, new_list)
-		var info_new = new_list[0] if new_list.size() > 0 else null
 		
 		var have_lamppost = false
-		if info_new != null and "have_lamppost" in new_chunk:
+		if info_new != null and "have_lamppost" in info_new:
 			have_lamppost = info_new.have_lamppost
 			
 		board[grid_pos] = {
 			"type": "bioma", 
 			"exit": choise.data["connections"], 
+			"river_exit": choise.data["river_connections"],
 			"heights": choise.data["heights"], 
 			"node": new_chunk, 
 			"info": info_new,
@@ -300,16 +494,14 @@ func _add_compatible_biome(grid_pos: Vector2i) -> void:
 		}
 		
 		if have_lamppost:
-			_connect_lamppost_wires(grid_pos)
+			_queue_lamppost_wire_connection(grid_pos)
 
 	else:	
 		var backup = zone_catalogue[0].instantiate()
-		add_child(backup)
 		backup.position = Vector3(grid_pos.x * chunk_size, 0, grid_pos.y * chunk_size)
+		add_child(backup)
 		
-		var backup_list: Array[Node] = []
+		var info_backup = _get_cached_chunk_info(backup, zone_catalogue[0])
-		collect_all_chunkinfo(backup, backup_list)
-		var info_backup = backup_list[0] if backup_list.size() > 0 else null
 	
 		var safe_heights = {
 			"north": req_height_north if req_height_north != -1 else height_target,
@@ -320,6 +512,7 @@ func _add_compatible_biome(grid_pos: Vector2i) -> void:
 		board[grid_pos] = {
 			"type": "biome", 
 			"exit": {"north":false, "est":false, "south":false, "west":false}, 
+			"river_exit": {"north":false, "est":false, "south":false, "west":false},
 			"heights": safe_heights, 
 			"node": backup,
 			"info": info_backup,
@@ -333,6 +526,13 @@ func _needed_connection(near_pos: Vector2i, side_needed: String) -> int:
 		return 1 if board[near_pos]["exit"][side_needed] else 0 
 	return -1 
 
+func _needed_river_connection(near_pos: Vector2i, side_needed: String) -> int:
+	if not board.has(near_pos): 
+		_register_cell_with_ray(near_pos)
+	if board.has(near_pos) and board[near_pos].has("river_exit"):
+		return 1 if board[near_pos]["river_exit"][side_needed] else 0
+	return -1
+
 func _needed_heights(near_pos: Vector2i, side_needed: String) -> int:
 	if board.has(near_pos) and board[near_pos].has("heights"):
 		return board[near_pos]["heights"][side_needed]
@@ -351,8 +551,6 @@ func _train_radar() -> void:
 	
 	var current_progress = rail_path.train_progress
 	var total_length = rail_path.curve.get_baked_length()
-	#var exchange_distance = 0.0
-	#var next_biome = ""
 
 	for step in range(1, 31):
 		var next_progress = wrapf(current_progress + (step * chunk_size), 0.0, total_length)
@@ -364,44 +562,18 @@ func _train_radar() -> void:
 		var future_biome = _get_procedural_biome_name(noise_generator.get_noise_2d(f_x, f_z))
 		
 		if future_biome != current_biome:
-			#exchange_distance = step * chunk_size
-			#next_biome = future_biome
 			break
 			
-func _clean_far_chunks(centro_attuale: Vector2i) -> void:
-	var cells_to_remove = []
-	var safe_margin = 2 
-	
-	for grid_pos in board.keys():
-		var cell = board[grid_pos]
-		if cell["type"] == "obstacle": continue
-			
-		var dist_x = abs(grid_pos.x - centro_attuale.x)
-		var dist_z = abs(grid_pos.y - centro_attuale.y)
-		
-		if dist_x > eye_line + safe_margin or dist_z > eye_line + safe_margin:
-			if cell.has("node") and is_instance_valid(cell["node"]):
-				cell["node"].queue_free()
-			cells_to_remove.append(grid_pos)
-			
-	for pos in cells_to_remove:
-		board.erase(pos)
-
-
 func _get_lampposts(info_node: Node, side: String) -> Array[Node3D]:
 	var lampposts: Array[Node3D] = []
 	if side == "sx":
 		if "connection_left" in info_node and info_node.connection_left != null:
 			for p in info_node.connection_left: 
 				if is_instance_valid(p): lampposts.append(p)
-		#if lampposts.is_empty() and "nodo_attacco_sx" in nodo_info and is_instance_valid(nodo_info.get("nodo_attacco_sx")):
-		#	lampposts.append(nodo_info.get("nodo_attacco_sx"))
 	else:
 		if "connection_right" in info_node and info_node.connection_right != null:
 			for p in info_node.connection_right: 
 				if is_instance_valid(p): lampposts.append(p)
-		#if lampposts.is_empty() and "nodo_attacco_dx" in nodo_info and is_instance_valid(nodo_info.get("nodo_attacco_dx")):
-		#	lampposts.append(nodo_info.get("nodo_attacco_dx"))
 	return lampposts
 
 func _connect_lamppost_wires(new_board_pos: Vector2i) -> void:

core/biome_generator/chunk_info.gd

@@ -12,6 +12,12 @@ class_name ChunkInfo
 @export var south: bool = false
 @export var west: bool = false
 
+@export_group("River exit")
+@export var river_north: bool = false
+@export var river_est: bool = false
+@export var river_south: bool = false
+@export var river_west: bool = false
+
 @export_group("Margin heights (level 0, 1, 2)")
 @export_range(0, 2, 1) var height_north: int = 0
 @export_range(0, 2, 1) var height_est: int = 0
@@ -29,14 +35,17 @@ func _ready() -> void:
 
 func get_rotated_data(steps_90: int) -> Dictionary:
 	var original_exit = [north, est, south, west]
+	var original_river_exit = [river_north, river_est, river_south, river_west]
 	var original_height = [height_north, height_est, height_south, height_west]
 	
 	var calculated_exit = []
+	var calculated_river_exit = []
 	var calculated_height = []
 	
 	for i in range(4):
 		var index  = (i - steps_90 + 4) % 4
 		calculated_exit.append(original_exit[index])
+		calculated_river_exit.append(original_river_exit[index])
 		calculated_height.append(original_height[index])
 		
 	return {
@@ -44,6 +53,10 @@ func get_rotated_data(steps_90: int) -> Dictionary:
 			"north": calculated_exit[0], "est": calculated_exit[1],
 			"south": calculated_exit[2], "west": calculated_exit[3]
 		},
+		"river_connections": {
+			"north": calculated_river_exit[0], "est": calculated_river_exit[1],
+			"south": calculated_river_exit[2], "west": calculated_river_exit[3]
+		},
 		"heights": {
 			"north": calculated_height[0], "est": calculated_height[1],
 			"south": calculated_height[2], "west": calculated_height[3]

core/daynight/environment_management.tscn

@@ -265,7 +265,7 @@ shader_parameter/edge_softness_x = 0.5
 shader_parameter/night_intensity = 0.0
 shader_parameter/sun_color = Color(1, 1, 1, 1)
 
-[node name="EnvironmentManager" type="Node3D" unique_id=1611939731 node_paths=PackedStringArray("particles_wind", "particles_snow", "particles_fireflies", "particles_rain", "environment_dust", "blur", "environment_shadows")]
+[node name="EnvironmentManager" type="Node3D" unique_id=1611939731 node_paths=PackedStringArray("particles_wind", "particles_snow", "particles_fireflies", "particles_rain", "environment_dust", "blur", "environment_shadows", "fog")]
 script = ExtResource("1_wecen")
 environment_config = SubResource("Resource_r4tfj")
 particles_wind = NodePath("Particles_Wind")
@@ -276,6 +276,7 @@ godray = ExtResource("5_411rw")
 environment_dust = NodePath("EnvironmentDust")
 blur = NodePath("Blur")
 environment_shadows = NodePath("EnvironmentCloudsShadows")
+fog = NodePath("Fog")
 
 [node name="Particles_Fireflies" type="GPUParticles3D" parent="." unique_id=947538133]
 transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 2, 0)
@@ -340,11 +341,11 @@ surface_material_override/0 = SubResource("ShaderMaterial_oqt1s")
 [node name="Fog" type="Node3D" parent="." unique_id=1626352238]
 
 [node name="MeshInstance3D" type="MeshInstance3D" parent="Fog" unique_id=96635311]
-transform = Transform3D(-42.075005, 7.553328e-06, 1.7196172e-13, 0, -3.7766642e-06, 45, 3.6783138e-06, 86.4, 1.9670128e-06, -67, 14, 0)
+transform = Transform3D(-42.075005, 7.553328e-06, 1.7196172e-13, 0, -3.7766642e-06, 45, 3.6783138e-06, 86.4, 1.9670128e-06, -41.926987, 14, 0)
 mesh = SubResource("QuadMesh_yn8v8")
 surface_material_override/0 = SubResource("ShaderMaterial_sxgg7")
 
 [node name="MeshInstance3D2" type="MeshInstance3D" parent="Fog" unique_id=10121049]
-transform = Transform3D(-42.075005, 7.553328e-06, 1.7196172e-13, 0, -3.7766642e-06, 45, 3.6783138e-06, 86.4, 1.9670128e-06, 67, 14, 0)
+transform = Transform3D(-42.075005, 7.553328e-06, 1.7196172e-13, 0, -3.7766642e-06, 45, 3.6783138e-06, 86.4, 1.9670128e-06, 59.320038, 14, 0)
 mesh = SubResource("QuadMesh_yn8v8")
 surface_material_override/0 = SubResource("ShaderMaterial_sxgg7")

core/daynight/environment_manager.gd

@@ -4,6 +4,7 @@ extends Node3D
 const NOISE_TEXTURE: Texture2D = preload("res://core/daynight/noise.tres")
 const WEATHER_SHADER: Material = preload("res://core/daynight/weather_overlay.tres")
 const WEATHER_PLAIN_SHADER: Material = preload("res://core/daynight/weather_plain_shader.tres")
+const DYNAMIC_ENVIRONMENT_UPDATES_PER_FRAME: int = 2 #how many update of the environment (apply materials) will be done per frame
 
 @export var environment_config: EnvironmentConfig
 
@@ -20,6 +21,7 @@ const WEATHER_PLAIN_SHADER: Material = preload("res://core/daynight/weather_plai
 @export var environment_dust: ColorRect
 @export var blur: ColorRect
 @export var environment_shadows: MeshInstance3D
+@export var fog: Node3D
 
 @export_group("Sound")
 @export var thunder_sounds: Array[AudioStream]
@@ -28,19 +30,18 @@ const WEATHER_PLAIN_SHADER: Material = preload("res://core/daynight/weather_plai
 #environment nodes
 @onready var sun: DirectionalLight3D = $"../DirectionalLight3D"
 @onready var environment: WorldEnvironment = $"../WorldEnvironment"
-@onready var fog_node: Node3D = $Fog
 
 var day_night_controller: DayNightController 
 var weather_controller: WeatherController
 
 var day_tween: Tween
 var day_time: float = 0.0
+var pending_environment_nodes: Dictionary = {}
 
 func _ready() -> void:
 	
 	#connect shader when new node is added
 	get_tree().node_added.connect(_on_tree_node_added)
-	UIEvents.toggle_fog.connect(toggle_fog)
 	
 	#set noise texture 2d to materials in special group
 	ApplyWindNoiseToMaterials()
@@ -64,6 +65,7 @@ func _ready() -> void:
 			godray,
 			environment_dust,
 			blur,
+			fog,
 			environment_shadows,
 			sun,
 			environment,
@@ -76,9 +78,50 @@ func _ready() -> void:
 		weather_controller.name = "WeatherController"
 		add_child(weather_controller)
 
+func _process(_delta: float) -> void:
+	_process_pending_environment_nodes()
+
 func _on_tree_node_added(node: Node) -> void:
 	if node.is_in_group("wind_node") or node.is_in_group("weather_node") or node.is_in_group("weather_vegetables_node"):
-		call_deferred("_apply_dynamic_environment_materials", node)
+		_queue_dynamic_environment_node(node)
+
+func _queue_dynamic_environment_node(node: Node) -> void:
+	if not is_instance_valid(node):
+		return
+
+	var ancestor = node.get_parent()
+	while ancestor != null:
+		if pending_environment_nodes.has(ancestor.get_instance_id()):
+			return
+		ancestor = ancestor.get_parent()
+
+	var stale_ids: Array[int] = []
+	for node_id in pending_environment_nodes.keys():
+		var pending_node = pending_environment_nodes[node_id]
+		if not is_instance_valid(pending_node):
+			stale_ids.append(node_id)
+			continue
+		if node.is_ancestor_of(pending_node):
+			stale_ids.append(node_id)
+
+	for node_id in stale_ids:
+		pending_environment_nodes.erase(node_id)
+
+	pending_environment_nodes[node.get_instance_id()] = node
+
+func _process_pending_environment_nodes() -> void:
+	var processed = 0
+	for node_id in pending_environment_nodes.keys():
+		if processed >= DYNAMIC_ENVIRONMENT_UPDATES_PER_FRAME:
+			break
+
+		var node = pending_environment_nodes[node_id]
+		pending_environment_nodes.erase(node_id)
+		if not is_instance_valid(node):
+			continue
+
+		_apply_dynamic_environment_materials(node)
+		processed += 1
 
 func _apply_dynamic_environment_materials(node: Node) -> void:
 	if not is_instance_valid(node):
@@ -160,7 +203,3 @@ func select_day_time(normalized_time: float) -> void:
 
 	if weather_controller:
 		weather_controller.day_time = day_time
-
-func toggle_fog(value: bool) -> void:
-	if fog_node:
-		fog_node.visible = value

core/daynight/snow_cap.gd

@@ -20,17 +20,14 @@ const SNOW_CAP_SHADER: Shader = preload("res://core/daynight/snow_cap.gdshader")
 
 var _mesh_instance: MeshInstance3D
 
-
 func _ready() -> void:
 	add_to_group("weather_overlay_ignore")
 	_ensure_mesh_instance()
 	_rebuild()
 
-
 func rebuild() -> void:
 	_rebuild()
 
-
 func _ensure_mesh_instance() -> void:
 	_mesh_instance = get_node_or_null("SnowCapMesh") as MeshInstance3D
 	if _mesh_instance != null:
@@ -41,7 +38,6 @@ func _ensure_mesh_instance() -> void:
 	_mesh_instance.add_to_group("weather_overlay_ignore")
 	add_child(_mesh_instance)
 
-
 func _rebuild() -> void:
 	var cap_width: float = 0.0
 	var cap_depth: float = 0.0
@@ -78,7 +74,6 @@ func _rebuild() -> void:
 	_mesh_instance.material_override = _build_material(cap_width, cap_depth)
 	_mesh_instance.visible = true
 
-
 func _build_material(cap_width: float, cap_depth: float) -> ShaderMaterial:
 	var material := ShaderMaterial.new()
 	material.shader = SNOW_CAP_SHADER
@@ -87,7 +82,6 @@ func _build_material(cap_width: float, cap_depth: float) -> ShaderMaterial:
 	material.set_shader_parameter("half_depth", cap_depth * 0.5)
 	return material
 
-
 func _get_target_aabb(target_mesh: MeshInstance3D) -> AABB:
 	var points: Array[Vector3] = []
 	for point in _get_aabb_points(target_mesh.get_aabb()):
@@ -98,7 +92,6 @@ func _get_target_aabb(target_mesh: MeshInstance3D) -> AABB:
 		merged = merged.expand(point)
 	return merged
 
-
 func _get_aabb_points(aabb: AABB) -> Array[Vector3]:
 	var p: Vector3 = aabb.position
 	var s: Vector3 = aabb.size

core/daynight/weather_controller.gd

@@ -14,6 +14,7 @@ var godray: PackedScene
 var environment_dust: ColorRect
 var blur: ColorRect
 var environment_shadows: MeshInstance3D
+var fog: Node3D
 
 var sun: DirectionalLight3D
 var environment: WorldEnvironment
@@ -50,10 +51,12 @@ var current_wind_strength: float = 0.0
 var current_wind_fade: float = 0.0
 var max_wind_amount: int = 0
 var random_weather_restore_tween: Tween
+var random_event_remaining: float = 0.0
+var random_event_label_seconds: int = -1
 
 func _init(wind: GPUParticles3D, snow: GPUParticles3D, 
 	fireflies: GPUParticles3D, rain: GPUParticles3D, ray: PackedScene,
-	dust: ColorRect, blurr: ColorRect, envshadows: MeshInstance3D,
+	dust: ColorRect, blurr: ColorRect, thefog: Node3D, envshadows: MeshInstance3D,
 	thesun: DirectionalLight3D, theenvironment: WorldEnvironment, environmentconfig: EnvironmentConfig,
 	thecamera: Camera3D, thecamerapivot: Node3D, thundersounds: Array[AudioStream], rainsounds: Array[AudioStream]) -> void:
 	particles_wind = wind
@@ -64,6 +67,7 @@ func _init(wind: GPUParticles3D, snow: GPUParticles3D,
 	sun = thesun
 	environment_dust = dust
 	blur = blurr
+	fog = thefog
 	environment_shadows = envshadows
 	environment = theenvironment
 	environment_config = environmentconfig
@@ -87,6 +91,7 @@ func _init(wind: GPUParticles3D, snow: GPUParticles3D,
 	
 	toggle_dust(environment_config.enable_dust)
 	toggle_blur(environment_config.enable_blur)
+	toggle_fog(environment_config.enable_fog)
 	
 	#set camera pivot if available
 	if camera_pivot:
@@ -104,10 +109,12 @@ func _ready() -> void:
 	UIEvents.toggle_storm.connect(toggle_storm)
 	UIEvents.toggle_dust.connect(toggle_dust)
 	UIEvents.toggle_blur.connect(toggle_blur)
+	UIEvents.toggle_fog.connect(toggle_fog)
 	UIEvents.toggle_shadows.connect(toggle_shadows)
 	_emit_weather_event_label()
 
 func _process(delta: float) -> void:
+	_update_random_event_label(delta)
 	
 	_follow_camera()
 	
@@ -273,6 +280,23 @@ func _get_weather_anchor_position() -> Variant:
 		return camera.global_position
 	return null
 
+func _get_weather_anchor_basis() -> Variant:
+	var source_basis: Basis
+	if camera_pivot and is_instance_valid(camera_pivot):
+		source_basis = camera_pivot.global_basis
+	elif camera and is_instance_valid(camera):
+		source_basis = camera.global_basis
+	else:
+		return null
+
+	var forward := -source_basis.z
+	forward.y = 0.0
+	if forward.length_squared() <= 0.0001:
+		return Basis.IDENTITY
+	forward = forward.normalized()
+	var right := forward.cross(Vector3.UP).normalized()
+	return Basis(right, Vector3.UP, -forward)
+
 func _follow_camera() -> void:
 	var cam_pos = _get_weather_anchor_position()
 	if cam_pos == null:
@@ -285,6 +309,12 @@ func _follow_camera() -> void:
 		particles_wind.global_position = Vector3(cam_pos.x, cam_pos.y, cam_pos.z)
 	if particles_fireflies:
 		particles_fireflies.global_position = Vector3(cam_pos.x, particles_fireflies.position.y, cam_pos.z)
+	if fog:
+		fog.global_position = Vector3(cam_pos.x, fog.global_position.y, cam_pos.z)
+		#used to follow camera pivot or camera
+		var anchor_basis = _get_weather_anchor_basis()
+		if anchor_basis != null:
+			fog.global_basis = anchor_basis
 #endregion
 
 #region Fireflies
@@ -422,6 +452,8 @@ func _update_wind_amount_from_strength(value: float) -> void:
 func trigger_random_weather_event(duration: float = 0.0) -> void:
 	if random_weather_restore_tween and random_weather_restore_tween.is_valid():
 		random_weather_restore_tween.kill()
+	random_event_remaining = 0.0
+	random_event_label_seconds = -1
 
 	var previous_rain: bool = is_raining
 	var previous_snow: bool = is_snowing
@@ -439,12 +471,26 @@ func trigger_random_weather_event(duration: float = 0.0) -> void:
 			_apply_weather_event_state(true, false, false, true)
 
 	if duration > 0.0:
+		random_event_remaining = duration
+		_emit_weather_event_label()
 		random_weather_restore_tween = create_tween()
 		random_weather_restore_tween.tween_interval(duration)
 		random_weather_restore_tween.tween_callback(func():
+			random_event_remaining = 0.0
+			random_event_label_seconds = -1
 			_apply_weather_event_state(previous_rain, previous_snow, previous_wind, previous_storm)
 		)
 
+func _update_random_event_label(delta: float) -> void:
+	if random_event_remaining <= 0.0:
+		return
+
+	random_event_remaining = maxf(random_event_remaining - delta, 0.0)
+	var display_seconds: int = ceili(random_event_remaining)
+	if display_seconds != random_event_label_seconds:
+		random_event_label_seconds = display_seconds
+		_emit_weather_event_label()
+
 func _apply_weather_event_state(rain_enabled: bool, snow_enabled: bool, wind_enabled: bool, storm_enabled: bool = false) -> void:
 	if is_storm and not storm_enabled:
 		toggle_storm(false)
@@ -758,6 +804,8 @@ func _emit_weather_event_label() -> void:
 			active_events.append("Wind")
 		if not active_events.is_empty():
 			weather_label = "Weather: %s" % " + ".join(active_events)
+	if random_event_remaining > 0.0:
+		weather_label += " (%s'')" % ceili(random_event_remaining)
 	UIEvents.weather_event_changed.emit(weather_label)
 
 #disable snow and set default values and shader
@@ -809,6 +857,10 @@ func toggle_blur(value: bool) -> void:
 
 	ApplyPostProcessBlurConfig()
 
+func toggle_fog(value: bool) -> void:
+	if fog:
+		fog.visible = value
+
 func toggle_shadows(value: bool) -> void:
 	if environment_shadows:
 		environment_shadows.visible = value

core/environment_config.gd

@@ -83,7 +83,7 @@ extends Resource
 @export var enable_dust: bool = false #Floating dust particles overlay
 @export var enable_blur: bool = true #Screen blur effect
 @export var enable_environment_shadows: bool = true #Cloud shadow projection on terrain
-@export var enable_fog: bool = true #Enable fog around the train
+@export var enable_fog: bool = false #Enable fog around the train
 @export var blur_amount: float = 0.6
 
 @export_group("Dust")
@@ -184,3 +184,7 @@ extends Resource
 @export var water_color_afternoon: Color = Color(0.889, 0.733, 0.205, 1.0) #Tint for afternoon (sunset)
 @export var water_color_night: Color = Color(0.728, 0.54, 0.986, 1.0); #Tint for night
 @export var water_darkening_rain: float = 0.7 #Percentage of darkening when is rainy
+
+#Random events
+@export_group("Random Events")
+@export var random_event_duration: float = 30.0 #Duration time for random event

docs/museums/biome_generator/museum_map.tscn

@@ -28,8 +28,10 @@
 [ext_resource type="AudioStream" uid="uid://creenugno7hm" path="res://core/daynight/sounds/thunder_4.mp3" id="18_lfsx4"]
 [ext_resource type="PackedScene" uid="uid://pxmcy0lhne5d" path="res://tgcc/chunk/countryside/scene/chunk_country_straight_03.tscn" id="19_ne4de"]
 [ext_resource type="AudioStream" uid="uid://bm6dq4jwsbxf6" path="res://core/daynight/sounds/thunder_5.mp3" id="19_niwdr"]
+[ext_resource type="PackedScene" uid="uid://bs3dkwcc8w2uk" path="res://tgcc/chunk/river/scene/chunk_r_l_1.tscn" id="20_q6kbb"]
 [ext_resource type="AudioStream" uid="uid://byuxpukhy72n8" path="res://core/daynight/sounds/rain_1.mp3" id="20_quqod"]
 [ext_resource type="PackedScene" uid="uid://1c1ion0qnho4" path="res://tgcc/map/map_1/map_1.tscn" id="20_xkcqp"]
+[ext_resource type="PackedScene" uid="uid://btipd6wev016d" path="res://tgcc/chunk/river/scene/chunk_r_r_1.tscn" id="21_81wux"]
 [ext_resource type="AudioStream" uid="uid://h5yhjn1x3f4j" path="res://core/daynight/sounds/rain_2.mp3" id="21_appab"]
 [ext_resource type="AudioStream" uid="uid://elrjw0smm0cj" path="res://core/daynight/sounds/rain_3.mp3" id="22_yime3"]
 [ext_resource type="Script" uid="uid://cx2tlvxhvatj5" path="res://docs/museums/daynight/control.gd" id="23_ou3jn"]
@@ -112,7 +114,7 @@ compositor_effects = Array[CompositorEffect]([SubResource("CompositorEffect_q52t
 [sub_resource type="Resource" id="Resource_3qrd0"]
 script = ExtResource("6_s3jnv")
 name = "countryside"
-available_chunks = Array[PackedScene]([ExtResource("7_xgfli"), ExtResource("8_nurqm"), ExtResource("9_q6kbb"), ExtResource("7_4elh6"), ExtResource("8_hvd8d"), ExtResource("12_81wux"), ExtResource("13_1ugwu"), ExtResource("10_ufarv"), ExtResource("15_ky1rt"), ExtResource("16_5g563"), ExtResource("17_tbmwr"), ExtResource("9_51cxd"), ExtResource("19_ne4de")])
+available_chunks = Array[PackedScene]([ExtResource("7_xgfli"), ExtResource("8_nurqm"), ExtResource("9_q6kbb"), ExtResource("7_4elh6"), ExtResource("8_hvd8d"), ExtResource("12_81wux"), ExtResource("13_1ugwu"), ExtResource("10_ufarv"), ExtResource("15_ky1rt"), ExtResource("16_5g563"), ExtResource("17_tbmwr"), ExtResource("9_51cxd"), ExtResource("19_ne4de"), ExtResource("20_q6kbb"), ExtResource("21_81wux")])
 metadata/_custom_type_script = "uid://wv6kcqkibium"
 
 [sub_resource type="StandardMaterial3D" id="StandardMaterial3D_pypsn"]
@@ -386,7 +388,7 @@ theme_override_colors/font_pressed_color = Color(1, 1, 1, 1)
 theme_override_colors/font_hover_color = Color(1, 1, 1, 1)
 theme_override_colors/font_hover_pressed_color = Color(1, 1, 1, 1)
 theme_override_colors/font_outline_color = Color(1, 1, 1, 1)
-text = "Random Weather (10\")"
+text = "Random Weather"
 
 [node name="WeatherEventLabel" type="Label" parent="Control" unique_id=641424797]
 layout_mode = 0

docs/museums/daynight/control.gd

@@ -7,6 +7,8 @@ extends Control
 @onready var wind_slider: HSlider = $WindSlider
 @onready var day_time_option: OptionButton = $DayTimeOptions
 
+var default_random_event_duration: float = 10.0
+
 func _ready() -> void:
 	UIEvents.day_time_changed.connect(_on_day_time_changed)
 	UIEvents.day_time_option_changed.connect(_on_day_time_option_changed)
@@ -29,7 +31,10 @@ func _on_wind_slider_value_changed(value: float) -> void:
 	UIEvents.wind_change.emit(value)
 
 func _on_random_weather_pressed() -> void:
-	UIEvents.trigger_random_weather.emit(10.0)
+	var duration: float = default_random_event_duration
+	if day_night != null and day_night.environment_config != null:
+		duration = day_night.environment_config.random_event_duration
+	UIEvents.trigger_random_weather.emit(duration)
 
 func _on_fireflies_toggled(toggled_on: bool) -> void:
 	UIEvents.toggle_fireflies.emit(toggled_on)

tgcc/chunk/countryside/scene/chunk_country_cross_4_01.tscn

@@ -106,7 +106,7 @@ surface_material_override/1 = ExtResource("6_b82gs")
 surface_material_override/0 = ExtResource("6_b82gs")
 surface_material_override/1 = ExtResource("5_wbwk3")
 
-[node name="MSH_Staccioanta_1_017" parent="." index="10" unique_id=845283196]
+[node name="MSH_Staccioanta_1_017" parent="." index="10" unique_id=845283196 groups=["weather_node"]]
 surface_material_override/0 = ExtResource("7_be1u8")
 
 [node name="PaliLuci_001" parent="." index="11" unique_id=1390758113]

tgcc/chunk/countryside/scene/chunk_country_straight_02.tscn

@@ -157,7 +157,7 @@ surface_material_override/0 = ExtResource("2_t65ww")
 [node name="Bags" parent="." index="1" unique_id=2117673123]
 surface_material_override/0 = SubResource("ShaderMaterial_q2s76")
 
-[node name="Cart" parent="." index="2" unique_id=884973125]
+[node name="Cart" parent="." index="2" unique_id=884973125 groups=["weather_node"]]
 surface_material_override/0 = ExtResource("11_iulsg")
 surface_material_override/1 = SubResource("ShaderMaterial_mqw0y")
 surface_material_override/2 = SubResource("ShaderMaterial_dxwao")
@@ -198,7 +198,7 @@ surface_material_override/1 = ExtResource("7_q2s76")
 [node name="Water_006" parent="." index="12" unique_id=1352334701]
 surface_material_override/0 = ExtResource("10_r4bww")
 
-[node name="WoodPile" parent="." index="13" unique_id=1088104699]
+[node name="WoodPile" parent="." index="13" unique_id=1088104699 groups=["weather_node"]]
 surface_material_override/0 = ExtResource("11_iulsg")
 surface_material_override/1 = ExtResource("12_ytk0o")
 surface_material_override/2 = SubResource("ShaderMaterial_ytk0o")

tgcc/chunk/river/mesh/Chunk_R_L_1.fbx.import

@@ -0,0 +1,44 @@
+[remap]
+
+importer="scene"
+importer_version=1
+type="PackedScene"
+uid="uid://d0rca3oo1k30n"
+path="res://.godot/imported/Chunk_R_L_1.fbx-f315be000da513deddf8c1537ffe1a0f.scn"
+
+[deps]
+
+source_file="res://tgcc/chunk/river/mesh/Chunk_R_L_1.fbx"
+dest_files=["res://.godot/imported/Chunk_R_L_1.fbx-f315be000da513deddf8c1537ffe1a0f.scn"]
+
+[params]
+
+nodes/root_type=""
+nodes/root_name=""
+nodes/root_script=null
+nodes/apply_root_scale=true
+nodes/root_scale=1.0
+nodes/import_as_skeleton_bones=false
+nodes/use_name_suffixes=true
+nodes/use_node_type_suffixes=true
+meshes/ensure_tangents=true
+meshes/generate_lods=true
+meshes/create_shadow_meshes=true
+meshes/light_baking=1
+meshes/lightmap_texel_size=0.2
+meshes/force_disable_compression=false
+skins/use_named_skins=true
+animation/import=true
+animation/fps=30
+animation/trimming=true
+animation/remove_immutable_tracks=true
+animation/import_rest_as_RESET=false
+import_script/path=""
+materials/extract=0
+materials/extract_format=0
+materials/extract_path=""
+_subresources={}
+fbx/importer=0
+fbx/allow_geometry_helper_nodes=false
+fbx/embedded_image_handling=1
+fbx/naming_version=2

tgcc/chunk/river/mesh/Chunk_R_R_1.fbx.import

@@ -0,0 +1,44 @@
+[remap]
+
+importer="scene"
+importer_version=1
+type="PackedScene"
+uid="uid://bryeoru3tfbcq"
+path="res://.godot/imported/Chunk_R_R_1.fbx-3c3c617da890fc412ffcc0f1d56c3abe.scn"
+
+[deps]
+
+source_file="res://tgcc/chunk/river/mesh/Chunk_R_R_1.fbx"
+dest_files=["res://.godot/imported/Chunk_R_R_1.fbx-3c3c617da890fc412ffcc0f1d56c3abe.scn"]
+
+[params]
+
+nodes/root_type=""
+nodes/root_name=""
+nodes/root_script=null
+nodes/apply_root_scale=true
+nodes/root_scale=1.0
+nodes/import_as_skeleton_bones=false
+nodes/use_name_suffixes=true
+nodes/use_node_type_suffixes=true
+meshes/ensure_tangents=true
+meshes/generate_lods=true
+meshes/create_shadow_meshes=true
+meshes/light_baking=1
+meshes/lightmap_texel_size=0.2
+meshes/force_disable_compression=false
+skins/use_named_skins=true
+animation/import=true
+animation/fps=30
+animation/trimming=true
+animation/remove_immutable_tracks=true
+animation/import_rest_as_RESET=false
+import_script/path=""
+materials/extract=0
+materials/extract_format=0
+materials/extract_path=""
+_subresources={}
+fbx/importer=0
+fbx/allow_geometry_helper_nodes=false
+fbx/embedded_image_handling=1
+fbx/naming_version=2