babylon.models.entities.trigger

Trigger model for event conditions.

A Trigger defines conditions that can cause events to occur. Triggers are the connection between game state and event generation.

This replaces the old dataclass in data/models/trigger.py.

Design note: The old Trigger used a Callable for the condition, which cannot be serialized. This version uses a declarative condition specification that can be evaluated and serialized.

Classes

`Trigger`(**data)	A condition that can trigger game events.
`TriggerCondition`(**data)	A single condition that can be evaluated against game state.

class babylon.models.entities.trigger.TriggerCondition(**data)[source]

Bases: BaseModel

A single condition that can be evaluated against game state.

Conditions specify what to check, how to compare, and what threshold to use. Multiple conditions can be combined in a Trigger.

Parameters:

path (str)
operator (Literal['>=', '<=', '>', '<', '==', '!='])
threshold (float)
description (str)

path: Dot-notation path to the value in game state (e.g., “economy.gini_coefficient”)

operator: Comparison operator

threshold: Value to compare against

description: Human-readable explanation

path: str

operator: Literal['>=', '<=', '>', '<', '==', '!=']

threshold: float

description: str

model_config: ClassVar[ConfigDict] = {'extra': 'forbid'}: Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

evaluate(game_state)[source]

Evaluate this condition against the game state.

Parameters:: game_state (dict[str, Any]) – The current game state dictionary
Return type:: bool
Returns:: True if the condition is met, False otherwise

class babylon.models.entities.trigger.Trigger(**data)[source]

Bases: BaseModel

A condition that can trigger game events.

Triggers define when events should occur based on game state. They can have multiple conditions that must all be met (AND logic) or any one met (OR logic).

Parameters:

id (str)
description (str)
trigger_type (str | None)
conditions (list[TriggerCondition])
logic (Literal['all', 'any'])
parameters (dict[str, Any])
cooldown_turns (Annotated[int, Ge(ge=0)])
last_triggered_turn (int | None)

id: Unique identifier

description: Human-readable description

trigger_type: Category of trigger (economic, political, social, etc.)

conditions: List of conditions to evaluate

logic: How to combine conditions (all must pass or any must pass)

parameters: Optional parameters for condition evaluation

cooldown_turns: Minimum turns between activations (0 = no cooldown)

last_triggered_turn: Turn when this was last triggered

id: str

description: str

trigger_type: str | None

conditions: list[TriggerCondition]

logic: Literal['all', 'any']

parameters: dict[str, Any]

cooldown_turns: int

last_triggered_turn: int | None

model_config: ClassVar[ConfigDict] = {'extra': 'forbid'}: Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

evaluate(game_state, current_turn=0)[source]

Evaluate if the trigger condition is met.

Parameters:

game_state (dict[str, Any]) – The current game state to evaluate against
current_turn (int) – The current turn number (for cooldown checking)

Return type:

bool

Returns:

True if the trigger condition is met, False otherwise

mark_triggered(current_turn)[source]

Mark this trigger as having been triggered.

Parameters:: current_turn (int) – The current turn number
Return type:: None