feat: 3D blobber dungeon generator (PR 1)

Replaces the 2D-only demo pipeline with a 3D cell-based blobber
generator. Per-cell face walls, per-material mesh emission, and a
GDExtension binding that returns a Dictionary with ArrayMesh surfaces
the demo consumes directly.

- src/blobber/: cell3d_t data model, dungeon container, pipeline that
  wraps the 2D generator per level and materializes into cell3d
- src/mesh/: face-quad emitter with per-material groups + .obj dump
- src/genesis3d_main.c: new CLI driving the blobber + mesh
- godot/: BrogueGen.generate_dungeon(seed, num_levels, depth) binding
  with dungeon_to_dict packing cells + mesh surfaces
- demo/: demo_blobber.tscn + dungeon_builder.gd, func_godot addon for
  the .map export path, point/entity templates, TrenchBroom docs
- Retired: old arcade/FPS demo scenes and their scripts, unused meshlib

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

demo/addons/func_godot/src/import/quake_map_file.gd

@@ -0,0 +1,14 @@
+@icon("res://addons/func_godot/icons/icon_quake_file.svg")
+class_name QuakeMapFile extends Resource
+## Map file that can be built by [FuncGodotMap].
+## 
+## Map file that can be built by a [FuncGodotMap]. Supports the Quake and Valve map formats.
+## 
+## @tutorial(Quake Wiki Map Format Article): https://quakewiki.org/wiki/Quake_Map_Format
+## @tutorial(Valve Developer Wiki VMF Article): https://developer.valvesoftware.com/wiki/VMF_(Valve_Map_Format)
+
+## Number of times this map file has been imported.
+@export var revision: int = 0
+
+## Raw map data.
+@export_multiline var map_data: String = ""

demo/addons/func_godot/src/import/quake_map_file.gd.uid

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

demo/addons/func_godot/src/import/quake_map_import_plugin.gd

@@ -0,0 +1,43 @@
+@tool
+class_name QuakeMapImportPlugin extends EditorImportPlugin
+
+func _get_importer_name() -> String:
+	return 'func_godot.map'
+
+func _get_visible_name() -> String:
+	return 'Quake Map'
+
+func _get_resource_type() -> String:
+	return 'Resource'
+
+func _get_recognized_extensions() -> PackedStringArray:
+	return PackedStringArray(['map','vmf'])
+	
+func _get_priority():
+	return 1.0
+
+func _get_save_extension() -> String:
+	return 'tres'
+
+func _get_import_options(path, preset):
+	return []
+
+func _get_preset_count() -> int:
+	return 0
+	
+func _get_import_order():
+	return 0
+
+func _import(source_file, save_path, options, r_platform_variants, r_gen_files) -> Error:
+	var save_path_str = '%s.%s' % [save_path, _get_save_extension()]
+
+	var map_resource : QuakeMapFile = null
+
+	if ResourceLoader.exists(save_path_str):
+		map_resource = load(save_path_str) as QuakeMapFile
+		map_resource.revision += 1
+	else:
+		map_resource = QuakeMapFile.new()
+	map_resource.map_data = FileAccess.open(source_file, FileAccess.READ).get_as_text()
+
+	return ResourceSaver.save(map_resource, save_path_str)

demo/addons/func_godot/src/import/quake_map_import_plugin.gd.uid

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

demo/addons/func_godot/src/import/quake_palette_file.gd

@@ -0,0 +1,14 @@
+@icon("res://addons/func_godot/icons/icon_quake_file.svg")
+class_name QuakePaletteFile extends Resource
+## Quake LMP palette format file used with [QuakeWadFile].
+##
+## Quake LMP palette format file used in conjunction with a Quake WAD2 format [QuakeWadFile]. 
+## Not required for the Valve WAD3 format.
+##
+## @tutorial(Quake Wiki Palette Article): https://quakewiki.org/wiki/Quake_palette#palette.lmp
+
+## Collection of [Color]s retrieved from the LMP palette file.
+@export var colors: PackedColorArray
+
+func _init(colors):
+	self.colors = colors

demo/addons/func_godot/src/import/quake_palette_file.gd.uid

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

demo/addons/func_godot/src/import/quake_palette_import_plugin.gd

@@ -0,0 +1,58 @@
+@tool
+class_name QuakePaletteImportPlugin extends EditorImportPlugin
+
+func _get_importer_name() -> String:
+	return 'func_godot.palette'
+
+func _get_visible_name() -> String:
+	return 'Quake Palette'
+
+func _get_resource_type() -> String:
+	return 'Resource'
+
+func _get_recognized_extensions() -> PackedStringArray:
+	return PackedStringArray(['lmp'])
+
+func _get_save_extension() -> String:
+	return 'tres'
+
+func _get_import_options(path, preset):
+	return []
+
+func _get_preset_count() -> int:
+	return 0
+
+func _get_priority():
+	return 1.0
+	
+func _get_import_order():
+	return 0
+
+func _import(source_file, save_path, options, r_platform_variants, r_gen_files) -> Error:
+	var save_path_str : String = '%s.%s' % [save_path, _get_save_extension()]
+	
+	var file = FileAccess.open(source_file, FileAccess.READ)
+	if file == null:
+		var err = FileAccess.get_open_error()
+		printerr(['Error opening super.lmp file: ', err])
+		return err
+
+	var colors := PackedColorArray()
+
+	while true:
+		var red : int = file.get_8()
+		var green : int = file.get_8()
+		var blue : int = file.get_8()
+		var color := Color(red / 255.0, green / 255.0, blue / 255.0)
+
+		colors.append(color)
+
+		if file.eof_reached():
+			break
+
+		if colors.size() == 256:
+			break
+
+	var palette_resource := QuakePaletteFile.new(colors)
+
+	return ResourceSaver.save(palette_resource, save_path_str)

demo/addons/func_godot/src/import/quake_palette_import_plugin.gd.uid

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

demo/addons/func_godot/src/import/quake_wad_file.gd

@@ -0,0 +1,14 @@
+@icon("res://addons/func_godot/icons/icon_quake_file.svg")
+class_name QuakeWadFile extends Resource
+## Texture container in the WAD2 or WAD3 format.
+##
+## Texture container in the Quake WAD2 or Valve WAD3 format. 
+##
+## @tutorial(Quake Wiki WAD Article): https://quakewiki.org/wiki/Texture_Wad
+## @tutorial(Valve Developer Wiki WAD3 Article): https://developer.valvesoftware.com/wiki/WAD
+
+## Collection of [ImageTexture] imported from the WAD file.
+@export var textures: Dictionary[String, ImageTexture]
+
+func _init(textures: Dictionary[String, ImageTexture] = {}):
+	self.textures = textures

demo/addons/func_godot/src/import/quake_wad_file.gd.uid

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

demo/addons/func_godot/src/import/quake_wad_import_plugin.gd

@@ -0,0 +1,209 @@
+@tool
+class_name QuakeWadImportPlugin extends EditorImportPlugin
+
+enum WadFormat {
+	Quake,
+	HalfLife
+}
+
+enum QuakeWadEntryType {
+	Palette = 0x40,
+	SBarPic = 0x42,
+	MipsTexture = 0x44,
+	ConsolePic = 0x45
+}
+
+enum HalfLifeWadEntryType {
+	QPic = 0x42,
+	MipsTexture = 0x43,
+	FixedFont = 0x45
+}
+
+const TEXTURE_NAME_LENGTH := 16
+const MAX_MIP_LEVELS := 4
+
+func _get_importer_name() -> String:
+	return 'func_godot.wad'
+
+func _get_visible_name() -> String:
+	return 'Quake WAD'
+
+func _get_resource_type() -> String:
+	return 'Resource'
+
+func _get_recognized_extensions() -> PackedStringArray:
+	return PackedStringArray(['wad'])
+
+func _get_save_extension() -> String:
+	return 'res'
+
+func _get_option_visibility(path: String, option_name: StringName, options: Dictionary) -> bool:
+	return true
+
+func _get_import_options(path, preset) -> Array[Dictionary]:
+	return [
+		{
+			'name': 'palette_file',
+			'default_value': 'res://addons/func_godot/palette.lmp',
+			'property_hint': PROPERTY_HINT_FILE,
+			'hint_string': '*.lmp'
+		},
+		{
+			'name': 'generate_mipmaps',
+			'default_value': true,
+			'property_hint': PROPERTY_HINT_NONE
+		}
+	]
+
+func _get_preset_count() -> int:
+	return 0
+	
+func _get_import_order() -> int:
+	return 0
+	
+func _get_priority() -> float:
+	return 1.0
+	
+func _import(source_file, save_path, options, r_platform_variants, r_gen_files) -> Error:
+	var save_path_str : String = '%s.%s' % [save_path, _get_save_extension()]
+
+	var file = FileAccess.open(source_file, FileAccess.READ)
+	if file == null:
+		var err = FileAccess.get_open_error()
+		printerr(['Error opening super.wad file: ', err])
+		return err
+	
+	# Read WAD header
+	var magic : PackedByteArray = file.get_buffer(4)
+	var magic_string : String = magic.get_string_from_ascii()
+	var wad_format: int = WadFormat.Quake
+	
+	if magic_string == 'WAD3':
+		wad_format = WadFormat.HalfLife
+	elif magic_string != 'WAD2':
+		printerr('Error: Invalid WAD magic')
+		return ERR_INVALID_DATA
+	
+	var palette_path : String = options['palette_file']
+	var palette_file : QuakePaletteFile = load(palette_path) as QuakePaletteFile
+	if wad_format == WadFormat.Quake and not palette_file:
+		printerr('Error: Invalid Quake palette file')
+		file.close()
+		return ERR_CANT_ACQUIRE_RESOURCE
+	
+	var num_entries : int = file.get_32()
+	var dir_offset : int = file.get_32()
+
+	# Read entry list
+	file.seek(0)
+	file.seek(dir_offset)
+
+	var entries : Array = []
+
+	for entry_idx in range(0, num_entries):
+		var offset : int = file.get_32()
+		var in_wad_size : int = file.get_32()
+		var size : int = file.get_32()
+		var type : int = file.get_8()
+		var compression : int = file.get_8()
+		var unknown : int = file.get_16()
+		var name : PackedByteArray = file.get_buffer(TEXTURE_NAME_LENGTH)
+		var name_string : String = name.get_string_from_ascii()
+		
+		if (wad_format == WadFormat.Quake and type == int(QuakeWadEntryType.MipsTexture)) or (
+			wad_format == WadFormat.HalfLife and type == int(HalfLifeWadEntryType.MipsTexture)):
+			entries.append([
+				offset,
+				in_wad_size,
+				size,
+				type,
+				compression,
+				name_string
+			])
+	
+	# Read mip textures
+	var texture_data_array: Array = []
+	for entry in entries:
+		var offset : int = entry[0]
+		file.seek(offset)
+		
+		var name : PackedByteArray = file.get_buffer(TEXTURE_NAME_LENGTH)
+		var name_string : String = name.get_string_from_ascii()
+		
+		var width : int = file.get_32()
+		var height : int = file.get_32()
+		
+		var mip_offsets : Array = []
+		for idx in range(0, MAX_MIP_LEVELS):
+			mip_offsets.append(file.get_32())
+		
+		var num_pixels : int = width * height
+		var pixels : PackedByteArray = file.get_buffer(num_pixels)
+		
+		if wad_format == WadFormat.Quake:
+			texture_data_array.append([name_string, width, height, pixels])
+			continue
+		# Half-Life WADs have a 256 color palette embedded in each texture
+		elif wad_format == WadFormat.HalfLife:
+			# Find the end of the mipmap data
+			file.seek(offset + mip_offsets[-1] + (width / 8) * (height / 8))
+			file.get_16()
+			
+			var palette_colors := PackedColorArray()
+			for idx in 256:
+				var red : int = file.get_8()
+				var green : int = file.get_8()
+				var blue : int = file.get_8()
+				var color := Color(red / 255.0, green / 255.0, blue / 255.0)
+				palette_colors.append(color)
+			
+			texture_data_array.append([name_string, width, height, pixels, palette_colors])
+	
+	# Create texture resources
+	var textures : Dictionary[String, ImageTexture] = {}
+	
+	for texture_data in texture_data_array:
+		var name : String = texture_data[0]
+		var width : int = texture_data[1]
+		var height : int = texture_data[2]
+		var pixels : PackedByteArray = texture_data[3]
+		
+		var texture_image : Image
+		var pixels_rgb := PackedByteArray()
+		
+		if wad_format == WadFormat.HalfLife:
+			var colors : PackedColorArray = texture_data[4]
+			for palette_color in pixels:
+				var rgb_color : Color = colors[palette_color]
+				pixels_rgb.append(rgb_color.r8)
+				pixels_rgb.append(rgb_color.g8)
+				pixels_rgb.append(rgb_color.b8)
+				# Color(0, 0, 255) is used for transparency in Half-Life
+				if rgb_color.b == 1 and rgb_color.r == 0 and rgb_color.b == 0:
+					pixels_rgb.append(0)
+				else:
+					pixels_rgb.append(255)
+			texture_image = Image.create_from_data(width, height, false, Image.FORMAT_RGBA8, pixels_rgb)
+		
+		else: # WadFormat.Quake
+			for palette_color in pixels:
+				var rgb_color : Color = palette_file.colors[palette_color]
+				pixels_rgb.append(rgb_color.r8)
+				pixels_rgb.append(rgb_color.g8)
+				pixels_rgb.append(rgb_color.b8)
+				# Palette index 255 is used for transparency
+				if palette_color != 255:
+					pixels_rgb.append(255)
+				else:
+					pixels_rgb.append(0)
+			texture_image = Image.create_from_data(width, height, false, Image.FORMAT_RGBA8, pixels_rgb)
+		
+		if options["generate_mipmaps"] == true:
+			texture_image.generate_mipmaps()
+		
+		var texture := ImageTexture.create_from_image(texture_image) #,Texture2D.FLAG_MIPMAPS | Texture2D.FLAG_REPEAT | Texture2D.FLAG_ANISOTROPIC_FILTER
+		textures[name.to_lower()] = texture
+	
+	# Save WAD resource
+	var wad_resource := QuakeWadFile.new(textures)
+	return ResourceSaver.save(wad_resource, save_path_str)

demo/addons/func_godot/src/import/quake_wad_import_plugin.gd.uid

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