class_name WorldBuilder ## Procedurally assembles a minimal Hollywood Boulevard entrance prototype: const T_BRICK := preload("res://assets/textures/ai/game_ready/brick_facade.png") const T_CONCRETE := preload("res://assets/textures/ai/game_ready/concrete.png") const T_ASPHALT := preload("res://assets/textures/ai/game_ready/asphalt.png") const T_AWNING := preload("res://assets/textures/ai/game_ready/awning.png") const T_SKYLINE := preload("res://assets/textures/skyline.png") ## steps, building facade, restricted door, sidewalk, pavement, and street edge. ## No art assets required; all geometry is BoxMesh with flat materials. var root: Node3D = null ## Door lock indicator mesh near the handle; toggled by GameManager. var door_indicator: MeshInstance3D = null var _door_indicator_mat: StandardMaterial3D = null ## Street lamps and signage so night mode can switch them on. var _street_lamps: Array[MeshInstance3D] = [] var _lamp_omni: Array[OmniLight3D] = [] var _lamp_bulb_mats: Array[StandardMaterial3D] = [] var marquee_label: Label3D = null var _marquee_emissive: Array[StandardMaterial3D] = [] func _init(root_node: Node3D) -> void: root = root_node func build() -> void: _build_ground() _build_building() _build_skyline_backdrop() _build_marquee() _build_steps() _build_sidewalk() _build_street() _build_crosswalk() _build_street_furniture() _build_guard_spawn() _build_navmesh() set_night_mode(false) func _add_box(parent: Node3D, size: Vector3, pos: Vector3, color: Color, cast_shadow: bool = false, texture: Texture2D = null, uv_scale: Vector2 = Vector2(1, 1)) -> MeshInstance3D: var mesh := BoxMesh.new() mesh.size = size var mat := StandardMaterial3D.new() mat.albedo_color = color if texture: mat.albedo_texture = texture mat.uv1_scale = Vector3(uv_scale.x, uv_scale.y, 1.0) mesh.material = mat var mi := MeshInstance3D.new() mi.mesh = mesh mi.position = pos mi.cast_shadow = (1 if cast_shadow else 0) as GeometryInstance3D.ShadowCastingSetting parent.add_child(mi) return mi func _build_ground() -> void: var ground := StaticBody3D.new() ground.name = "Ground" # Large enough that the ground meets the distant skyline ring (no gap of sky # under the buildings when looking down the boulevard). _add_box(root, Vector3(500, 0.5, 500), Vector3(0, -0.25, 20), Color(0.22, 0.24, 0.26)) var col := BoxShape3D.new() col.size = Vector3(500, 1, 500) var shape_owner := ground.create_shape_owner(ground) ground.shape_owner_add_shape(shape_owner, col) root.add_child(ground) func _build_building() -> void: var building := StaticBody3D.new() building.name = "Building" # Main facade (textured brick) _add_box(building, Vector3(40, 18, 4), Vector3(0, 9, -6), Color(0.85, 0.8, 0.78), false, T_BRICK, Vector2(10, 5)) # Entrance recess + door recess frame _add_box(building, Vector3(5.4, 6.4, 0.2), Vector3(0, 3.2, -3.9), Color(0.08, 0.08, 0.09)) # Door frame and dark door _add_box(building, Vector3(3.0, 5.2, 0.3), Vector3(0, 2.9, -3.98), Color(0.13, 0.12, 0.11)) # Door glass (semi-transparent) var glass := _add_box(building, Vector3(1.8, 1.4, 0.34), Vector3(0, 3.8, -3.9), Color(0.6, 0.75, 0.9, 0.55)) var glass_mat := StandardMaterial3D.new() glass_mat.albedo_color = Color(0.6, 0.75, 0.9, 0.45) glass_mat.transparency = BaseMaterial3D.TRANSPARENCY_ALPHA glass_mat.roughness = 0.15 glass_mat.metallic = 0.1 glass.material_override = glass_mat # Door lock indicator (green = open, red = locked), placed beside the handle door_indicator = _add_box(building, Vector3(0.18, 0.18, 0.24), Vector3(-1.8, 1.7, -3.82), Color(0.1, 0.9, 0.3)) door_indicator.material_override = _lock_indicator_material(Color(0.1, 0.9, 0.3)) var col := BoxShape3D.new() col.size = Vector3(40, 18, 4) var so := building.create_shape_owner(building) building.shape_owner_add_shape(so, col) building.shape_owner_set_transform(so, Transform3D(Basis(), Vector3(0, 9, -6))) root.add_child(building) func _build_steps() -> void: # Steps have collision so NPCs and the guard can walk up the entrance. # The ground and building provide the actual collision boundaries. var steps := StaticBody3D.new() steps.name = "Steps" var step_w := 8.0 var tread := 0.6 var height := 0.16 for i in 4: var y: float = i * height var z: float = 4.0 * tread - i * tread var w: float = step_w - i * 0.35 _add_box(steps, Vector3(w, height, tread), Vector3(0, y + height / 2.0, z), Color(0.55, 0.52, 0.5)) # Add collision shape to each tread var tread_col := BoxShape3D.new() tread_col.size = Vector3(w, height, tread) var owner_id := steps.create_shape_owner(steps) steps.shape_owner_add_shape(owner_id, tread_col) steps.shape_owner_set_transform(owner_id, Transform3D(Basis(), Vector3(0, y + height / 2.0, z))) # Landing at the top with collision var landing_y: float = 4 * height + 0.1 _add_box(steps, Vector3(9, 0.2, 3), Vector3(0, landing_y, -1.5), Color(0.5, 0.47, 0.45)) var landing_col := BoxShape3D.new() landing_col.size = Vector3(9, 0.2, 3) var landing_owner := steps.create_shape_owner(steps) steps.shape_owner_add_shape(landing_owner, landing_col) steps.shape_owner_set_transform(landing_owner, Transform3D(Basis(), Vector3(0, landing_y, -1.5))) root.add_child(steps) func _build_sidewalk() -> void: var sidewalk := StaticBody3D.new() sidewalk.name = "Sidewalk" _add_box(sidewalk, Vector3(30, 0.18, 8), Vector3(0, 0.09, 8), Color(1, 1, 1), false, T_CONCRETE, Vector2(9, 2.4)) var col := BoxShape3D.new() col.size = Vector3(30, 0.36, 8) var so := sidewalk.create_shape_owner(sidewalk) sidewalk.shape_owner_add_shape(so, col) sidewalk.shape_owner_set_transform(so, Transform3D(Basis(), Vector3(0, 0, 8))) root.add_child(sidewalk) func _build_street() -> void: var street := StaticBody3D.new() street.name = "Street" _add_box(street, Vector3(120, 0.1, 26), Vector3(0, 0.05, 22), Color(1, 1, 1), false, T_ASPHALT, Vector2(30, 7)) # Center dashes for i in range(-40, 41, 4): _add_box(street, Vector3(0.2, 0.02, 1.2), Vector3(i * 0.0, 0.11, 22), Color(0.85, 0.85, 0.30)) var col := BoxShape3D.new() col.size = Vector3(120, 0.2, 26) var so := street.create_shape_owner(street) street.shape_owner_add_shape(so, col) street.shape_owner_set_transform(so, Transform3D(Basis(), Vector3(0, 0, 22))) root.add_child(street) func _build_navmesh() -> void: ## Flat navigation mesh over the walkable floor: landing strip, sidewalk, ## and street front. Hand-authored polygons; no runtime bake needed. var region := NavigationRegion3D.new() region.name = "NavRegion" var mesh := NavigationMesh.new() mesh.agent_radius = 0.4 mesh.agent_max_climb = 0.8 mesh.agent_max_slope = 45.0 mesh.cell_size = 0.25 var verts := PackedVector3Array([ Vector3(-18, 0.0, -0.6), Vector3(18, 0.0, -0.6), Vector3(18, 0.0, 20.0), Vector3(-18, 0.0, 20.0), ]) mesh.set_vertices(verts) mesh.add_polygon(PackedInt32Array([0, 1, 2, 3])) region.navigation_mesh = mesh root.add_child(region) func _build_skyline_backdrop() -> void: ## Distant skyline surrounding the block. The texture's sky is transparent ## (alpha scissor), so only building silhouettes show. Four planes form a ## ring: a single plane placed behind the building reads as a floating black ## band from the sidewalk. var backdrop := Node3D.new() backdrop.name = "SkylineBackdrop" var mat := StandardMaterial3D.new() mat.albedo_texture = T_SKYLINE mat.texture_repeat = true mat.uv1_scale = Vector3(3.0, 1.0, 1.0) mat.transparency = BaseMaterial3D.TRANSPARENCY_ALPHA_SCISSOR mat.alpha_scissor_threshold = 0.5 mat.shading_mode = BaseMaterial3D.SHADING_MODE_UNSHADED mat.cull_mode = BaseMaterial3D.CULL_DISABLED # Unshaded silhouettes read as pure black at 255-scale; lift the albedo so the # distant skyline sits closer to a hazy daytime city. mat.albedo_color = Color(2.6, 2.7, 3.0, 1.0) _skyline_mat = mat var mesh := PlaneMesh.new() # PlaneMesh defaults to a horizontal (XZ) plane; the skyline must stand up. mesh.orientation = PlaneMesh.FACE_Z mesh.size = Vector2(400, 60) # Far enough that the skyline reads as background and its top edge stays out # of the middle of the sky. const DIST := 200.0 # The texture keeps its buildings in the lower part of the image, so the plane # center sits at half its height: the building bases meet the ground. const CENTER_Y := 30.0 var placements := [ [Vector3(0, CENTER_Y, -DIST), 0.0], [Vector3(0, CENTER_Y, DIST), 0.0], [Vector3(-DIST, CENTER_Y, 0), PI / 2.0], [Vector3(DIST, CENTER_Y, 0), PI / 2.0], ] for placement in placements: var plane := MeshInstance3D.new() plane.mesh = mesh plane.material_override = mat plane.cast_shadow = GeometryInstance3D.SHADOW_CASTING_SETTING_OFF plane.position = placement[0] plane.rotation.y = placement[1] backdrop.add_child(plane) root.add_child(backdrop) var _skyline_mat: StandardMaterial3D = null func _build_marquee() -> void: ## Striped awning above the door, then the neon sign strip + label. var awning := _add_box(root, Vector3(10.5, 0.08, 1.8), Vector3(0, 6.55, -3.7), Color(1, 1, 1), false, T_AWNING) awning.name = "Awning" ## Neon-style marquee strip above the door: emissive bars + a label. var strip_parent := Node3D.new() strip_parent.name = "Marquee" for offset in [-2.2, 2.2]: var bar := _add_box(strip_parent, Vector3(0.25, 0.5, 0.5), Vector3(offset, 7.4, -3.6), Color(1, 0.35, 0.75)) var mat := _emissive_material(Color(1.0, 0.35, 0.75)) bar.material_override = mat _marquee_emissive.append(mat) marquee_label = Label3D.new() marquee_label.name = "MarqueeLabel" marquee_label.text = "STEP LINE" marquee_label.position = Vector3(0, 7.3, -3.55) marquee_label.modulate = Color(1, 0.6, 0.9) marquee_label.font_size = 160 marquee_label.pixel_size = 0.004 marquee_label.outline_size = 24 marquee_label.outline_modulate = Color(0.9, 0.15, 0.5) marquee_label.billboard = BaseMaterial3D.BILLBOARD_ENABLED marquee_label.no_depth_test = false strip_parent.add_child(marquee_label) root.add_child(strip_parent) func _build_street_furniture() -> void: # Street lamps along the sidewalk (bulbs + omni lights, off by day). for side in [-7.5, 7.5]: var lamp := Node3D.new() lamp.name = "Lamp_%d" % int(side) _add_box(lamp, Vector3(0.22, 5.0, 0.22), Vector3(side, 2.5, 8.5), Color(0.16, 0.16, 0.18)) _add_box(lamp, Vector3(1.6, 0.15, 0.15), Vector3(side + (0.8 if side < 0 else -0.8), 4.9, 8.5), Color(0.16, 0.16, 0.18)) var bulb := _add_box(lamp, Vector3(0.16, 0.16, 0.5), Vector3(side + (0.8 if side < 0 else -0.8), 4.85, 8.5), Color(1, 1, 0.85)) var bulb_mat := _emissive_material(Color(1.0, 1.0, 0.8)) bulb.material_override = bulb_mat bulb.material_override.emission_energy_multiplier = 1.5 _lamp_bulb_mats.append(bulb_mat) var omni := OmniLight3D.new() omni.position = Vector3(side + (0.8 if side < 0 else -0.8), 4.7, 8.5) omni.omni_range = 14.0 omni.light_energy = 0.0 omni.light_color = Color(1, 0.93, 0.75) lamp.add_child(omni) _lamp_omni.append(omni) root.add_child(lamp) _street_lamps.append(bulb) # Planters beside the steps. for side in [-4.6, 4.6]: var planter := _add_box(root, Vector3(1.1, 0.7, 1.1), Vector3(side, 0.35, 1.0), Color(0.42, 0.34, 0.28)) planter.name = "Planter_%d" % int(side) # Low-poly trees along the street front. var trunk_color := Color(0.35, 0.25, 0.18) var leaf_color := Color(0.16, 0.42, 0.2) # Flank the walkway; keep the sight line to the door clear. for i in 6: var side := -1.0 if i % 2 == 0 else 1.0 var x := side * (6.5 + float(int(i / 2)) * 3.0) var z := 4.0 + float((i * 7) % 5) var tree := Node3D.new() tree.name = "Tree_%d" % (i + 1) var trunk := MeshInstance3D.new() var trunk_mesh := CylinderMesh.new() trunk_mesh.top_radius = 0.09 trunk_mesh.bottom_radius = 0.14 trunk_mesh.height = 1.4 trunk.mesh = trunk_mesh trunk.material_override = _plain_material(trunk_color) trunk.position = Vector3(x, 0.7, z) tree.add_child(trunk) var crown := MeshInstance3D.new() var crown_mesh := CylinderMesh.new() crown_mesh.top_radius = 0.05 crown_mesh.bottom_radius = 0.85 crown_mesh.height = 2.2 crown.mesh = crown_mesh crown.material_override = _plain_material(leaf_color) crown.position = Vector3(x, 2.1, z) tree.add_child(crown) root.add_child(tree) func _build_crosswalk() -> void: # White crosswalk stripes in front of the entrance on the street. for i in 8: _add_box(root, Vector3(0.8, 0.02, 0.5), Vector3(-2.8 + i * 0.85, 0.11, 17.0), Color(0.92, 0.92, 0.92)) _add_box(root, Vector3(0.8, 0.02, 0.5), Vector3(-2.8 + i * 0.85, 0.11, 19.0), Color(0.92, 0.92, 0.92)) ## Switch street lamps and signage to night mode (emissive + lights on). func set_night_mode(night: bool) -> void: for mat in _lamp_bulb_mats: mat.emission_energy_multiplier = (2.0 if night else 0.0) for omni in _lamp_omni: omni.light_energy = (3.0 if night else 0.0) for mat in _marquee_emissive: mat.emission_energy_multiplier = (2.0 if night else 0.2) if marquee_label: marquee_label.modulate.a = (1.0 if night else 0.9) func _emissive_material(color: Color) -> StandardMaterial3D: var mat := StandardMaterial3D.new() mat.albedo_color = color mat.emission_enabled = true mat.emission = color mat.emission_energy_multiplier = 1.0 return mat func _plain_material(color: Color) -> StandardMaterial3D: var mat := StandardMaterial3D.new() mat.albedo_color = color return mat func _build_guard_spawn() -> void: var marker := Marker3D.new() marker.name = "GuardSpawn" # Guard spawns on the landing at the top of the steps, facing the street. # The landing is at y=4*height+0.1 where height=0.16, so y=0.76 # The guard's head offset is 1.6m, so spawn at y=0.76-1.6=-0.84 to place feet on ground # But we want the guard at eye-level with the sidewalk, so adjust to y=0.1 for feet # Then the head will be at y=1.7 (1.6 offset + 0.1 base) marker.position = Vector3(0, 0.1, -2.0) root.add_child(marker) func _lock_indicator_material(color: Color) -> StandardMaterial3D: var mat := StandardMaterial3D.new() mat.albedo_color = color mat.emission_enabled = true mat.emission = color mat.emission_energy_multiplier = 1.5 return mat ## Mirror the door lock state visually (green open, red locked). func set_door_locked(locked: bool) -> void: if door_indicator == null: return var color := Color(0.9, 0.15, 0.15) if locked else Color(0.1, 0.9, 0.3) if door_indicator.material_override is StandardMaterial3D: (door_indicator.material_override as StandardMaterial3D).albedo_color = color (door_indicator.material_override as StandardMaterial3D).emission = color