建筑、区划与区域

#三层结构

4.x 的行星建设分三层，模组改动前先弄清楚你要改的是哪一层：

原版各自带有说明文件：districts/00_DOCUMENTATION.txt、zones/99_HOW_TO_ZONE.txt、zone_slots/99_HOW_TO_ZONE.txt、buildings/00_example.txt（后者注释写着“可能过时”）。

它们之间靠“集合”连接：

• 区划的 zone_slots = { ... } 列出它有哪些区域槽；
• 区域槽用 included_zone_sets / include 决定接受哪些区域；
• 区域用 zone_sets = { ... } 声明自己属于哪些区域集合，用 included_building_sets / include 决定接受哪些建筑；
• 建筑用 building_sets = { ... } 声明自己属于哪些建筑集合。

注意 buildings/00_example.txt 写明：除总督府邸（Overlord Holdings）和分部建筑（Branch Office）之外，每个建筑都必须属于至少一个建筑集合，否则任何区域都放不下它。区域同理，必须属于至少一个区域集合。

#区划

原版城市区划 district_city（common/districts/00_urban_districts.txt）开头：

district_city = {
	base_buildtime = 480

	exempt_from_ai_planet_specialization = yes
	default_starting_district = yes
	overlay_icon = GFX_district_government

	zone_slots = {
		slot_city_government
		slot_city_01
		slot_city_02
	}
	# ……potential、allow、convert_to 等
}

常用字段：

区划数量上限来自自动生成的修正，例如 district_mining_max_add、district_mining_max_mult（见 modifiers.log）。

#区域槽

原版 common/zone_slots/00_zone_slots.txt 的矿业槽：

slot_minerals = {
	included_zone_sets = {
		minerals
	}
	unlock = { # planet scope
		custom_tooltip = {
			fail_text = zone_unavailable_tech_mineral_purification_1
			exists = owner
			owner = {
				has_tech_or_functional_civic = {
					TECH = tech_mineral_purification_1
				}
			}
		}
	}
}

#区域

原版科研区域只有几行，主体放在 inline_script 里（common/zones/00_zones.txt）：

zone_research = {
	inline_script = {
		script = zones/shared_research_zone
		AMOUNT = @scaling_district_3_jobs
	}

	zone_sets = {
		urban
		polytechnic
	}

	inline_script = {
		script = zones/shared_city_non_urban_zone_modifiers
	}

	ai_weight_coefficient = 1.2
}

common/inline_scripts/zones/shared_research_zone.txt 里能看到真正的字段：icon、base_buildtime、potential、unlock、resources（category = planet_zones）、included_building_sets = { research urban_automation origin }，以及：

planet_modifier = {
	zone_building_slots_add = 3
}

区域独有的字段（据 zones/99_HOW_TO_ZONE.txt）：

#建筑

原版研究实验室（common/buildings/05_research_buildings.txt，省略了 potential 里给 AI 的限制）：

building_research_lab_1 = {
	can_build = yes
	base_buildtime = @b1_time
	category = research

	building_sets = {
		research
	}

	inline_script = {
		script = jobs/researchers_add
		AMOUNT = @building_static_jobs_3
	}

	resources = {
		category = planet_buildings
		cost = { minerals = @b1_minerals }   # 原版这里是一个 inline_script，按是否游牧切换资源
		upkeep = {
			energy = @b1_upkeep
		}
	}

	prerequisites = {
		"tech_basic_science_lab_1"
	}

	upgrades = {
		"building_research_lab_2"
	}
}

常用字段（据 buildings/00_example.txt）：

ai_weight 在 4.x 的建筑里基本不再使用，文档说明 AI 的建造决策由 common/economic_plans/ 驱动，除非你改掉经济计划。

#岗位从哪来

建筑、区划和区域本身不“声明”岗位，而是通过行星修正 job_<岗位>_add 添加。原版把这类修正收进 common/inline_scripts/jobs/ 下的脚本，AMOUNT 是岗位数。common/scripted_variables/100_scripted_variables_zones.txt 的注释说明：区划和区域的岗位数一般取 100 的倍数。岗位本身的定义见岗位与人口阶层。

#图标与本地化

• 建筑图标按键名读取 gfx/interface/icons/buildings/<建筑键>.dds（例如 building_research_lab_1.dds），原版没有为它们定义 sprite。
• 区划用 icon（不写时按区划名查找）和 overlay_icon（一个 GFX_ sprite）；区域用 icon = GFX_...。
• 本地化键都是 <键> 加 <键>_desc：building_research_lab_1、district_city、zone_research 等。

#在脚本里操作

触发器 has_building、num_buildings = { type = … value > 2 } 可用于检查，完整参数见 triggers.log。