Skip to content

A Civilization-style strategy game about governing Israel from 15 May 1948. Real ministers, real map, every fact sourced. Unity + deterministic C# sim.

73.1 KB
Raw Blame

Statecraft Israel Game Design

Core systems and player choices Current version 0.3 | 30 October 2026 (consolidated design proposal); open questions answered by the owner on 1 November 2026 Previous published baseline metadata: Version 0.2 | 17 October 2026 (version 0.1: 12 October 2026) Map and location specifications updated 17 October 2026. The owner's game design of record, based on the original document (GDD-v0.1.pdf) with the additions dated above. The owner's rulings of 12 and 17 October 2026 are at the end. Where an older spec or ruling disagrees, this document wins (AGENTS.md).

This 0.3 revision adds Amir's subsequent design decisions to the current design of record and records the owner's 30 October 2026 conflict decisions and the owner's 1 November 2026 answers to its open questions. It describes intended changes; it does not claim the existing simulation implements them or that they supersede recorded owner rulings.

MVP scope 1948 to 1951

The MVP tells the story of the Liberation War, the austerity period (תקופת הצנע), and immigration during 1948-1951.

Each turn advances history by one month. The MVP runs from 15 May 1948 to 15 January 1952, 44 monthly turns on the 15th (owner rulings D-B1 and D-E5, "End on 15 Jan 1952", impact plan §5; content/rules.yaml mvp.end), giving the player time to finish the war, house and employ immigrants, construct the Tel-Aviv to Haifa railway and the Burma Road, and establish new yishuvim.

Objectives

  1. Survive the Liberation War. Earn bonus points for finishing the war earlier than its historical end and for capturing enemy soldiers.
  2. Absorb immigrants. Provide immigrants with housing and employment.
  3. Establish key infrastructure. Complete the Tel-Aviv to Haifa railway and the Burma Road corridor to Jerusalem, and establish new yishuvim at designated sites.

Historical events on objective completion

Each time an objective is completed, it triggers a historical event card connected to the corresponding real event. The card contains an authentic image of that event, a short historical account, and the actual date when it happened.

The card also shows when the player completed the objective. Compare the player's completion date with the actual historical date: completing it earlier awards bonus points. Exact point values remain open.

Then decided (owner, 14 Oct 2026, D-B2 and D-B6; #456): each completed objective is worth 100 points, and finishing one early adds 5 points per calendar month, capped at 60; both are tunable design values.

Core gameplay

A turn-based strategy game about building and defending Israel. Players allocate people and limited resources to employment, settlement, infrastructure and military activity, then respond to events that change their situation.

The rules below define the current design direction. Items marked Open or Proposal need a decision before implementation. Resource amounts, action costs and balance values remain unset.

Player decisions and turn loop

The central decision is where people should contribute next. A civilian can take a job, enter military training or train as a pioneer. These choices compete for the same available population.

Proposed turn structure:

  1. Review resources and city needs.
  2. Move units, issue orders, start city projects and choose ministers. Moves and attacks happen at once; the other orders take effect at End turn (owner, 23 October 2026, #1402 and #1398: "Instant, like Civ", "No undo, like Civ" and "Approve, start building").
  3. Select event outcomes.
  4. Resolve production, consumption, training, construction and combat.

Unit orders are free under D-A6, and their order of resolution follows R-TURN-004 (owner, 23 October 2026, #1402 and #1398: "Approve, start building").

Minister selection TBD

The player can choose ministers. TBD: minister roles, available candidates, appointment rules, costs and effects on gameplay. Then decided (owner, 23 Oct 2026, "Yes, complete (Recommended)"; #1513): the implemented slice is the complete MVP minister mechanic: lawful appointment (Cabinet.Appoint) and each mapped office's competence and budget scaling the GDD systems in its remit (R-MIN-001 to R-MIN-003). The MVP adds no further offices, candidate traits or minister actions.

Resources and national parameters

Resource or parameter Role Still to define
Money Funds development and other paid actions. Craftsmen earn more money. Income per job, construction costs and upkeep.
Arms Available military equipment. Decided, D-G6: "From events (sourced arms deals) and Money. Training and attacks consume it" (impact plan §5); attacks consume it only under gdd-0.1: under gdd-0.3 attacks and artillery fire spend no Arms (R-COMBAT-004; military-combat.md). The four numbers asked on #856 and #781 are set (owner, 18 October 2026, #781: "Approve as drafted"), labelled design values in rules.yaml: one Arms is the equipment package for one 1,000-person recruit group, 12 Arms on 15 May 1948, IL 1m an Arms, 1 a recruit group, and 1 Attention for the buy order whatever the quantity (R-ARMS-001 to R-ARMS-003). Whether replacements consume it is open. Then decided (owner, 23 Oct 2026, "Replacements cost Arms"; #1510): trained recruits can refill a damaged formation, and each replacement group consumes Arms as recruit training does (R-ARMS-003); built under #1510 as R-TRAIN-004.
Food Available food supply. Production, imports, consumption and storage; stockpile or supply capacity.
Social cohesion (לכידות חברתית) National parameter describing cohesion in society. Proposed influences include housing, employment and shortages. Scale, thresholds and gameplay effects; effects of military decisions and events.
International Support National parameter describing support from other countries. Proposed influences include military decisions and events. Scale, thresholds and gameplay effects.

Population and units

Unit Defined role Open rule
Refugee Included as a population unit. Arrival, resettlement and transition to civilian.
Civilian Can take an employment slot or enter military or pioneer training. Job reassignment, housing use and return from trained roles.
Craftsman Generates more money than an ordinary civilian. How acquired; employment requirements and extra income.
Halutz or pioneer Builds map infrastructure and performs land improvement work. Work duration, resource cost, project commitment and simultaneous project limit.
Veteran pioneer Experienced pioneer unit. Promotion requirement and benefit over a pioneer.
Recruit Military unit after basic training. Combat strength, upkeep and training duration.
Veteran soldier Experienced military unit. Promotion requirement and benefit over a recruit.
Artillery Artillery unit with the working label Napoleonchik. Acquisition, crew, range, ammunition and combat role.
Armored car (Israeli) Israeli armored combat unit. Acquisition, armor, movement and combat rules.
Arab Legionnaire Unit representing an Arab Legion soldier. Equipment, movement, strength and behavior.
Palestinian militia Palestinian militia unit. Equipment, movement, strength and behavior.

Then decided (owner, 23 Oct 2026, "Two-way, keep training"; #1511): craftsmen, halutzim and veteran pioneers can return to civilian life and keep their qualification, and a qualified civilian can be reassigned to the trained role without training again; the rule is built under #1511 (R-QUAL-001 to R-QUAL-007).

Movement and civilian actions

The player can move a unit at once or set a go-to route whose next step runs at End turn. Units have an integer movement allowance and pay integer biome costs; built road and rail corridors may lower those costs. Lakes and the sea are impassable, stacking is limited, there is no zone of control, and there is no transport or embarkation. A unit with its full allowance may always enter one neighbouring land hex, whatever its cost; after spending points, it needs the full cost of the next hex. End turn waits until every military unit with movement points has moved, attacked, holds an order or is skipped for the turn (Q-MOVE-1 to Q-MOVE-5; owner, 23 October 2026, #1402 and #1398: "Now" for go-to, "No, strict like Civ VI", "Block like Civ" and "Approve, start building").

A civilian can be employed in an available city employment slot. A civilian can train in a military camp and become a recruit, or train in a Hakhshara (הכשרה) and become a Halutz. The source of a Hakhshara and whether the player builds one are open. Under gdd-0.3 the Hakhshara stays the way civilians become Halutzim (owner, 4 November 2026: "Keep the Hakhshara", #2484).

Progression

Two transitions are defined:

  • civilian to recruit, through basic training;
  • civilian to Halutz, through pioneer training;
  • craftsman, halutz and veteran pioneer back to civilian life, and a qualified civilian back into the trained role without training again (#1511, R-QUAL-001 to R-QUAL-007).

These transitions are open:

  • refugee to civilian;
  • civilian to craftsman;
  • Halutz to veteran pioneer;
  • recruit to veteran soldier.

Veteran roles are part of the roster, but their progression is not yet specified.

Open: does a unit represent one person or a group? The answer must determine how units occupy housing and jobs, produce income, consume food, train and suffer casualties.

Then decided (owner, 15 Oct 2026, Q-UNIT-1, "Take all recommendations"; #375): military units are at formation scale, one token per formation. A finished recruit cohort becomes one unit, and its Strength counts population units (R-UNIT-001, R-UNIT-003). A population unit is 1,000 people in the Historical MVP (owner, 1 Nov 2026, D2, "Approve all six (Recommended)"; R-CITY-007); Amir's 10,000 people a unit is for Open mode, when Open mode exists (D2 below). The gdd-0.3 catalogue's population.people_per_unit stores that 10,000, and synthetic gdd-0.3 fixtures read it (R-POP-001).

Map and locations

Locations specification

The MVP location roster, must-have and optional priorities, location-record requirements, historical placement rules and sources are defined in the Locations specification. Use that companion document when authoring named locations and their map data.

Terrain type (tile/hex type): new types TBD

For the MVP the terrain types are the eight biomes in hexes.json, each with an integer movement cost; lakes and the sea are impassable (Q-MOVE-1, decided by the owner on 15 October 2026; Military and combat). Only new terrain types beyond those biomes, and their extra properties, are TBD. They do not block the MVP or Phase 5's movement PR.

Terrain decision Status
New terrain/hex types beyond the eight biomes, their names and classification TBD
Which properties belong to a terrain type and which are separate hex attributes or overlays TBD
Movement-cost values and access rules for new types, within the approved movement framework TBD
Type-specific combat and defence values, farming and construction eligibility TBD
Whether projects change terrain type, and the permitted conversions TBD
Visual representation and the mapping from source geography to gameplay types TBD

No new terrain catalogue or numerical terrain modifiers are selected in this specification. Existing sourced map data is retained while these decisions remain open. Then decided (owner, 23 Oct 2026, "Freeze for MVP (Recommended)"; #1512): the eight biomes are the complete MVP terrain catalogue, with no terrain conversions; projects such as Dry swamp change project or site state, not a hex's biome. New types, overlays and conversions are deferred beyond the MVP.

The MVP terrain catalogue is therefore frozen at the existing eight biomes, with no new types or terrain conversions. Editable properties beyond the existing biome fields and final tile/hex presentation remain TBD. Workable land, prepared fields, roads, forts and authored location placement can be represented as explicit properties without inventing a replacement terrain taxonomy.

Map editor tool

Provide an internal authoring tool that lets designers inspect and change tiles/hexes and move named locations by dragging or entering hex coordinates. It must support undo/redo, show unsaved changes, and save and reload version-controlled map data with consistent logical and rendered placement.

The full requirements and acceptance workflow are in Map editor. Location identities, sourced reference coordinates, historical names, dates and review metadata remain attached to each location. Moving a location must identify affected designated sites and corridor endpoints without silently changing sourced route geometry. The saved authoring changes must survive map-data regeneration.

The editor's host environment, authoring-data format and exact editable hex-property list are TBD. New terrain types remain TBD as above. Campaign movement and construction continue to follow the simulation rules. Then decided (owner, 18 Oct 2026, "Unity editor window"; #1009): the host is a Unity editor window; edits are saved to content/map/overrides.yaml, applied last by map generation; editable properties are a hex's terrain and control and a location's position, while its id and sources stay.

Alignment with existing feature decisions

The location roster sets map-production priorities. It does not remove existing supported places, create a city economy for every marker, or make every location a required capture or founding objective. The detailed city, founding, corridor, military and settlement-control decisions remain applicable.

  • Keep Tel Aviv and Jaffa as distinct map locations while retaining the approved combined Tel Aviv–Yafo city economy in Cities and absorption.
  • Keep the Rishon LeZion winery; Zichron Ya'akov's additional industry opportunity has no new balance values or automatic winery implementation.
  • Keep the Mefalsim founding slice and its objective. Historical founding and opening dates are reference dates; designated-site availability follows Build yishuv, allowing earlier player completion.
  • Use sourced history for starting and reference control, and simulation state for ownership during a campaign. The map roster does not select the curated settlement-control target list or introduce enemy reinforcements.

Cities and construction

City attribute Meaning Open rule
Housing capacity How much population the city can house. People per capacity point; treatment of overflow.
Housing condition The quality or condition of available housing. City average or per building; effects and improvement rules.
Employment slots The number of available jobs. Worker types, income and effects of unemployment.

City projects

Housing and industry, including specialized industry, are city projects. The player selects and starts these projects in a city.

City project Defined effect Requirement
Industry Provides employment slots. A permitted building site; costs and build time open.
Housing Provides capacity, improves conditions, or both. A permitted building site; housing types open.
Specialized industry Adds a location-dependent industry. City has the relevant local resource or area. A winery requires areas for grapes.

A city has both capacity and conditions: adding more room and improving the quality of existing housing are separate development choices. The method for assigning residents to housing is open.

Pioneer work

Building is allowed only at designated spots. A new yishuv uses the name associated with its designated site. The player chooses whether and when to develop an available site.

Pioneer action Target or result
Build road Construct a road along a designated corridor. Costs and construction duration remain open.
Build railroad Construct a railway along a designated corridor. Costs, duration and operating requirements remain open.
Plow fields Prepare agricultural land. Food yield and required ongoing labor remain open.
Dry swamp Improve a wetland area. Completion effects and later land uses remain open.
Build yishuv Found a settlement at a designated spot, using that spot's name.
Build military training camp Create a military training location at a designated site. Training capacity remains open.

Then decided (owner, 17 Oct 2026, "take all of the plan's recommendations"; #782): one road segment costs IL 2m and takes 6 turns; one rail segment costs IL 4m and takes 6 turns. These are labelled design values (Q-COR-6).

Military actions and settlement control

Soldier action Defined intent Open rule
Fortify position Prepare the current position for defence. Cost, duration, persistence and defensive benefit.
Hold position Remain on sentry duty at the position. Protection area, interception and upkeep.
Attack Engage an enemy target. Valid targets, range, combat resolution and losses.

Recruits and veteran soldiers use the infantry action set. Artillery has a separate combat role whose orders and rules are open. Enemy combatants and settlement residents require distinct states in the settlement-control system.

After capturing an enemy city or village

The player selects one of three outcomes:

  • Raid and withdraw: clear hostile forces, then leave. Duration and effects on future hostile presence remain open.
  • Occupy: retain control of the location and begin an occupation period. Required forces, costs and local effects remain open.
  • Deport: remove settlement residents. Which residents are affected, their destination and the resulting settlement state remain open. Deportation and razing need separate rules: moving residents does not specify whether buildings are destroyed.

After X turns of occupation, the player chooses to install a puppet regime or annex the settlement. X is unset. A puppet regime provides indirect control; annexation incorporates the settlement into the player's territory. Population management, jobs, housing, defense responsibilities and resource access under each outcome are open.

Then decided (owner, 18 Oct 2026, Q-PUP-1 (c), #783; 22 Oct 2026, Q-OCC-3, #1324; 24 Oct 2026, in the coordinator session, "1520: do this: 1. When the player annexes a town whose residents stayed (Acre, Nazareth), how many people, homes and jobs join the game? - a. The same rule as the 12 starting cities: a sourced resident count you approve. (Recommended) 2.b 3.a"; #799): no puppet regime in the MVP. X is six monthly turns. When an occupation ends the player annexes or withdraws. The residents of a fled town are recorded as fled when it is captured, and the record of the flight stays after a Raid. A town emptied by flight adds land only. A town whose residents stayed (Acre, Nazareth) adds one city by the starting-city rule, from a sourced resident count the owner approves. An annexed town stays Israeli for good, with no upkeep and no unit that has to stay (superseded in part: the owner, 8 November 2026, answering the questions on #2955: "Can be taken"; R-CTRL-006). For a town whose residents already fled at capture, Deport stays listed and is refused with its reason (OWNER QUESTION 4 (a), owner, 24 Oct 2026, "Hide it, button explains (Recommended)", #799). Rules R-CTRL-014 to R-CTRL-017. Then changed (owner, 1 Nov 2026, "3 turns (27 Oct)"; 1 November 2026 answers): X is three monthly turns, as the owner had ruled on 27 October 2026 ("3 turns, keep upkeep", #1712). mvp.occupation_turns reads 3 (R-CTRL-012) since #2123; the upkeep is unchanged.

Open: when is a settlement captured, what constitutes enemy control, and can an occupying force withdraw before the timer ends? Capturing enemy soldiers earns the bonus specified in the MVP objectives. Settlement-control rewards and political penalties remain open.

Then decided (owner, 18 Oct 2026, Q-CAP-1 (a) and Q-CAP-3 (a); 21 Oct 2026, #796; 23 Oct 2026, OQ-2, "Instant"): a target under enemy control is one listed in mvp.enemy_held_localities; it is captured at once when Israeli military units stop on its hex and no enemy military unit is there; only enemy military units are combatants (R-CTRL-004). Then decided (owner, 18 Oct 2026, Q-OCC-2 (a), #783): withdrawal before the occupation timer ends is allowed and becomes a Raid (R-CTRL-013).

Events and consequences

The player responds to events by selecting an outcome that produces a bonus, a penalty, or both. Effects can target money, arms, food, Social cohesion and International Support. Effects on units, cities or project availability are a proposal. Completed MVP objectives also trigger the historical event cards described at the beginning of this document. The campaign runs from 15 May 1948 to 15 January 1952: 44 monthly turns. The calendar boundary follows the owner's latest PR ruling (checked 2026-10-17). The real-time play target is in balance.md.

Each event needs a trigger, readable context, available options and their consequences. Open: event frequency, mandatory versus optional events, delayed effects, and how much the player can see before choosing.

Then decided (owner, 17 Oct 2026, "take the recommendations"; #784): events use windows and hard anchors, with at most three soft events per turn; an unanswered event is delegated; the MVP has no delayed effects; and each card shows every effect of every option (R-EVT-001 to R-EVT-005, docs/rules/mvp.md).

The player manages the establishment of the state through population, work, settlement, infrastructure, immigration and war. The map supports direct hex-to-hex orders and the retained per-city civilian management rules. Historical events explain the period and react to the player's situation; they must follow the existing content policy, writing guide and review gates.

Historical dates, unit identities, named places and claims in event text require sources. Game balance values and hypothetical alternatives must be identified as design assumptions. The core objectives are to establish the designated new settlements, complete the designated transport corridors, absorb immigration, and reach the armistices. Their exact completion tests, grouping and score ownership are in objective-card.md. A campaign can reach its end without completing every objective. Under gdd-0.3 the retained defeat is the economic one (Money and Food exhausted), and losing a city or region alone does not end the game (rules; ministers-events-end.md). Amir's proposal to make every terminal defeat TBD was declined by the owner on 30 October 2026 (conflict decision).

Production decisions to resolve

Designated building sites and transport corridors bound the locations and routes we must support. Population scale, project timing and the effect of terrain on movement remain major decisions for map production.

Decision Why it changes production
MVP locations and map scale The must-have and optional location roster is specified in locations.md. Use the existing grid in Map units; any required extent or resolution change and the handling of closely spaced locations remain open. Then decided (owner, 21 Oct 2026, 4.4 km; #1183): the grid keeps its extent and its hexes become 4.4 km (circumradius; 7.6 km centre to centre): 1,419 hexes, 1,118 of them land, baked in #1183 (plan).
Terrain type (tile/hex type) MVP: the eight hexes.json biomes with a movement cost per biome (Q-MOVE-1, decided). TBD: any new types, their catalogue, classification, visuals, extra properties, construction rules and terrain conversions. Then decided (owner, 23 Oct 2026, "Freeze for MVP (Recommended)"; #1512): no new types or conversions in the MVP.
Map editor tool See Map editor for hex editing, location moves, undo/redo, save/reload, regeneration and reference validation. Host environment, authoring format and editable-property list remain TBD. Then decided (owner, 18 Oct 2026, "Unity editor window"; #1009): a Unity editor window saves content/map/overrides.yaml, which map generation applies last; editable are hex terrain and control and location position, while location id and sources stay.
Road and rail corridors Routes follow designated corridors. Each corridor needs predefined route geometry and construction states. The corridor list, costs and duration remain open. Then decided (owner, 17 Oct 2026, "take all of the plan's recommendations"; #782): the corridors are the 1949 Haifa to Tel Aviv rail link, the Burma Road and the Tel Aviv to Netanya coastal road. One road segment costs IL 2m and takes 6 turns; one rail segment costs IL 4m and takes 6 turns. These are labelled design values (D-D7, Q-COR-6).
Unit population scale A person or a group changes unit count, housing and job assignment, selection, movement and casualty representation.
Population role model Changing one unit between jobs and training differs from separate worker pools. Decide reassignment and return to civilian life. Then decided (owner, 23 Oct 2026, "Two-way, keep training"; #1511): trained civilian roles can return and be reassigned, keeping their qualification.
Work and training time Instant actions and multi-turn projects require different feedback, commitment rules, cancellation and progress displays.
Food and arms supply National pools need fewer logistics rules. Local storage and supply routes add transport, shortages and vulnerability to disruption.
Settlement control Occupation, indirect rule, annexation, displacement and destruction require explicit population, ownership and building states.

Document authority

This document owns scope, the authority map and deferred decisions. The linked feature file owns the corresponding rules. balance.md is the only active catalogue of numerical design values; feature files reference its keys rather than maintaining their own cost tables. Historical dates and factual evidence remain with the relevant feature or content record.

The feature index explains the file structure. The rule-ID index preserves links from existing tests and identifies implementation contracts requiring migration. Old plans are implementation history, not additional rule owners. The original GDD v0.1 PDF is a historical reference; it is not a second active GDD.

Subject Authoritative document
Numerical values, prices, rates, capacity, starting state Balance
Population identity, professions, reception, courses, military conversion Training and population
Regions, civilian assignments, housing, construction, workshops Cities and regions
Money, Food, Arms, imports, immigration, upkeep settlement Resource layer
Movement, combat, military XP, forts, enemy AI, truces and prisoners Military and combat
Region loss, evacuation, occupation, annexation and withdrawal Settlement control
Designated site projects and field preparation Build yishuv
Road and railway construction Corridors
Objective tests, completion cards and scoring Objective card
Resolver sequence, saves and migration Game loop
Calendar implementation and event windows Monthly turns
Events, government integration and campaign ending Ministers, events and end
Fixed camera and internal map authoring Map editor
Named places, aliases, inclusion priority, facility roster and source notes Locations
Route geometry and evidence Routes
Unit artwork and historical placement anchors Units

MVP completion rules

The MVP years, monthly turns and three objectives are fixed above. These remain to decide:

  • the map extent, starting unit counts, event count and the session's target play time (asked of Amir, #856); the span is 15 May 1948 to 15 January 1952, as above; Then decided (owner, 18 Oct 2026, "60-90 minutes"; #813): a full session targets 60 to 90 minutes, about 2 minutes a turn. Then changed (owner, 30 Oct 2026, "120 (data wins)"; #1687): a full session targets 120 minutes, matching gdd03-balance.yaml. Then decided (owner, 30 Oct 2026; conflict decision): Historical mode keeps the sourced content/map/units_1948.yaml seed (Q-START-1); parameter A applies only to non-Historical modes.
  • when the war-survival objective is complete, which immigrants must have housing and employment, and which new yishuvim are required.

Each objective needs a specific historical event and reference date for the completion card. For ongoing processes such as immigrant absorption, choose a defined milestone with a sourced date. Bonus amounts, the timing formula, defeat conditions and whether all objectives are required to finish the MVP remain open.

Then decided (owner, 14 Oct 2026, D-B2 and D-B6; #456): each completed objective is worth 100 points, and finishing one early adds 5 points per calendar month, capped at 60; both are tunable design values. Then decided (owner, 15 Oct 2026, D-B5, "Take the recommendations", #568, and Q-WAR-5, #375; 17 Oct 2026, Q-DEF-1 and Q-DEF-3, #784; 18 Oct 2026, Q-DEF-2, "3 turns", #784): finishing the MVP does not require every objective, and coalition collapse is off. The game is lost when Money and Food are both exhausted at three consecutive turn ends (Money at or above the debt ceiling, Food at 0). Under gdd-0.1 it is also lost when an enemy unit holds one of the player's city hexes at a turn end, truces included (R-END-001 to R-END-003, docs/rules/mvp.md). Then decided (owner, 30 Oct 2026; conflict decision): keep the recorded defeat rules: under gdd-0.3 the economic defeat (Money and Food exhausted) stays, and losing a city or region alone does not end the game (rules; see Final defeat conditions).

Minister selection is a planned TBD mechanic with player-chosen ministers. The role of coalition, Attention, diplomacy and national policy systems in this core loop remains open. Then decided (owner, 23 Oct 2026, "Yes, complete (Recommended)"; #1513): R-MIN-001 to R-MIN-003 and Cabinet.Appoint are the complete MVP minister mechanic.

Population and management direction

The same population unit retains its identity across civilian work, training, military service and demobilisation. Civilian profession and military experience are separate attributes. Map anchors for historical formations do not create additional population units. Amir's proposal, declined by the owner on 30 October 2026 (conflict decision): population units would be assigned through regional capitals.

Amir's proposal, declined by the owner on 30 October 2026 (conflict decision): player regions would pool civilian housing and employment and use prepared regional farmland. The retained per-city rules and the sourced annexation-resident rules remain authoritative.

Relationship to the existing design

Amir's #1668 proposed removing automatic borrowing and automatic Food refill while making Money and workers the construction constraints. The owner's 30 October 2026 conflict review (conflict decision) did not rule on this. On 1 November 2026 the owner kept main's economy for the MVP (D1, "Approve all six (Recommended)"; 1 November 2026 answers): the operative rules are R-MONEY-003 and R-FOOD-002 (docs/rules/mvp.md), and Amir's proposal is post-MVP.

The existing units-in-play design describes units as a presentation layer with no individual orders. This GDD calls for units, jobs, training, construction and settlement control to affect gameplay. Those rules must become simulation state and actions under the existing deterministic simulation architecture.

Reference files from the repository snapshot reviewed on 12 October 2026:

  • Original Statecraft Israel design specification
  • Units in play design and owner rulings
  • Roads and railways implementation notes
  • M3 scope rulings

Map, locations and presentation

The complete must-have and optional roster is maintained only in locations.md. Inclusion does not automatically create a managed city, a capturable target, a new population unit, or an operating facility. Military camps are distinct selectable locations, highlighted and enlarged for readability; reception camps are a separate facility category.

The camera has a fixed viewing direction and pitch, supports pan and dolly in/out, and does not orbit. Unit movement is turn-based between hexes. The internal editor changes tiles and moves locations while preserving identifiers, source coordinates and regeneration-safe overrides; see map-editor.md.


Owner rulings, 2026-10-12

  1. Deport outcome: honest cost, no reward. It stays as a historical possibility but never pays. It carries large Social cohesion and International Support penalties, creates refugees, has permanent consequences, and is shown soberly through sourced event cards. CONTENT_POLICY §4 is updated to say how this is handled ("no mechanic may reward violence against civilians, from any side").
  2. Adoption: spec and impact plan first. The GDD is committed as the design of record and analysed against the current code. The phased build plan and open decisions are proposed, and the owner approves before any code changes. Visual and promo work continues meanwhile.

Owner rulings, 2026-10-17

  1. Map and location additions (B1-B7): approved as written (#856): the location roster (approved as 31 must-have and 16 optional; review edit A2 then moved Hadera and Tiberias, already managed cities, to must-have, giving 33 and 14), the West/East Jerusalem split, the new location kinds (reception camp, forts, passes, bridges), the Arab-held towns on the map but not as targets, the Zichron Ya'akov industry, the map editor as a new tool, and the existing grid. Then decided (owner, 21 Oct 2026, 4.4 km; #1183): the existing grid's hexes become 4.4 km (were 5 km): same extent, 1,419 hexes, 1,118 of them land (plan).
  2. Four further additions: approved (#856): Kiryat Shmona and Beit Shemesh as designated founding sites, Nir Am's infrastructure-protection objective, Umm Rashrash (future Eilat) as an end-of-war milestone, and Zichron Ya'akov as a must-have location for its vineyards and winery. The sensitivity sign-off for Kiryat Shmona and Beit Shemesh is open (#782); Phase 4's site list follows once it is given. Then decided (owner, 18 Oct 2026, "Part of objective 3"; #1006): the Negev water line that began at Nir Am must stay in Israeli hands until the armistice with Egypt on 24 February 1949; its card gives the sourced 1947–48 pipeline history, with checked: dates and a person's fact check, and its points are a labelled design value for the balance pass. Then decided (owner, 18 Oct 2026, "Bonus inside the war"; #1007): objective 1 gives a bonus when a player unit reaches the Umm Rashrash hex before the war ends; it does not change when the war objective completes. The card is the Ink Flag, 10 March 1949 (Operation Uvda), sourced with checked: dates and a person's fact check; points are a labelled design value for the balance pass.
  3. Session span (Q-DOC-1, #784): the MVP is 44 monthly turns, 15 May 1948 to 15 January 1952. The session's target play time is open, asked of Amir (#856). Then decided (owner, 18 Oct 2026, "60-90 minutes"; #813): a full session targets 60 to 90 minutes, about 2 minutes a turn. Then changed (owner, 30 Oct 2026, "120 (data wins)"; #1687): a full session targets 120 minutes, matching gdd03-balance.yaml.

Decision provenance and implementation status

  • The Arms request and real-time play request, checked 2026-10-17, are addressed by the balance catalogue and population/training rules.
  • Considered and declined (owner, 30 Oct 2026; Upkeep conflict, option A; conflict decision): Amir's #1668 proposed housing-only upkeep deterioration. For Amir's reception before civilian work, the review did not rule; on 1 November 2026 the owner kept R-CITY-004 (docs/rules/mvp.md) with "Keep R-CITY-004 (Recommended)", so Amir's reception turns are post-MVP; main has an inactive gdd-0.3 reception fixture (docs/rules/mvp.md:107).
  • Agreed in the balance catalogue means an explicit interview decision or a retained approved baseline. Unresolved numbers remain TBD rather than receiving assistant-supplied defaults; the values this revision left open (owner) were answered by the owner on 1 November 2026 (1 November 2026 answers).
  • Existing content/ values, tests, saves and code still describe the earlier implementation where they conflict. Implementation work must migrate them together, update rule-ID coverage and deliberately review hash changes. This documentation revision does not silently change that code or its data.

30 October 2026 conflict decisions

On 30 October 2026 the owner reviewed all 13 conflicts between the recorded design and Amir's #1668 proposal and chose to keep every recorded ruling. Each declined note in this additive design links here and covers only a proposal that is option B of one of those 13 conflicts; it preserves the adjacent ruling rather than reopening or replacing it. A #1668 proposal outside the 13 conflicts is not declined: its note says the review did not rule on it and names the operative main rule or catalogue entry, or says open (owner) where main has none.

Conflicting #1668 mechanics and catalogue entries retained for traceability are non-operative. The recorded ruling beside each declined note remains authoritative; an unresolved value is open (owner) and must not be inferred from the declined proposal. On 1 November 2026 the owner ruled "30 Oct wins for the MVP (Recommended)": these declined proposals are post-MVP design, kept for Amir to develop, and the remaining open (owner) values were answered (1 November 2026 answers).

1 November 2026 answers

On 1 November 2026 the owner approved an answer to every open GDD 0.3 question: the numbered questions on #1668, the follow-ups in the GDD 0.3 issues and the values this revision marked open (owner). The six larger decisions D1-D6 were approved with "Approve all six (Recommended)", the occupation length with "3 turns (27 Oct)", the other answers with "Approve all 79 (Recommended)", and each Medium- and Low-confidence answer one by one (for example "0.35, your 15 Oct value (Recommended)", "1.5:1 in gdd-0.3 (Recommended)", "10 per unit, main (Recommended)" and "Keep the national rate (Recommended)"). Each question, quoted exactly, with its answer and the rule behind it, is in the approved answers on #1668 (checked 2026-11-01). The IDs below (D1, Q23, O7, 27M-16 and so on) are that comment's.

MVP and post-MVP. The owner also ruled "30 Oct wins for the MVP (Recommended)": where Amir's 0.3 design conflicts with the 30 October rulings, the MVP follows those rulings, and Amir's text stays in these files as post-MVP design for Amir to develop later. It is not dropped. A declined note in a feature file therefore marks post-MVP design, not a rejected idea. The owner kept refugee conversion on the next housing step with "Keep R-CITY-004 (Recommended)", so Amir's six reception turns before civilian work are post-MVP too.

ID Decision Approved (owner, 1 November 2026: "Approve all six (Recommended)")
D1 MVP economy Keep main's economy: per-head tax and spending (R-MONEY-001), every GDD cost borrows its shortfall automatically (R-MONEY-003, R-TRAIN-001, R-SITE-001, R-ARMS-002) (Arms purchases past the debt ceiling are refused instead, #2198, and arms-workshop cycles past it wait unpaid, owner, 2 November 2026: "Refuse past the ceiling (Recommended)"; later rulings), the monthly Food import refills to cover_months (R-FOOD-002), and BuyArms delivers at once (R-ARMS-002). Amir's 0.3 economy (income only from jobs, credit only for Food and Arms imports, no refill, next-turn ship deliveries) is post-MVP.
D2 Population scale and starting inventory The Historical MVP keeps main's start: census cities at 1,000 people a unit (R-CITY-007), Money 20 (treasury_start), Arms 12 (arms_start), Food at cover_months (3 months of need) and the formations from content/map/units_1948.yaml. Amir's 65 units at 10,000 people a unit, Money 25, Food 10, Arms 3 and farmers 5 / 10 / 5 are for Open mode, when Open mode exists.
D3 Professions Two-way professions for the MVP (R-QUAL-001 to R-QUAL-007, #1511): a qualified civilian can return and be reassigned, and a Train order can take a qualified civilian, who then loses the qualification (R-QUAL-006). Amir's lock at the first qualified level (Q9) is post-MVP.
D4 Historical army Historical keeps the units_1948.yaml seed: starting strengths (R-UNIT-006), dated arrivals (R-UNIT-009) and growth only by replacements (R-TRAIN-004). No manning modifier and no scripted draft in Historical.
D5 Southern Coast and Negev farmers One opening housing place in each region for its farmer, once a sourced research note confirms a Jewish settlement in each region on 15 May 1948. The places are Nir Am and Nirim (later rulings).
D6 An Israeli city while an enemy unit holds its hex Its jobs pay nothing and its Food production and projects pause; its people stay. On retaking, everything resumes and nothing is deleted. Amir's region capture and automatic evacuation are post-MVP.
ID Value this revision had as open (owner) Approved answer (owner, 1 November 2026)
O1 Fortify defence bonus +25% (main's 125%, R-ORDER-002); one turn to set.
O2 Hold effect No defence bonus, own hex only, no interception (R-ORDER-003).
O3 Combat result bands and loss granularity Main's mvp.combat_table (R-COMBAT-002, R-COMBAT-003); losses fall one population unit at a time on the strongest unit.
O4 combat.enemy_attack_ratio 1.5 under gdd-0.3 ("1.5:1 in gdd-0.3 (Recommended)"); gdd-0.1 keeps 2:1 (R-ENEMY-003).
O5 combat.artillery_range 2 hexes (R-COMBAT-007).
O6 prisoner.food and the shortfall 1 Food per held unit a turn; each unit of Food missing costs 0.01 Social cohesion (R-POW-002).
O7 prisoner.return_points 10 per population unit returned, main's value ("10 per unit, main (Recommended)", R-POW-004), not 5 a cohort.
O8 Starting reception and training-centre host Kiryat Shmuel, Haifa, hosts the one starting training centre (owner, 26 October 2026, "Kiryat Shmuel, Haifa").
D2 start.money, start.food, start.farmers Historical MVP: Money 20 and Food at cover_months; start.farmers is not used (census cities). Amir's 25 / 10 and 5 / 10 / 5 stay for Open mode.
Occupation occupation.turns 3 turns ("3 turns (27 Oct)"). mvp.occupation_turns reads 3 (R-CTRL-012) since #2123.
Post-MVP transit.cost, reception.queue_cohesion_loss and port-bed queues, automatic and route-blocked evacuation, the editor's region-membership and workable-land fields, editor facility dependencies Not in the MVP. There is no transit and no port queue, a held city follows D6, regions come from sub-districts and fields are authored data (Q36), and facilities are per city.

Other answers, by area (all approved on 1 November 2026; the comment gives each one's reason):

  • Economy and Food. Foreign currency stays the internal ledger under Money, so the sourced 1951 crisis still cuts the Food import (Q2) (owner 2 Nov, #813: the player may convert up to $4m a month of foreign currency into Money during the war, $100m in total, via one foreign-currency readout; note that a top-bar foreign-currency meter already existed on main, see #2204; later rulings). A bond or loan card adds its Money and the same principal to Debt, with no interest or schedule, and its figures must be sourced (Q5). Every deficit is borrowed (Q21, Q24). debt_ceiling (IL 250m) is only the "Money exhausted" threshold of the economic defeat; no order is refused at it (Q22) (except Arms purchases: refused past the ceiling, owner 2 Nov, #2198, R-ARMS-002; and arms-workshop cycles: they wait unpaid past it, owner 2 Nov, #1701 OQ4, "Refuse past the ceiling (Recommended)", R-ARMS-006; later rulings). Debt starts at 0, and a Money unit is IL 1m (Q23). The economic defeat is Debt at or above the ceiling and Food at 0 for defeat_turns (3) turn ends in a row (Q25), read before this turn's borrowing (Q26). Purchases and unaffordable courses borrow automatically (Q56, 27M-6). food_supply stays the 0-1 readout (Q6). A unit with strength 1 or more never counts below 1 after a modifier (Q7). BuyArms is a waiting order, editable or withdrawn at no cost until End turn and final after it; there are no player Food purchases in the MVP (Q45-Q47).
  • Events and indicators. The seven Attention, passive-budget and refill cards lose only their Attention effects under gdd-0.3 (Q1). Rationing and ma'abarot cards stay indicator-only (Q3). Events may write Money, Arms, the Food stock, Social cohesion and International Support; housing condition and food_supply are readouts (Q4). For event effects the owner's ruling of 4 November 2026 overrides Q3 and Q4: "allow cards to effect food supply and housing readout, get these cards into the game turned on". austerity_1949, forex_crisis_1951, iraqi_exodus and maabarot_policy run under gdd-0.3 with their Food supply and housing writes, and their rationing/maabarot policy writes (maintainer reading: the policy writes come with the cards, #2483). start.cohesion and start.support are opening values only, and the rationing and security links stay (Q17, Q18). The #1716 snapshot lands before the indicator changes, with no regional workforce helper (Q19).
  • Population and courses. Commands on "N units" take ascending population ids; a returned captive keeps their id and military qualification, comes back unequipped and joins the nearest friendly city as a civilian (Q10, 27M-20). Event grants and arrivals take new ids as refugees in a city, and natural increase stays the national rate, 0.0169 a year ("Keep the national rate (Recommended)", Q11). A course occupies its people from its first turn (Q43(a)); they are released in the turn its last course turn counts and can be assigned from the next planning, or at once on cancellation, and work starts the turn after (Q43(b), Q43(c)). One veteran teacher and one pupil per centre, the teacher housed in the centre's city (Q42). A cancelled or slot-losing course is cancelled like CancelTraining, people return as civilians, Money and tools are not refunded and Arms return to the pool (Q44, Q52, 27M-3, 27M-4). Graduates join their city's civilians and may re-enrol at any time (27M-5). A course occupies the person for any other job, course, pioneer work or military order, without changing their housing (#1697 follow-up). The novice craftsman label starts with the craftsman course and ends on cancelling (#1698 follow-up). Workshop work by a novice changes no qualification (Q55). A draft withdrawn before End turn leaves nothing to settle (Q53). Later, on 4 November 2026, the owner kept the Hakhshara as the pioneer path under gdd-0.3: "Keep the Hakhshara" (#2484).
  • Work and fields. A worker works in their own city and farmers live in the region they farm (Q27). Employed means civilians and craftsmen in job slots over civilians plus craftsmen, and work_lifts_cohesion stays (Q35). Starting fields are the authored list from the owner-approved per-region split of 27 October 2026, with no numeric threshold (Q36); the 20 farmer / 8 Industry split is symbolic and kept (MAN-1). Only an Israeli-held hex can be farmed (Q37). A retaken field resumes through the city's job default (27M-1). Farming counts whole months from the month's snapshot (27M-2). A workshop reserves its cycle at the monthly production step, repeats automatically each month while staffed ("Automatic monthly (Recommended)"), takes any free civilian at the worker's cost tier, and loses progress and paid Money on cancellation (27M-11 to 27M-14). New housing and repairs follow the Money-plus-work rule for city projects, and repairs wait for #1700 (#1703 follow-ups a and b).
  • Housing, absorption and camps. Housing effects are measured after the step's arrivals become civilians (27M-15). Every city starts at the one housing condition 0.35 ("0.35, your 15 Oct value (Recommended)", 27M-16, R-HOUSE-001). Housed means civilians, craftsmen, recruits and groups in training (27M-18). Absorption's overflow limit is national (27M-21) and counts employment at turn end (27M-22). Refugees cannot train until they become civilians, so 27M-23, Q54 and 27M-10 do not arise in the MVP. Training is ordered in the camp's city, with no travel (27M-7). A formation pays military upkeep from the turn it graduates (27M-8). After a cancellation or camp loss, people go to their city as civilians without a job (27M-9). Schneller and Tel HaShomer operate from the start, the other military camps are build sites, every camp uses military.camp_capacity 50 population units (#2112: #1668's 5 places at 10,000 people a unit, scaled to D2's 1,000), and the reception site is Kiryat Shmuel, Haifa (27M-25).
  • Military. Arms equip new soldiers in training and replacements; attacks and artillery spend none. A recruit course cannot start without its Arms, and all training stays in 0.3 (ARMS-1 to ARMS-3). Artillery has 2 movement points and infantry terrain costs (Q12). Every kind: fort record is a permanent fort (Q13). Under gdd-0.3, veterancy comes from combat experience: every unit, artillery firing alone included, earns military.combat_xp_gain (1) for each engagement it survives, experience stops at veterancy (military.combat_xp_full, 5), and service time is a statistic; gdd-0.1 keeps R-UNIT-004 (Q14 to Q16). Prisoner points are scored only when a front's exchange card returns them; prisoners taken after that card stay held, with no points (27M-19). The armistice quiet-turn count runs per front from the scenario start, no offer comes before the 15 December 1948 turn, a quiet turn has no engagement involving that front's units, and a refused order does not break it (Q48); two full quiet turns must follow a refusal (Q49). No manning in Historical (MAN-2, D4).
  • Pioneers and the editor. A PioneerWork order does not move the unit, so a pioneer works and earns experience from the turn it starts (Q50). There is no pause: stopping ends the work, and progress and Money are lost (Q51). Pioneer work borrows its shortfall (Q57, D1). Broken corridor endpoints, force anchors, target bindings and objective bindings block export, and visual and label offsets only warn (Q58). Offsets use axial hex (q, r) plus metres from the hex centre and stay inside their own hex (Q59).
  • Post-MVP ("30 Oct wins for the MVP (Recommended)"). Regime taxes and puppet regimes (Q28 to Q33): an annexed town that stayed earns ordinary city income and a fled place pays nothing (R-CTRL-016). Ship immigration (Q38, Q39, #1695): arrivals come from the CBS series (R-CITY-003). Port and reception queues and bed reservations (Q40, Q41, #1696, #1723): refugees wait in their cities (R-CITY-004). Amir's import-only credit (Q20, Q57), no Food refill, ship purchases and profession lock (D1, D3).

Later rulings, 1 November 2026

Later on 1 November 2026 the owner answered the questions the approved answers left open and ruled on the D5 places and the operation cards. Each answer is quoted exactly.

Question Owner's answer (1 November 2026) Rule
GDD 0.3's per-unit rates at D2's 1,000 people a unit "Main's base x 0.3's tiers (Recommended)" Main's per-unit rate is the base and 0.3's tiers are multiples of it: Industry income 1x / 2x / 3x the R-CITY-002 job income (as R-CRAFT-002 does for craftsmen), farmer Food 2x / 3x / 5x field_food_per_turn, and counts sized in 10,000-people units 10x (military.camp_capacity 5 becomes 50 units). workshop.cost is Money per Arms and stays. All are labelled design values, and a balance playtest follows (#2112).
Reception in the MVP "No reception-bed layer (Recommended)" The reception camps are map records, the training centre is an ordinary facility in Kiryat Shmuel, Haifa, and reception beds with their six-turn progress are post-MVP (#1696).
Send home under gdd-0.3 "Keep R-UNIT-005 (Recommended)" Send home stays the only way home, after the front's armistice (R-UNIT-005); Amir's demobilisation at a camp is post-MVP (#1699).
Housing repair price "Fixed price 0.5 Money + 1 work" A repair costs 0.5 Money and 1 work and raises the city's housing condition by 10 percentage points. The price is a labelled design value (#1700, #1703).
Historical starting farmer tiers "Amir's 1:2:1 ratio per city (Recommended)"; the rounding rule: "all approved"; 7 November 2026, "Per host, 1/18/1 (Recommended)" Each host's starting farmers are a quarter novice, half trained and a quarter veteran, a labelled design value. The split runs per host, not per census city, which gives 1 / 18 / 1 nationally across the 20 opening fields' hosts (#1689). When a host's count is not a multiple of 4, the split uses the largest remainder with ties to trained (5 farmers: 1 / 3 / 1); at 2 more than a multiple of 4 the leftover unit ties between novice and veteran, and it goes to trained (6 farmers: 1 / 4 / 1; owner, 6 November 2026, "Trained: 1/4/1 (Recommended)", #2465), and every host's total stays exact (#1717, rounding). Amir's 5 / 10 / 5 stays for Open mode (D2).
D5 places Southern Coast: "Nir Am (Recommended)"; Negev: "Nirim, add it to the map (Recommended)"; for Nirim: "Optional (Recommended)", "Israeli at the start (Recommended)" and "Agent checks are enough" Nir Am is the Southern Coast's opening housing place and Nirim, at its 1948 site at Dangur (today's Nir Yitzhak), is the Negev's. Nirim is an optional location, Israeli-held at the start. Agent checks of the sources replace D5's person's check for these places (#2113, #2136).
Operation-card orders and start placement 1 November: "military openrations must have unit orders"; Latrun: "Harel at Sha'ar HaGai (Recommended)"; Dani: "Kiryati to Ramle (Recommended)". #2543 (owner, 4 November 2026): "A military operation can only get underway if you have the required units in place (you cant fight in latrun in you dont have military units there)." For #2543 the owner chose the options labelled "In the same region", "Both rulesets (Recommended)" and, later, "Player must move them"; on a delegated card: "Postpone and explain to the user which units need to move where. Postpone until they are in the right area and if the operation is still relevant" (as recorded on #2543, 4 November 2026). #2544 (owner, 4 November 2026): "In addition, deciding on a military operation makes the units do what the operation describes (shown to the user all the moves, attacks etc)" and "Also if a user tries to cancel orders of a unit that is in an operation, a message would tell him that this will cancel the entire operation if he choses to do this"; for #2544 the owner chose the options labelled "Both rulesets (Recommended)", "Continue the rest (Recommended)" and "Only remaining orders (Recommended)". Every military-operation option has sourced unit orders and an authored set of existing regions. The agent-recorded #2543 scope says its ordered starting units must each be on a hex in one of those regions, with no pre-positioning or credit for starting regions. An unmet direct choice is refused unchanged. An unmet delegated choice is postponed with the required moves explained, consumes no draw, and is redrawn later; it lapses without a choice or effects when its window closes. Orders apply under gdd-0.1 and gdd-0.3 (R-ENEMY-005, R-ENEMY-007; #2087, #2543). A decided operation's orders may also be sourced attacks, fought through the player's own attack in list order; a refused action leaves the later ones to run. A player's order that takes a unit off its operation's go-to cancels that operation's remaining orders, keeping the moves and fights already done (R-ENEMY-008, R-ENEMY-009; #2544).
Movement preview "I am talking about an arrow showing which tiles the unit is going to move to. this needs to be for israeli units only" Choosing where an Israeli unit moves shows an animated arrow over the tiles it will move through. Enemy units get no arrow (#2134).
The 1949 armistice-lines overlay "On by default (Recommended)" The 1949 armistice-lines overlay shows in every run, with no URL flag; a release build draws only the lines the owner signed off (#2195).
The desktop Quit button Hebrew label: "יציאה is right (Recommended)"; Settings placement: "Own row at the bottom (Recommended)" Desktop builds show Quit on the start screen and in its own last row in Settings, labelled "יציאה" in Hebrew; the browser build hides it (#2188).

Later rulings, 2 November 2026

On 2 November 2026 the owner ruled on Arms bought on credit, a lever on the war debt and the armistice-lines overlay. Each answer is quoted exactly.

Question Owner's answer (2 November 2026) Rule
Arms bought past the debt ceiling "Refuse buys over ceiling (Recommended)" An Arms purchase whose borrowing would take Debt past debt_ceiling (IL 250m) is refused with a clear reason. This overrides Q22's "no order is refused at it" for Arms purchases only; every other cost still borrows its shortfall (D1) (#2198, #2203). Then decided (owner, 2 November 2026, #1701 OQ4: "Refuse past the ceiling (Recommended)"): an arms-workshop cycle whose borrowing would take Debt past the ceiling also waits unpaid that month (R-ARMS-006).
Hebrew for the Arms debt-ceiling refusal "Hebrew is right (Recommended)" The owner's native read approves arms.refused_debt_ceiling as "רכישת כמות כזאת של נשק תעלה את החוב מעל התקרה" (#2203).
The war debt of about IL 5m a month "Give the player a lever (Recommended)", then "Spend the dollars (Recommended)" The player gets a lever on the war debt: during the war, up to $4m a month of foreign currency can be moved into Money, $100m in total, which brings the sourced 1951 currency crisis and its Food-import cut closer. One foreign-currency readout is shown, so foreign currency is no longer wholly internal (Q2) (lever, options, dollars).
The armistice-lines switch and legend Switch: "Tie to Borders button (Recommended)"; legend: "Restyle Jordan lines (Recommended)" The minimap's Borders button also hides and shows the armistice lines, with no new strings. The low-accuracy Jordan lines get a pattern apart from the legend's grey dash for no-man's land and the demilitarized zones, with no text changes (#2195).

Foreign-currency display ruling, 2 November 2026

Question Owner's answer (2 November 2026) Rule
A lever for the war-time debt (#813) "Spend the dollars (Recommended)" During the war (rungs 4 and 5) the player may convert up to $4m a month of foreign currency into Money, $100m in total; the reserves run out sooner, so the sourced 1951 currency crisis and its Food-import cut come closer (R-MONEY-004; ruling, options). This overrides D-C3 ("Keep them internal, under Money, at least through cutover ... and hide them if they confuse") only for the foreign-currency reserve shown on the Defence screen where this order is made; the top bar keeps its Foreign currency meter (owner, 2 November 2026: "Keep it", #2204).

Later rulings, 3 November 2026

Question Owner's answer (3 November 2026) Rule
City building in the MVP (#1700) "Builders in the MVP (Recommended)" (recorded on #1700); then "One builder, today's times (Recommended)", "One per city, plus 2 nationally" and "Yes, if someone is free" (plan comment) The option read: "Builders in the MVP: projects need Money and people, a project with nobody on it waits, one start a turn." MVP city projects are built by assigned builders as #1700 specifies, one builder a project ("One builder, today's times (Recommended)"): a project needs its Money and its builder, a new project takes a free person as its builder when there is one ("Yes, if someone is free"), a project with no builder waits and makes no progress, and at most one project start per city per turn, and the national map_actions_per_turn 2 still applies; the start limit is the owner's corrected ruling, "One per city, plus 2 nationally" (owner, 3 November 2026). Two builder details stay as built, "Keep both as built (Recommended)" (owner, 3 November 2026): a waiting project does not take a builder freed later on its own (the player can still raise the city's builder count), and the automatic builder pick never takes a worker the game placed automatically. Money shortfalls still borrow (D1). This replaces the worker-free construction of R-PROJ-001 (Q-PROJ-3) and adds the per-city start limit to its two starts a turn (Q-PROJ-4) as MVP design; the game keeps those gdd-0.1 rules until #1700 lands. Under gdd-0.3 they are built as R-CITY-011 and the gdd-0.3 parts of R-PROJ-001 to R-PROJ-003, a project with its builder gaining a turn's progress on its kind's existing turns; gdd-0.1 keeps its worker-free construction and national two-start limit.
Farmers per field (#1694) "One farmer per field (Recommended)" (recorded on #1694); then, asked "May only a unit with the Farmer profession staff a field?", "yes" (4 November 2026, recorded on #1694) Under gdd-0.3 each field takes one farmer, who lives in the field's region (Q27), and an unworked field produces nothing; only a farmer may hold a field (owner, 4 November 2026: asked "May only a unit with the Farmer profession staff a field?", the owner answered "yes", recorded on #1694). A worked field yields 2x / 3x / 5x field_food_per_turn by the farmer's tier. gdd-0.1 keeps R-FIELD-002's fields with no workers.

Deferred decisions

These are recorded once here. Feature files link here instead of maintaining competing open-question lists.

Decision Status / boundary
Starting army size outside Historical mode Historical mode keeps the sourced seed from content/map/units_1948.yaml (Q-START-1, decided 15 October 2026). Parameter A applies only to non-Historical modes and remains deferred; no previously proposed count is accepted (owner, 30 Oct 2026). Historical army growth is only by dated arrivals and replacements, with no manning modifier or scripted draft (owner, 1 November 2026, D4).
Regional-capital model Amir's proposal, declined by the owner on 30 October 2026: create a regional-capital roster and shared regional administration. The retained per-city rules remain authoritative.
Founding dates The owner set Kiryat Shmona to 18 July 1949 and Beit Shemesh to 15 December 1950 under the monthly turn (#785).
Facility availability and starting training-centre host The existing owner ruling already starts Schneller and Tel HaShomer as military facilities; the other military camps are approved build sites. Centre and teacher counts are decided. Decided (owner, 1 November 2026, O8 and 27M-25; 1 November 2026 answers): Kiryat Shmuel, Haifa, hosts the one starting training centre and is the reception site; every camp uses the same military.camp_capacity of 50 population units (#2112: #1668's 5 places at 10,000 people a unit, scaled to D2's 1,000), with no per-camp exceptions. Reception-camp availability beyond that still needs a source before it is authored. Decided (owner, 4 November 2026, #2484): "Keep the Hakhshara". Maintainer reading: Tel Aviv's Hakhshara stays under gdd-0.3, and the training centre comes alongside it and does not replace it.
Final defeat conditions Under gdd-0.3 the retained defeat is the economic one (Money and Food exhausted); losing a city or region alone does not end the game (rules), and the retained end rules add no coalition collapse. Considered and declined (owner, 30 Oct 2026; conflict decision): Amir's #1668 proposed making every terminal defeat TBD. While an enemy unit holds an Israeli city's hex, the city's jobs pay nothing and its Food production and projects pause until it is retaken (owner, 1 November 2026, D6).
Minister-specific gameplay The existing office-competence slice (R-MIN-001 to R-MIN-003 and Cabinet.Appoint) is the complete MVP minister mechanic (owner ruling #1513). Historical offices and event references remain, and the existing cabinet stays; under gdd-0.3 there is no Attention resource (rules).
Terrain presentation TBD. The MVP catalogue itself remains frozen at the existing eight biomes.
Novice profession lock-in Trained civilian roles can return and be reassigned while keeping their qualification (owner ruling #1511). Amir's conflicting permanent, mutually exclusive profession proposal was declined on 30 October 2026; the owner kept two-way professions for the MVP on 1 November 2026 (D3), and Amir's lock (Q9) is post-MVP.
Sensitive capture outcomes Raid and Deport remain subject to the existing content policy, owner rulings and review gates; do not infer displacement, rewards or civilian labour.
Specialised military equipment and operation-card orders Specific gun/vehicle models and unsourced operation orders remain evidence/review work; ordinary recruitment and the retained Arms-expenditure rules are settled. Every military-operation card gives unit orders from sourced anchors (owner, 1 November 2026, "military openrations must have unit orders"; later rulings).

Reception-camp growth into permanent towns, an individually managed economy for every rural settlement, and a detailed enemy supply/reinforcement economy are outside the MVP. They are not unresolved numerical values.