feat: add npc simulation, instancing and visual scene

simulation/SimNPC.gd

@@ -0,0 +1,50 @@
+class_name SimNPC
+extends RefCounted
+
+var id: int
+var npc_name: String
+var profession: String
+var hunger: float
+var energy: float
+var strength: float
+var intelligence: float
+var current_task: String = "idle"
+var position: Vector3
+
+func _init(
+	_id: int,
+	_npc_name: String,
+	_profession: String,
+	_strength: float,
+	_intelligence: float
+) -> void:
+	id = _id
+	npc_name = _npc_name
+	profession = _profession
+	strength = _strength
+	intelligence = _intelligence
+	hunger = randf_range(20.0, 80.0)
+	energy = randf_range(40.0, 100.0)
+
+	position = Vector3(randf_range(-8.0, 8.0), 0.0, randf_range(-8.0, 8.0))
+
+func simulate_tick() -> void:
+	hunger += 5.0
+	energy -= 2.0
+
+	if hunger > 75.0:
+		current_task = "eat"
+		hunger -= 25.0
+	elif energy < 30.0:
+		current_task = "rest"
+		energy += 20.0
+	elif profession == "farmer":
+		current_task = "gather_food"
+	elif profession == "woodcutter":
+		current_task = "gather_wood"
+	elif profession == "guard":
+		current_task = "patrol"
+	elif profession == "scholar":
+		current_task = "study"
+	else:
+		current_task = "wander"

simulation/SimNPC.gd.uid

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

simulation/SimulationManager.gd

@@ -0,0 +1,61 @@
+extends Node
+
+var npcs: Array[SimNPC] = []
+var tick_interval := 1.0
+var tick_timer := 0.0
+var tick_count := 0
+
+var names := [
+	"Rafi", "Mira", "Adem", "Nura", "Sahin",
+	"Lejla", "Tarik", "Hana", "Idris", "Zejd"
+]
+
+var professions := [
+	"farmer",
+	"woodcutter",
+	"guard",
+	"scholar",
+	"wanderer"
+]
+
+func _ready() -> void:
+	randomize()
+	generate_npcs()
+	print("--- Simulation started ---")
+
+func _process(delta: float) -> void:
+	tick_timer += delta
+
+	if tick_timer >= tick_interval:
+		tick_timer -= tick_interval
+		simulate_tick()
+
+func generate_npcs() -> void:
+	for i in range(10):
+		var npc := SimNPC.new(
+			i,
+			names[i],
+			professions.pick_random(),
+			randf_range(1.0, 10.0),
+			randf_range(1.0, 10.0)
+		)
+
+		npcs.append(npc)
+
+func simulate_tick() -> void:
+	tick_count += 1
+	print("--- Tick ", tick_count, " ---")
+
+	for npc in npcs:
+		npc.simulate_tick()
+		print(
+			npc.npc_name,
+			" | ",
+			npc.profession,
+			" | task: ",
+			npc.current_task,
+			" | hunger: ",
+			round(npc.hunger),
+			" | energy: ",
+			round(npc.energy)
+		)

simulation/SimulationManager.gd.uid

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