Mordfield Definition Language (MDL) Specification

1. Overview

The Mordfield Definition Language (MDL) is a JSON-based scripting system used to define campaign missions, events, and behaviors in Mordfield.

MDL files are parsed at mission load and control:

Starting resources
Unit restrictions
Persistent and temporary modifiers
Quest objectives
Triggers and scripted sequences
Failure and success conditions

2. Top-Level Structure

Each MDL file is a JSON object with the following main fields:

{
  "experienceModifier": 1.0, // Global XP multiplier for mission rewards.
  "resourcePacks": { },      // Starting resources available to the player.
  "flags": [ ],              // Mission-specific integer flags.
  "permanentUnitMods": [ ],  // Permanent adjustments to units.
  "startingUnitMods": [ ],   // Temporary mods applied at mission start.
  "disabledUnits": [ ],      // Units disallowed during the mission.
  "enabledUnits": [ ],       // Units explicitly allowed.
  "failureModes": [ ],       // Mission failure conditions.
  "quests": [ ],             // Objectives shown to the player.
  "triggers": [ ],           // Event-driven logic blocks.
  "init": [ ]                // Ordered actions run once after mission loads.
}

3. Flags

Flags are mission-scoped integer variables. They can be incremented, decremented, or checked in conditions.

Supported comparisons: equal, lessThan, greaterThan.

4. Unit Modifiers

Permanent Unit Mods

Apply globally and persist across the mission.

{ "type": "UNIT_COST", "player": "PLAYER", "unitTypes": ["OUTPOST"], "PRODUCTION": 10 }

Starting Unit Mods

Applied at mission start.

{ "type": "TURRET_STRATEGY", "player": "PLAYER", "radius": 5 }

5. Quests

Quests define objectives shown to the player.

{ "title": "Build a Scrapyard.", "icon": "SCRAPYARD" }

6. Triggers

Triggers are event-driven logic. Each trigger watches for a condition (type) and executes actions.

This section precisely documents which trigger keys are honored per TriggerType, what value types/selectors they accept, and how the engine evaluates them, based on the Operation/Trigger implementation you shared.

A. Common trigger shape & mechanics

Available keys (MDL → engine Trigger fields):

Key	Type	Default / Meaning
`type`	`TriggerType`	Required. Event source (see per-type rules below).
`position`	`Vector2i` (or selector)	`INVALID_POSITION` by default. When set, used with `radius` to gate by location; semantics vary per type.
`radius`	`int`	`-1` means “disabled”. Engine uses `max(0, radius)` in most checks.
`unit`	`UnitId` (or selector)	Matches a specific unit (source/target depending on type).
`unitType`	`UnitType`	Matches by unit class (source/target depending on type).
`player`	`Player`	Matches the player involved (owner of the relevant unit, or the evented player).
`apAuraType`	`ActionPoint.AuraType`	Only honored by `AP_BOOST`. `NONE` acts as wildcard.
`maxTriggerCount`	`int`	Defaults to `1`. After firing `maxTriggerCount` times, the trigger auto-removes unless `keepTrigger` is set by the callback.
(internal) `id`, `triggerCount`	—	Engine bookkeeping (not MDL inputs).

Execution & lifetime:

Triggers are stored in _triggers. When the relevant engine signal fires, each trigger is tested; matches run callback.
triggerCount increments per fire. If triggerCount >= maxTriggerCount and the callback did not set keepTrigger = true, the trigger is removed.
Re-entrancy is guarded (currentlyExecuting).
type: NONE runs immediately upon addTrigger and is not stored (one-shot).

B. Per-type key support & evaluation

Legend: Honored keys = the keys that affect matching for that TriggerType.

1) `OCCUPY_TILE`

Honored keys: unit, unitType, player, position, radius, maxTriggerCount
Fires when:

A unit moves successfully (Action.Move.wasSuccessful) or a unit is added to the map (spawn/complete) — the engine checks both sources.
Filters:
- If unit is set, only that exact unit qualifies.
- Else if unitType is set, the moving/spawned unit must match.
- If player is set, the unit’s owner must match.
- Area test: distance between the unit’s position and position must be ≤ max(0, radius).
  - If position is not set (INVALID_POSITION) during unit-added path, the engine compares the unit’s position to itself (distance = 0) which always passes.
  - During move path, position must be set or the radius check uses an invalid center (set position in MDL).

Notes: Use visionIsRequired in your higher-level action logic if needed; the trigger itself does not check FOW.

2) `UNIT_DEATH`

Honored keys: unit, unitType, player, position, radius, maxTriggerCount
Fires when: any unit dies, and:

unitType is NONE or equals the dead unit’s type.
player is unset or equals the dead unit’s owner.
unit is unset or equals the exact dead unit.
If both position != INVALID and radius >= 0, the dead unit must be within radius of position.

3) `ALL_UNITS_DEAD`

Honored keys: player, maxTriggerCount
Fires when: gameState.unitEngine.hasUnits(player) is false.

4) `ALL_BUILDINGS_DEAD`

Honored keys: player, maxTriggerCount
Fires when: gameState.unitEngine.hasBuildings(player) is false.

5) `ALL_CITIES_DEAD`

Honored keys: player, maxTriggerCount
Fires when: The player has no CITY units and no ROVER units.

6) `RECEIVED_DAMAGE`

Honored keys: unit, unitType, position, radius, maxTriggerCount
Fires when: A DamageAction succeeds, and for each target (UnitEcho) in damageAction.targetUnits:

unitType is NONE or equals the target’s prototype unit type.
unit is unset or equals the exact target unit.
If radius >= 0, the target’s current position must be within radius of position.

7) `ATTACK`

Honored keys: unit, position, radius, maxTriggerCount
Fires when: A DamageAction succeeds, and:

unit is unset or equals the attacker (damageAction.sourceUnit).
position/radius gate by the attack’s target tile position:
distance(position, damageAction.targetPosition) ≤ max(0, radius).

Notes: unitType is not consulted for the attacker; use explicit unit or an ATTACK near area filter.

8) `UNIT_COMPLETED`

Honored keys: unit, unitType, player, position, radius, maxTriggerCount
Fires when: A unit is added to the map (i.e., construction finished / warp-in / spawn), and:

unitType is NONE or equals the new unit’s type.
unit is unset or equals the new unit object.
player is unset or equals the unit owner.
Area test: distance between the unit’s position and position ≤ max(0, radius).
If position is unset (INVALID_POSITION), the check compares the unit’s position to itself (distance 0) → always passes.

9) `TILE_REVEALED`

Honored keys: player, position or unit, maxTriggerCount
Fires when: The specified player’s fog engine reports a visibility change and:

If unit is set: tests isTileVisible(unit.position).
Else: tests isTileVisible(position).

Notes: radius is ignored for this type.

10) `AP_BOOST`

Honored keys: apAuraType, unit, unitType, maxTriggerCount
Fires when: Action Points are applied (OnActionPointApplied) and for each affected unit:

apAuraType is NONE (wildcard) or equals aura.type.
If unit is set and equals that unit → fire.
Else if unitType is NONE or equals the unit’s type → fire.

11) `TILE_DESTROYED`

Honored keys: position, maxTriggerCount
Fires when: A tile evolves (e.g., via damage) and its position equals position.

Notes: No radius; exact tile match only.

12) `PLAYER_DEATH`

Honored keys: player, maxTriggerCount
Fires when: World.OnPlayerDeath for the specified player.

13) `PERK_UNLOCKED`

Honored keys: player, maxTriggerCount
Fires when: OnSciencePerkUnlocked(player, sciencePerk) for the specified player.

Callback params: sciencePerk is populated.

14) `RESOURCE_COLLECTED`

Honored keys: player, unit, unitType, position, radius, maxTriggerCount
Fires when: OnResourceGenerated(unit, resourceType, amount) runs and:

player is unset or equals unit.player.
unit is unset or equals the producing unit.
unitType is NONE or equals the producing unit’s type.
If position is set: producing unit must be within radius of position (with radius < 0 treated effectively as infinite).

Callback params: resourceType, amount, plus unit, unitType, player.

Also fired indirectly from scrap collection: Scrap types (except NONE) are mapped to resourceType and routed through this same flow.

15) `SCRAP_COLLECTED`

Honored keys: player, unit, unitType, position, radius, maxTriggerCount
Fires when: OnScrapCollected(unit, scrapType, amount) where:

Same unit/player/area filters as RESOURCE_COLLECTED.
Callback params use scrapType and amount.

16) `UNIT_QUEUED`

Honored keys: player, unit, unitType, position, radius, maxTriggerCount
Fires when: A unit is queued/built by a building:

Triggered from OnBuildingUnitBuilt and OnUnitQueued.
Filters:
- player matches the actor player.
- unit matches the receiving unit (if present; for OnUnitQueued it may be null in the event).
- unitType matches the prototype’s unitType (the type being produced).
- If position is set: compares unit position (when available) with position against radius (with <0 treated as infinite).

Callback params: unitType is set from the prototype being queued/built. unit may be the building/receiving unit when available.

C. Special cases & tips

Immediate triggers: type: NONE executes at registration time and never persists.
Keeping a trigger alive: In your trigger’s actions (MDL layer), you may set keepTrigger = true via the MDL runtime’s wrapper when you need a trigger to survive beyond maxTriggerCount firings (e.g., loops). If you rely purely on data, set a larger maxTriggerCount.
Area checks & defaults: Many types only run the area check if both position is set and radius >= 0. Use radius = -1 (default) to disable the radius gate; use 0 to require “exact tile.”
OCCUPY_TILE nuance: It can fire on move and also on spawn/complete. If you want only move-based occupancy, gate on a flag you set after map init (or add a short DELAY before registering the trigger).
City/rover defeat: ALL_CITIES_DEAD treats no CITY and no ROVER as the condition to fire (mirrors campaign loss logic).
AP aura wildcard: apAuraType: "NONE" acts as “any aura.”

D. Callback parameter availability

When a trigger fires, the engine populates TriggerCallbackParams as follows (only fields relevant to the event are set):

Field	Set for
`action`	Move/attack/damage flows (`Action.Move`, `Action.DamageAction`)
`unit`	The relevant unit (mover, new unit, dead unit, perk target, resource producer/collector, etc.)
`unitType`	The relevant unit type (e.g., produced type for `UNIT_QUEUED`)
`player`	The involved player (owner, death event, perk unlocker, etc.)
`sciencePerk`	`PERK_UNLOCKED`
`resourceType`	`RESOURCE_COLLECTED`
`scrapType`	`SCRAP_COLLECTED`
`amount`	`RESOURCE_COLLECTED`, `SCRAP_COLLECTED`
`keepTrigger`	Default `false`. Your callback may set to `true` to keep the trigger after firing

E. Minimal examples

// Fire when any enemy unit dies within 3 tiles of a marker.
{
  "type": "UNIT_DEATH",
  "player": "ENEMY_PLAYER",
  "position": "$(MAP:ambushCenter)",
  "radius": 3,
  "actions": [ ["TOAST", {"text": "Target down"}] ]
}

// Fire whenever the player receives any AP aura on a Grenadier.
{
  "type": "AP_BOOST",
  "unitType": "GRENADIER",
  "apAuraType": "NONE",
  "actions": [ ["SPEAK", "$(TRIGGER:unit)", "Feeling spry!"] ]
}

// Trigger the first time a tile becomes visible to the player (unit pin or fixed position).
{
  "type": "TILE_REVEALED",
  "player": "PLAYER",
  "position": "$(MAP:hilltop)",
  "actions": [ ["MOVE_CAMERA", "$(MAP:hilltop)"] ]
}

// Resource collection near a refinery hub.
{
  "type": "RESOURCE_COLLECTED",
  "player": "PLAYER",
  "position": "$(MAP:refineryHub)",
  "radius": 4,
  "actions": [
    ["TOAST", {"text":"+$(TRIGGER:amount) $(TRIGGER:resourceType) near hub"}]
  ]
}

See Trigger Types.

7. Actions

This section lists every supported opcode (action), its signature (parameter order and types), and important notes. Unless specified, actions run sequentially and await any animations/async work they start when the engine does so internally.

Conventions & Types

Types: int, float, bool, string, Vector2i, UnitId, UnitId[], UnitType, PerkType, TileType, ResourceType, Player ("PLAYER" | "ENEMY_PLAYER" | "NEUTRAL_PLAYER").
Selectors/Variables: Any parameter may accept a selector like "$(flagName)", "$(varName)", "$(TRIGGER:unit)", or a map marker "$(MAP:name)" if the underlying type matches.
Param Objects are JSON objects with the listed fields; unrecognized fields are ignored.
Storage: When a signature mentions varName, the result is stored under that name. Unless noted, storage uses globalVariables.

Quest & Flow

Opcode	Signature	Notes
`ADD_QUEST`	`["ADD_QUEST", questIndex:int]`	Adds a quest from top-level `quests` by index to the tracker.
`COMPLETE_QUEST`	`["COMPLETE_QUEST", questIndex:int]`	Marks the quest complete.
`FAIL_QUEST`	`["FAIL_QUEST", questIndex:int]`	Marks the quest failed.
`DELAY`	`["DELAY", seconds:float]`	Non-blocking wait before next action in the same list.
`ON_TICK`	`["ON_TICK", subActions:Action[]]`	Runs `subActions` every game tick. Persisted across saves with a snapshot of local values.
`NOOP`	`["NOOP", ...optional:any]`	Does nothing. Useful for commenting/disabling steps.

Trigger Control

Opcode	Signature	Notes
`CREATE_TRIGGER`	`["CREATE_TRIGGER", name:string, { "paramValues": any[] }]`	Instantiates a named trigger declared in `triggers`. `paramValues` align with the trigger’s `params` order.

Camera & UI

Opcode	Signature	Notes
`MOVE_CAMERA`	`["MOVE_CAMERA", position:Vector2i]`	Pans to tile and waits for camera to finish.
`UI_WASD_ICON`	`["UI_WASD_ICON", isEnabled:bool]`	Shows/hides WASD hint.
`ENABLE_UI_MOD`	`["ENABLE_UI_MOD", "TURN_COUNTDOWN", opts?:{ setTitle?:string, setAmount?:int, addAmount?:int }]`	Adds a turn countdown widget if not present.
`UPDATE_UI_MOD`	`["UPDATE_UI_MOD", "TURN_COUNTDOWN", opts?:{ setTitle?:string, setAmount?:int, addAmount?:int }]`	Updates the countdown widget.
`DISABLE_UI_MOD`	`["DISABLE_UI_MOD", "TURN_COUNTDOWN"]`	Removes the widget if present.
`NEW_WAVE_ALERT`	`["NEW_WAVE_ALERT"]`	Displays an incoming-wave banner.
`SET_ZOOM`	`["SET_ZOOM", zoom:float]`	Sets camera zoom.
`CINEMATIC`	`["CINEMATIC", (unitArray:UnitId, position:Vector2i), params:{ unitText?:string, duration?:float, topText?:string, topColor?:string, bottomText?:string, bottomColor?:string }, concurrent?:Action ]`	Renders a unit-or-tile cinematic. If first arg resolves to units, the first valid unit is used; otherwise a tile at `position` is used. `concurrent` actions run when the cinematic starts.
`TOAST`	`["TOAST", { text:string, position?:Vector2i, icon?:string }]`	Shows a toast. If `position` is set, clicking recenters camera near it. `icon` accepts unit/resource names (and `AP`/`VICTORY`).

Variables, Flags & Math

Opcode	Signature	Notes
`FLAG`	`["FLAG", flagName:string, cond:{ lessThan?:int, equal?:int, greaterThan?:int }, sub:Action[]]`	Runs `sub` only if the condition on the flag passes.
`INC_FLAG`	`["INC_FLAG", flagName:string, amount:int]`	Adds (or subtracts) from a flag.
`SET_FLAG`	`["SET_FLAG", flagName:string, value:int]`	Sets a flag directly.
`COUNT`	`["COUNT", varName:string, ints:int]`	Stores `size(ints)` into `globalVariables[varName]`.
`PICK_RANDOM`	`["PICK_RANDOM", varName:string, source:any]`	If `source` is an array, picks one element; otherwise stores the value as-is. Stored in globalVariables.
`MAX_DISTANCE`	`["MAX_DISTANCE", varName:string, { sourcePosition:Vector2i, positions:Vector2i[] }]`	Picks the farthest position and stores it in local values (not globals).
`GET_RESOURCE`	`["GET_RESOURCE", resource:ResourceType, player:Player, varName:string]`	Reads a player resource into `globalVariables[varName]`.

Units: Spawning, Ownership, Movement & Combat

Opcode	Signature	Notes
`SPAWN_UNIT`	`["SPAWN_UNIT", params:{ name?:string, player:Player, type:UnitType, position:Vector2i, flags:["OUT_OF_SIGHT"], forFree?:bool=true, force?:bool=true, warpIn?:bool=false, production?:int=0, unitFactory?:UnitId=-1, quantity?:int=1..7 }]`	Spawns one or more units. If `name` is set, stores spawned unit IDs in `units[name]`. `OUT_OF_SIGHT` tries to place out of enemy vision. If `unitFactory` is set, production/queue rules apply. `warpIn` plays an arrival effect.
`SPAWN_ATTACK`	`["SPAWN_ATTACK", { name?:string, composition: { UnitType:int }[], position:Vector2i, destination:Vector2i }]`	Spawns a composition of units near `position` and orders them to `ATTACK_MOVE` toward `destination`. Stores spawned IDs in `units[name]` if set.
`REMOVE`	`["REMOVE", unitArray\:UnitId]`	Removes units from the map (not a kill).
`KILL`	`["KILL", target:Player\|UnitId]`	If `target` resolves to a player string, kills that side. Otherwise kills the specified units.
`SET_PLAYER`	`["SET_PLAYER", unitArray:UnitId, player:Player]`	Transfers ownership of units to another player.
`MOVE_TOWARDS`	`["MOVE_TOWARDS", destination:Vector2i, unitArray:UnitId, options?:{ maxDistance?:int }, subActions?:Action ]`	Orders units to path toward a tile. Runs `subActions` after arrival.
`ATTACK_TILE`	`["ATTACK_TILE", target:Vector2i, unitArray:UnitId, subActions?:Action ]`	Units attack a tile; engine chooses melee/ranged. `subActions` run after the attack animation.
`RESET_MOVEMENT`	`["RESET_MOVEMENT", selector:Vector2i\|UnitId]`	Restores movement points for all units on a tile, listed units, or all units of a player.
`SET_HEALTH`	`["SET_HEALTH", unitArray:UnitId, params:{ percent?:float\| amount?:int, delta?:int }]`	Sets health by absolute `amount` or by `percent` of max, then applies `delta` if provided.
`UNIT_STRATEGY`	`["UNIT_STRATEGY", unitArray:UnitId, cfg:{ goal:Goal, radius?:[int,int], preferCover?:bool, willScatter?:bool, destination?:Vector2i }]`	Attaches an AI strategy engine to the units. Goals include `PROTECT`, `MOVE`, `ATTACK_MOVE`, `WAIT`.
`ENABLE_UNITS`	`["ENABLE_UNITS", unitTypes:("ALL_UNIT_TYPES"\| UnitType\[])]`	Enables listed unit types in the build UI.
`DISABLE_UNITS`	`["DISABLE_UNITS", unitTypes:("ALL_UNIT_TYPES"\| UnitType)]`	Disables listed unit types in the build UI.
`SPEAK`	`["SPEAK", unit:UnitId, text:string]`	Unit speech bubble.
`SET_UNIT_NAME`	`["SET_UNIT_NAME", name:string, unitArray:UnitId]`	Sets the display name on the first valid unit in the array.

Tiles, Map & Vision

Opcode	Signature	Notes
`DESTROY_TILE`	`["DESTROY_TILE", position:Vector2i]`	Sets tile health to 0 (advances damage state).
`GET_TILES`	`["GET_TILES", varName:string, { position:Vector2i, radius:int, excludeCenter?:bool=false, visionIsRequired?:bool=false, player?:Player, canFitUnits?:UnitId, canFitUnitTypes?:UnitType }]`	Gathers tiles into `globalVariables[varName]` (as `Vector2i[]`). If `canFit*` is set, filters by placement rules (and optionally by `player` occupancy).
`GRANT_VISION`	`["GRANT_VISION", position:Vector2i, radius:int]`	Reveals tiles in a radius for the player.
`REVOKE_VISION`	`["REVOKE_VISION", position:Vector2i, radius:int]`	Removes vision in a radius (restores fog).

Selection & Query

Opcode	Signature	Notes
`GET_UNITS`	`["GET_UNITS", varName:string, selector: { player?:Player, tile?:Vector2i, radius?:int, units?:bool, buildings?:bool, turrets?:bool, unitTypes?:UnitType[] }]`	Stores a `UnitId[]` into `globalVariables[varName]`. Filtering defaults: if none of `units/buildings/turrets` is provided, all are included; otherwise only `true` ones are included (turrets are a subset of buildings). If `tile` is set, optional `radius` expands selection.

Construction Rules & UI Validations

Opcode	Signature	Notes
`DISABLE_UNIT_CANCEL`	`["DISABLE_UNIT_CANCEL", unitTypes:UnitType[]]`	Forbids canceling construction of the listed unit types.
`SET_BUILD_UNIT_FLAGS`	`["SET_BUILD_UNIT_FLAGS", unitTypes:UnitType, requirements:({ flag:string, lessThan?:int, equal?:int, greaterThan?:int } \| { tileType:TileType\[], radius:int, evolutionIndex?:int } )]`	Adds a UI validator. All listed requirements must pass for the given `unitTypes` when building from a unit. Failing sets an explanatory error string.

Resources, Rewards & Mission State

Opcode	Signature	Notes
`ADD_RESOURCES`	`["ADD_RESOURCES", player:Player, resources:{ POWER?:int, OIL?:int, COBALT?:int, HELIUM?:int, SCIENCE?:int, SCRAP?:int, PRODUCTION?:int, AP?:int }, options?:{ showToast?:bool=true }]`	Grants resources/AP and (optionally) shows toasts. `AP` affects max action points.
`SET_STARS`	`["SET_STARS", stars:int]`	Sets mission star count immediately.
`KILL`	`["KILL", target:Player\|UnitId]`	If `target` resolves to a player string, kills that side. Otherwise kills the specified units. Used to end missions: killing `"PLAYER"` = defeat; killing `"ENEMY_PLAYER"` = victory.
`SPAWN_SCRAP`	`["SPAWN_SCRAP", position:Vector2i, scrap:{ player?:Player, SCRAP?:int, POWER?:int, OIL?:int, COBALT?:int, HELIUM?:int, SCIENCE?:int, ACTION_POINT?:int }]`	Spawns scrap piles on the map at a tile. Optional `player` sets ownership.

Auras & Effects

Opcode	Signature	Notes
`EMIT_AURA`	`["EMIT_AURA", auraName:string, unitArray:UnitId]`	Applies an aura to each unit and tracks it in the save context.
`CANCEL_AURA`	`["CANCEL_AURA", auraName:string, unitArray:UnitId]`	Removes an aura from each unit (and updates saved context).

Notes on Storage Scopes

globalVariables: Written by most query actions (GET_UNITS, GET_TILES, PICK_RANDOM, GET_RESOURCE, etc.). Accessible via $(varName).
Local values (stack): Written by MAX_DISTANCE and used for temporary/local substitutions; also extended by CREATE_TRIGGER's parameter injection and by trigger callback context (TRIGGER:*).

Tip: If you need a value produced by MAX_DISTANCE to persist across triggers, write it back into globalVariables with PICK_RANDOM (storing the value itself) or by assigning it via a subsequent action that accepts a variable.

8. Trigger Types

NONE, OCCUPY_TILE, UNIT_DEATH, ALL_UNITS_DEAD, ALL_BUILDINGS_DEAD, ALL_CITIES_DEAD, RECEIVED_DAMAGE, ATTACK,
UNIT_COMPLETED, TILE_REVEALED, AP_BOOST, TILE_DESTROYED, PLAYER_DEATH, PERK_UNLOCKED, RESOURCE_COLLECTED, SCRAP_COLLECTED,
UNIT_QUEUED

9. Enums & Constants

Unit Types: Full list of Unit.Type values (e.g., CITY, OUTPOST alias, LASERBOT, etc.).
Strategy Goals: MOVE, ATTACK_MOVE, PROTECT, WAIT, NONE.
Tile Types: MOUNTAIN, MOUND, FOREST, COBALT, DESERT, WHEAT, WATER, CLIFF, FIELD, SWAMP, NONE, SNOW.
Perk Types: Full list (e.g., SCRAPYARD_UNIT_BONUS_HEALTH, REVERSE_ENGINEERING, etc.).
Resource Types: ELECTRICITY, OIL, COBALT, PRODUCTION, SCIENCE, WATER, HELIUM, SCRAP, NONE.
Scrap Types: SCRAP, POWER, OIL, COBALT, HELIUM, SCIENCE, ACTION_POINT.
Portraits: JEB, TOOTS, MEATBAG.
UI Mods: Currently TURN_COUNTDOWN.
Auras: Armor Boost, Extra Attack, Heal, Emergency Production, …, Warping.
Special Constants: ALL_UNIT_TYPES, ALL_PERK_TYPES.

10. Init Sequence

Executed once at mission start. Example:

"init": [
  ["DISABLE_UNIT_CANCEL", ["OUTPOST"]],
  ["SET_BUILD_UNIT_FLAGS", ["OUTPOST"], [
    {"flag": "placeOutpostEnabled", "equal": 1},
    {"tileType": "WHEAT", "radius": 2, "evolutionIndex": 0}
  ]],
  ["ADD_RESOURCES", "PLAYER", {"POWER": 30}, {"showToast": false}]
]

11. Map References

Use $(MAP:markerName) to reference named tiles.

12. Stars and Mission End

Stars: 0–3 rating.
KILL actions end mission.

13. Notes & Gotchas

Aliases: OUTPOST→CITY, ICBOOM→ICMBOOM.
Evolution indices: 0 = undamaged.
RESET_MOVEMENT allows re-use in same turn.
NOOP useful for disabling actions.

14. Example

A simple MDL mission:

{
  "experienceModifier": 1.0,
  "resourcePacks": { "POWER": 6, "SCRAP": 21 },
  "flags": [{ "name": "turnsRemaining", "value": 15 }],
  "quests": [{ "title": "Build a Scrapyard.", "icon": "SCRAPYARD" }],
  "triggers": [
    {
      "type": "UNIT_COMPLETED",
      "player": "PLAYER",
      "unitType": "SCRAPYARD",
      "actions": [["COMPLETE_QUEST", 0]]
    }
  ],
  "init": [
    ["ADD_RESOURCES", "PLAYER", {"POWER": 30}]
  ]
}

Name		Name	Last commit message	Last commit date
Latest commit History 10 Commits
LICENSE		LICENSE
README.md		README.md

License

SoftwareVerde/mordfield-mdl

Folders and files

Latest commit

History

Repository files navigation

Mordfield Definition Language (MDL) Specification

1. Overview

2. Top-Level Structure

3. Flags

4. Unit Modifiers

Permanent Unit Mods

Starting Unit Mods

5. Quests

6. Triggers

A. Common trigger shape & mechanics

B. Per-type key support & evaluation

1) OCCUPY_TILE

2) UNIT_DEATH

3) ALL_UNITS_DEAD

4) ALL_BUILDINGS_DEAD

5) ALL_CITIES_DEAD

6) RECEIVED_DAMAGE

7) ATTACK

8) UNIT_COMPLETED

9) TILE_REVEALED

10) AP_BOOST

11) TILE_DESTROYED

12) PLAYER_DEATH

13) PERK_UNLOCKED

14) RESOURCE_COLLECTED

15) SCRAP_COLLECTED

16) UNIT_QUEUED

C. Special cases & tips

D. Callback parameter availability

E. Minimal examples

7. Actions

Conventions & Types

Quest & Flow

Trigger Control

Camera & UI

Variables, Flags & Math

Units: Spawning, Ownership, Movement & Combat

Tiles, Map & Vision

Selection & Query

Construction Rules & UI Validations

Resources, Rewards & Mission State

Auras & Effects

Notes on Storage Scopes

8. Trigger Types

9. Enums & Constants

10. Init Sequence

11. Map References

12. Stars and Mission End

13. Notes & Gotchas

14. Example

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

1) `OCCUPY_TILE`

2) `UNIT_DEATH`

3) `ALL_UNITS_DEAD`

4) `ALL_BUILDINGS_DEAD`

5) `ALL_CITIES_DEAD`

6) `RECEIVED_DAMAGE`

7) `ATTACK`

8) `UNIT_COMPLETED`

9) `TILE_REVEALED`

10) `AP_BOOST`

11) `TILE_DESTROYED`

12) `PLAYER_DEATH`

13) `PERK_UNLOCKED`

14) `RESOURCE_COLLECTED`

15) `SCRAP_COLLECTED`

16) `UNIT_QUEUED`

Packages