Thinis — The Dawn of Civilization

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

src/scripts/mission_1_thinis.js

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

// lines 3 – 39  (mission_1_thinis.js)
mission1 {
  start_message : "message_gold_and_crime"   // intro popup: gold + crime
  env {
    has_animals       : true
    gods_least_mood   : 50
    marshland_grow    : default_marshland_grow
    tree_grow         : default_tree_grow
    hide_nilometer    : true
  }
  player_rank      : 0
  hide_won_screen  : true         // skip victory screen, proceed to next mission

  initial_funds  [7500, 5000, 3750, 2500, 2000]  // Very Easy … Very Hard
  rescue_loans   [7500, 5000, 3750, 2500, 2000]

  buildings [
    BUILDING_HOUSE_VACANT_LOT, BUILDING_CLEAR_LAND, BUILDING_ROAD,
    BUILDING_ARCHITECT_POST, BUILDING_FIREHOUSE, BUILDING_POLICE_STATION,
    BUILDING_BAZAAR, BUILDING_GRANARY, BUILDING_WATER_SUPPLY,
    BUILDING_GOLD_MINE, BUILDING_VILLAGE_PALACE, BUILDING_HUNTING_LODGE,
  ]                      // temples / entertainment unlock via events

  win_criteria {
    housing_count { enabled : true, goal : 10 }
    housing_level { enabled : true, goal : 5 }   // housing level 5
  }

  vars {
    gold_mined               : 500   // deben threshold to unlock religion
    victory_last_action_delay : 4
    nogranary_population_cap : 150   // pop cap without a granary
    // boolean flags — persist across saves
    gold_mined_handled     : false
    temples_built          : false
    booth_built            : false
    juggler_school_built   : false
    last_action_time       : 0
  }
}

To change the gold threshold that unlocks religion, edit gold_mined. To adjust the population cap enforced before a Granary is built, edit nogranary_population_cap.

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

• event_mission_start line 54 Hides all advisors except Population on fresh start. On load/restart, re-unlocks any buildings whose event was already fired (religion if gold_mined_handled, entertainment if temples_built), restoring mid-mission state correctly. mission1_on_start
• event_advance_day · gold check line 77 Checks daily whether city.finance.this_year.income.gold_delivered ≥ 500. When reached, sets gold_mined_handled = true, unlocks Temple of Bast / Shrine of Bast / Festival Square, enables Religion Advisor, and shows message_tutorial_the_gods_of_egypt. Runs only once (guard on gold_mined_handled). mission1_check_gold_mined
• event_migration_update line 99 Caps immigration when no Granary exists: calls migration.set_population_cap("no_granary_population_cap", 150). Lifted to 0 (no cap) as soon as any active Granary is present. mission1_handle_population_cap
• event_update_victory_state line 107 Evaluates all four milestone flags plus a 4-day cooldown since the last event. All must be true before victory can be granted. Also sets named reasons for the UI tooltip that describes what remains to be done. mission1_handle_victory_state
• event_advance_day · temple check line 118 Polls daily for an active Temple of Bast. When found, sets temples_built = true, unlocks Booth and Juggler's School, enables Entertainment Advisor, shows message_tutorial_entertainment. Runs only once. mission1_on_build_temple
• event_advance_day · booth check line 140 Polls daily for an active Booth. Sets booth_built = true on first detection. Runs only once. mission1_on_build_booth
• event_advance_day · juggler school check line 155 Polls daily for an active Juggler's School. Sets juggler_school_built = true on first detection. Runs only once. mission1_on_build_juggler_school

The goal tooltip function mission1_get_goal_tooltip() (line 41) 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.

The original Pharaoh save file that provides the map layout, terrain, gold ore deposits, and starting positions for Thinis is:

bin_x64/Missions/mission_01.sav

This binary file is loaded by the engine before the JS script runs. It encodes the tile map, Nile course, gold deposit positions, predefined animal spawn zones, and the kingdom road entry point. To replace the map entirely, 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_1_thinis.js by path. If you rename or move the file, update the import there.