Meidum — A Royal Necropolis

The entire mission — configuration block, variables, and all event handlers — lives in one file:

src/scripts/mission/m_012_meidum.js

This file is imported by src/scripts/missions.js. The mission12 { … } block at the top is the static configuration parsed at startup:

// m_012_meidum.js — full empire redefine, verified vs mission1.pak scenario 12 (2026-07-25)
mission12 {
  map_file : "data/maps/m_012_meidum.map"
  start_message : "message_mission_meidum"
  player_rank : 4

  choice [                       // post-victory: Buhen (13) / Dahshur (14)
    { name : "Buhen",   id : 13 }
    { name : "Dahshur", id : 14 }
  ]

  initial_funds [20000, 13300, 10000, 6700, 5300]
  debt_interest [4, 6, 8, 10, 12]

  // Monuments goal 76 = trunc(2.25*(8+24)+4.5); pak was 39.
  win_criteria {
    population    { enabled : true, goal : 3000 }
    culture       { enabled : true, goal : 25 }
    prosperity    { enabled : true, goal : 25 }
    monuments     { enabled : true, goal : 76 }
    kingdom       { enabled : true, goal : 40 }
    housing_level { enabled : true, goal : 11 }
  }

  invasion_points_land [ [114, 79] ]
  invasion_points_sea  [ [31, 7] ]

  // empire id=1; hide_pak_* + cities/routes/ornaments/texts (Abu/Behdet/Nekhen sea,
  // Saqqara/Serabit Khadim land, Men-nefer display-only Pharaoh route)
  hide_pak_cities : true
}

The monument goal of 76 is the rating from small (8) + on-land complex (24) → trunc(2.25 × 32 + 4.5) = 76 (see src/scripts/city/monuments.js). Pak original was 39; restoring it needs a pak-compatible formula fork. Causeway placement for the complex is still open. All other goals (pop 3000, culture 25, prosperity 25, kingdom 40, housing level 11) and the funds/debt-interest ladders match pak exactly. Trade: Abu / Behdet / Nekhen (sea, 650–1050 Db), Saqqara / Serabit Khadim (land, 200–350 Db) — all start closed. Men-nefer is a display-only Pharaoh route (no goods). Display: Byblos, Kerma, Kyrene, Selima Oasis.

Handlers fire only while mission=mission12 is active. Raids use the JS API city.start_foreign_army_invasion with ENEMY_5_HYKSOS; native EVENT_TYPE_INVASION awaits B2 / B2-migrate. Every pak event index (i=0…70) that isn't skipped junk gets its own event_advance_month handler, gated by a once-flag or a per-year "last fired" guard for recurring roots — rather than list all ~40 of them individually, they group into:

• event_mission_start Start message; empire.set_id(1); city.set_scenario_enemy_id(ENEMY_5_HYKSOS); advisors; wires every dormant chain leaf up front. mission12_on_start
• Shared helper builders Create the dormant ONLY_VIA_EVENT chain leaves reused across most requests: the four shared KR leaves (+8 / −5 / +2 / −2), plus the clay, timber, grain, and papyrus resource chains, plus the gift chains (luxury/oil). mission12_ensure_*_leaves
• Once calendar roots Fire a single request or state change the first time the game clock passes their pak year/month: timber y3m4, wage decrease y5m3, reeds y5m7, papyrus y12m11 / y15m10 / y63m2, stone y13m3 / y29m8, pottery y13m8 (bare, no KR chain) / y23m4 / y39m5 / y62m8, grain y18m3, failed floods y16m9 / y33m8, price changes y72m8 / y74m7, clay y74m7, and the stone→luxury gift root y69m7. mission12_event_i<n>_*
• Recurring calendar roots Re-fire yearly once their gate year is reached, guarded via mission_recurring_request_may_fire so overlapping pottery/grain/timber requests never stack: pottery y8m1+ (clay chain) / y11m9+ / y40m4+ / y52m4+, grain y13m5+ / y23m4+ / y38m3+ / y41m11+ (grain chain) / y44m3+ / y56m11+ (grain chain) / y60m9+ (gift chain), timber y16m7+ (timber chain) / y59m1+ / y82m1+, stone y95m7+ (gift chain), plus price/wage swings, clay-pit floods, and the sea-trade problem (y61m5+). mission12_event_i<n>_*_recurring
• Hyksos raid + Pharaoh favour Recurring size-17 Hyksos raid from y7m6+, gated on city.num_enemy_formations == 0 so it re-arms once the map is clear; a monthly favour tick drops a size-25 Pharaoh army when kingdom rating bottoms out, chaining to a size-60 second wave. mission12_event_i70_hyksos_invasion_recurring / mission12_pharaoh_favour_invasion

Dump helper: src/js/js_test_mission_pak_dump.cpp (__test_mission_pak_dump / GamestateIO::load_mission_pak_raw; ad-hoc tests/99_tmp_mission12_dump.js).

Popup dialogs and the opening history panel are defined in src/scripts/game_messages_en.js. To edit text, find the entry by key and change the text: field inside its content { … } block.

Briefing and victory narration audio: Voice/Mission/212_mission.mp3 and Voice/Mission/212_victory.mp3 (configured in the sounds block of the mission config).

• Monument goal: original pak is 39 (small + stepped pyramid complex). Reimpl uses the additive formula → goal 76 (trunc(2.25·(8+24)+4.5)); on-land complex weight=24 (same as large) because rating is clamped to 100 and weight 44 would saturate alone. Causeway open. Pak-39 needs a pak-compatible formula fork.
• Invasions and Pharaoh's favour are proxied in JS (city.start_foreign_army_invasion, mission_pharaoh_favour_invasion_tick) rather than the native EVENT_TYPE_INVASION — same pattern as Saqqara and Serabit Khadim, pending the B2-migrate step. Favour drops a Pharaoh-aligned army of 25, chaining to a second wave of 60 if the kingdom rating stays low.
• Skipped pak junk: empire route 47 (orphan, no city references it) and map object index 7 (an empty stub at position 0,0) are omitted. Pak events with years_since_start >= 98 (a failed flood, a reeds request, a wage change, and a papyrus request with its gift chain) are dead data past any realistic playthrough length and are not wired.
• Orphan chain-only leaves with no inbound reference (pak i=46 KR+7, i=58 papyrus price-decrease) are left out of the script — nothing in the fired schedule ever routes to them.

The map layout, terrain, marshland island, and the kingdom road entry point come from the original Pharaoh campaign pack:

mission1.pak (scenario offset for id 12 — see GamestateIO::get_campaign_scenario_offset, src/io/gamestate/boilerplate.cpp:120)

The binary map is loaded by the engine before the JS script runs. The scripting system is loaded from src/scripts/missions.js, which imports mission/m_012_meidum.js by path. If you rename or move the file, update the import there.