Perwadjyt — The Precarious Nile

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

src/scripts/mission/m_002_perwadjyt.js

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

// lines 3 – 47  (m_002_perwadjyt.js)
mission2 {
  start_message : "message_farming_along_the_nile"  // intro popup: farming + Work Camps
  selection_title : "Perwadjyt"
  env {
    has_animals     : true
    gods_least_mood : 50
    marshland_grow  : default_marshland_grow
    tree_grow       : default_tree_grow
  }
  player_rank  : 0

  initial_funds  [7500, 5000, 3750, 2500, 2000]  // Very Easy … Very Hard
  rescue_loans   [7500, 5000, 3750, 2500, 2000]
  house_tax_multipliers [300, 200, 150, 100, 75]

  buildings [                                   // available at start
    BUILDING_FIREHOUSE, BUILDING_ARCHITECT_POST, BUILDING_POLICE_STATION,
    BUILDING_VILLAGE_PALACE, BUILDING_WATER_SUPPLY,
    BUILDING_FIGS_FARM, BUILDING_WORK_CAMP,
    BUILDING_BOOTH, BUILDING_JUGGLER_SCHOOL,
    BUILDING_BAZAAR, BUILDING_GRANARY,
    BUILDING_TEMPLE_OSIRIS, BUILDING_SHRINE_OSIRIS, BUILDING_FESTIVAL_SQUARE
  ]                                             // industry / deco / health unlock via events

  win_criteria {
    population    { enabled : true, goal : 600 }
    housing_count { enabled : true, goal : 10 }
    housing_level { enabled : true, goal : 6 }  // level 6 = Ordinary Cottage
  }

  vars {
    figs_stored                    : 800   // figs threshold to unlock pottery
    pottery_step1_stored           : 100   // pottery stored to lift pop cap
    pottery_step1_population_cap   : 500   // pop cap until step1 reached
    pottery_step2_stored           : 200   // pottery stored to unlock deco buildings
    victory_last_action_delay      : 3

    figs_stored_handled           : false
    disease_handled               : false
    pottery_step1_stored_handled  : false
    pottery_step2_stored_handled  : false
  }
}

To change the figs threshold that unlocks pottery, edit figs_stored. To adjust the population cap enforced until pottery production begins, edit pottery_step1_population_cap.

Each function is bound to a game event via an attribute annotation. Handlers fire only while mission=mission2 is active.

• event_migration_update line 49 Enforces the pottery population cap. While pottery_step1_stored_handled is false, calls migration.set_population_cap("pottery_not_produced_population_cap", 500). Lifted to 0 (no cap) once 100 pottery is stored. mission2_handle_population_cap
• event_mission_start line 71 Enables the empire map, then hides all advisors. Re-enables Population, Entertainment, and Religion advisors unconditionally. On load/restart, re-unlocks industry buildings if figs_stored_handled is already set, decorative buildings if pottery_step2_stored_handled is set, and health buildings if disease_handled is set — restoring mid-mission state correctly. mission2_on_start
• event_granary_resource_added line 109 Fires when food is added to any Granary. Once a single Granary holds ≥ 800 figs (configurable via figs_stored), sets figs_stored_handled = true, unlocks Clay Pit / Pottery Workshop / Storage Yard, enables Labor Advisor, and shows message_tutorial_industry (ID 259). Runs only once. mission2_on_filled_granary
• event_warehouse_filled (step 1) line 134 Fires when a Storage Yard receives goods. Once the city's total pottery across all Storage Yards reaches ≥ 100 units (configurable via pottery_step1_stored), sets pottery_step1_stored_handled = true, which lifts the population cap via event_migration_update. Runs only once. mission2_warehouse_pottery_1_check
• event_warehouse_filled (step 2) line 149 After step 1 is complete, watches for total pottery ≥ 200 units (configurable via pottery_step2_stored). Sets pottery_step2_stored_handled = true, unlocks Road Block / all Statues / Gardens / Plaza / Low Bridge / Ferry, and shows message_tutorial_municipal_structures (ID 256). Runs only once. mission2_warehouse_pottery_2_check
• event_city_disease line 179 Fires on the first epidemic. Sets disease_handled = true, unlocks Apothecary and Physician, enables Health Advisor, and shows message_basic_healthcare (ID 250). Runs only once. mission2_on_disease
• event_update_victory_state line 197 Checks all three scripted flags (figs_stored_handled, pottery_step1_stored_handled, pottery_step2_stored_handled) plus a 3-day cooldown after the last event. All must be true before the core win criteria (population 600, 10 houses at level 6+) can grant victory. mission2_handle_victory_state

The goal tooltip function mission2_get_goal_tooltip() (line 55) returns a different hint string depending on which milestone is still pending — it is called by city.goal_tooltip to drive the in-game objective display.

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.

A second history entry message_history_perwadjyt_3 (ID 238, line 3031, subtitle "The Banks of the Nile") is used when Perwadjyt appears later in the campaign and describes the mastaba requirement and Canaanite warships. It is not used by mission 2.

The original Pharaoh save file that provides the map layout, terrain, Nile course, and floodplain tiles for Perwadjyt is:

bin_x64/Missions/mission_02.sav

This binary file is loaded by the engine before the JS script runs. It encodes the tile map, Nile layout (including floodplain bounds), predefined animal spawn zones, and the kingdom road entry point. The floodplain tiles are embedded in the map data — their exact positions determine where Fig Farms can be placed and how large a harvest the player can achieve. To replace the map, swap the .sav file; the JS script will still apply on top of it.

The scripting system is loaded from src/scripts/missions.js, which imports mission/m_002_perwadjyt.js by path. If you rename or move the file, update the import there.