babylon.config.defines.territory

Territorial substrate, topology, metabolism, carceral and infrastructure.

Spec 058: extracted from the historical babylon.config.defines monolith. Re-exported via babylon.config.defines.__init__; composed into GameDefines in babylon.config.defines._assembler.

Classes

CarceralDefines(**data)

Carceral equilibrium coefficients (Terminal Crisis Dynamics).

InfraTerrainDefines(**data)

Terrain classification and biocapacity coefficients (Feature 036).

InfrastructureDefines(**data)

Infrastructure capacity and internet operation coefficients (Feature 036).

MetabolismDefines(**data)

Metabolic rift coefficients (Slice 1.4 - Ecological Limits).

TerritoryDefines(**data)

Territory dynamics coefficients.

TopologyDefines(**data)

Phase transition coefficients for solidarity network analysis.
class babylon.config.defines.territory.CarceralDefines(**data)[source]

Bases: BaseModel

Carceral equilibrium coefficients (Terminal Crisis Dynamics).

The carceral system models the transition from wage suppression to outright incarceration as the imperial rent pool exhausts:

  1. SUPERWAGE_CRISIS: Rent pool can’t sustain LA wages

  2. CLASS_DECOMPOSITION: LA splits into enforcers + prisoners

  3. CONTROL_RATIO_CRISIS: Prisoners exceed control capacity

  4. TERMINAL_DECISION: Revolution vs genocide based on organization

Real-world staffing ratios (sources: BJS, Marshall Project 2024): - 1:1 = Maximum control (Massachusetts, best-staffed) - 4:1 = US national jail average (2022) - 15:1 = Federal DOJ theoretical baseline - 200:1 = Crisis/collapse (Georgia, 2024)

With 70/30 decomposition, prisoner/enforcer = 2.33:1, so: - control_capacity <= 2: Crisis triggers immediately - control_capacity >= 3: No crisis (stable carceral state)

Parameters:

  • control_capacity (int)

  • enforcer_fraction (float)

  • proletariat_fraction (float)

  • revolution_threshold (float)

  • decomposition_delay (int)

  • control_ratio_delay (int)

  • terminal_decision_delay (int)

model_config: ClassVar[ConfigDict] = {'frozen': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

control_capacity: int
enforcer_fraction: float
proletariat_fraction: float
revolution_threshold: float
decomposition_delay: int
control_ratio_delay: int
terminal_decision_delay: int
class babylon.config.defines.territory.InfraTerrainDefines(**data)[source]

Bases: BaseModel

Terrain classification and biocapacity coefficients (Feature 036).

Configures majority-coverage thresholds, initial biocapacity stock values, and per-tick depletion rates. Also includes internet access defaults.

See also

babylon.domain.geography.terrain: DefaultTerrainClassifier. specs/036-infrastructure-topology/spec.md: FR-001 through FR-008.

Parameters:

  • majority_coverage_threshold (float)

  • initial_freshwater (float)

  • initial_fishery (float)

  • initial_shipping_access (float)

  • initial_mineral (float)

  • initial_timber (float)

  • initial_hydroelectric (float)

  • depletion_freshwater (float)

  • depletion_fishery (float)

  • depletion_shipping_access (float)

  • depletion_mineral (float)

  • depletion_timber (float)

  • depletion_hydroelectric (float)

  • internet_access_threshold (float)

  • default_surveillance_coupling (float)

model_config: ClassVar[ConfigDict] = {'frozen': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

majority_coverage_threshold: float
initial_freshwater: float
initial_fishery: float
initial_shipping_access: float
initial_mineral: float
initial_timber: float
initial_hydroelectric: float
depletion_freshwater: float
depletion_fishery: float
depletion_shipping_access: float
depletion_mineral: float
depletion_timber: float
depletion_hydroelectric: float
internet_access_threshold: float
default_surveillance_coupling: float
get_initial_stock(stock_type)[source]

Get initial biocapacity stock value by type.

Parameters:

stock_type (str) – BiocapacityType value (lowercase).

Return type:

float

Returns:

Initial stock value.

Raises:

ValueError – If stock_type is not recognized.

get_depletion_rate(stock_type)[source]

Get per-tick depletion rate by stock type.

Parameters:

stock_type (str) – BiocapacityType value (lowercase).

Return type:

float

Returns:

Depletion rate per tick.

Raises:

ValueError – If stock_type is not recognized.

class babylon.config.defines.territory.InfrastructureDefines(**data)[source]

Bases: BaseModel

Infrastructure capacity and internet operation coefficients (Feature 036).

Configures per-type capacity values, natural capacity defaults, OPSEC tradeoff ratios, and internet throttle fractions.

See also

babylon.domain.geography.capacity: DefaultEdgeCapacityCalculator. specs/036-infrastructure-topology/spec.md: FR-009 through FR-029.

Parameters:

  • highway_freight (float)

  • highway_commuter (float)

  • highway_value (float)

  • highway_consciousness (float)

  • arterial_freight (float)

  • arterial_commuter (float)

  • arterial_value (float)

  • arterial_consciousness (float)

  • local_road_freight (float)

  • local_road_commuter (float)

  • local_road_value (float)

  • local_road_consciousness (float)

  • rail_freight (float)

  • rail_commuter (float)

  • rail_value (float)

  • rail_consciousness (float)

  • pipeline_energy (float)

  • transmission_energy (float)

  • shipping_lane_freight (float)

  • air_link_freight (float)

  • air_link_commuter (float)

  • air_link_value (float)

  • air_link_consciousness (float)

  • natural_capacity_coefficient (float)

  • minimum_capacity_threshold (float)

  • opsec_tradeoff_ratio (float)

  • throttle_throughput_fraction (float)

  • snap_buffer_fraction (float)

  • local_ratio_threshold (float)

  • semi_local_ratio_threshold (float)

model_config: ClassVar[ConfigDict] = {'frozen': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

highway_freight: float
highway_commuter: float
highway_value: float
highway_consciousness: float
arterial_freight: float
arterial_commuter: float
arterial_value: float
arterial_consciousness: float
local_road_freight: float
local_road_commuter: float
local_road_value: float
local_road_consciousness: float
rail_freight: float
rail_commuter: float
rail_value: float
rail_consciousness: float
pipeline_energy: float
transmission_energy: float
shipping_lane_freight: float
natural_capacity_coefficient: float
minimum_capacity_threshold: float
opsec_tradeoff_ratio: float
throttle_throughput_fraction: float
snap_buffer_fraction: float
local_ratio_threshold: float
semi_local_ratio_threshold: float
get_capacity(infra_type, flow_category)[source]

Get base capacity for an infrastructure type and flow category.

Parameters:

  • infra_type (str) – InfrastructureType value (lowercase).

  • flow_category (str) – FlowCategory value (lowercase).

Return type:

float

Returns:

Base capacity value, or 0.0 if combination not applicable.

class babylon.config.defines.territory.MetabolismDefines(**data)[source]

Bases: BaseModel

Metabolic rift coefficients (Slice 1.4 - Ecological Limits).

The Metabolism System tracks the widening rift between extraction and regeneration: - Biocapacity regeneration and depletion - ECOLOGICAL_OVERSHOOT event when consumption exceeds biocapacity

Parameters:

  • entropy_factor (float)

  • overshoot_threshold (float)

  • max_overshoot_ratio (float)

model_config: ClassVar[ConfigDict] = {'frozen': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

entropy_factor: float
overshoot_threshold: float
max_overshoot_ratio: float
class babylon.config.defines.territory.TerritoryDefines(**data)[source]

Bases: BaseModel

Territory dynamics coefficients.

Parameters:

  • heat_decay_rate (float)

  • high_profile_heat_gain (float)

  • eviction_heat_threshold (float)

  • rent_spike_multiplier (float)

  • displacement_rate (float)

  • heat_spillover_rate (float)

  • clarity_profile_coefficient (float)

  • concentration_camp_decay_rate (float)

  • displacement_priority_mode (str)

  • elimination_rent_threshold (float)

  • elimination_tension_threshold (float)

  • containment_rent_threshold (float)

  • containment_tension_threshold (float)

  • initial_biocapacity_per_hex (float)

  • initial_energy_per_hex (float)

  • initial_raw_material_per_hex (float)

  • initial_internet_access_pct (float)

  • initial_surveillance_coupling (float)

model_config: ClassVar[ConfigDict] = {'frozen': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

heat_decay_rate: float
high_profile_heat_gain: float
eviction_heat_threshold: float
rent_spike_multiplier: float
displacement_rate: float
heat_spillover_rate: float
clarity_profile_coefficient: float
concentration_camp_decay_rate: float
displacement_priority_mode: str
elimination_rent_threshold: float
elimination_tension_threshold: float
containment_rent_threshold: float
containment_tension_threshold: float
initial_biocapacity_per_hex: float
initial_energy_per_hex: float
initial_raw_material_per_hex: float
initial_internet_access_pct: float
initial_surveillance_coupling: float
class babylon.config.defines.territory.TopologyDefines(**data)[source]

Bases: BaseModel

Phase transition coefficients for solidarity network analysis.

The topology system tracks phase transitions in class solidarity: - Gaseous: Atomized, no collective action capacity - Transitional: Solidarity building, weak ties forming - Liquid: Mass movement (percolation but low cadre density) - Solid: Vanguard party (percolation with high cadre density)

Parameters:

  • gaseous_threshold (float)

  • condensation_threshold (float)

  • vanguard_density_threshold (float)

  • brittle_multiplier (float)

  • solidarity_sympathizer_threshold (float)

  • solidarity_cadre_threshold (float)

  • resilience_removal_rate (float)

  • resilience_survival_threshold (float)

model_config: ClassVar[ConfigDict] = {'frozen': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

gaseous_threshold: float
condensation_threshold: float
vanguard_density_threshold: float
brittle_multiplier: float
solidarity_sympathizer_threshold: float
solidarity_cadre_threshold: float
resilience_removal_rate: float
resilience_survival_threshold: float