A Civilization-style strategy game about governing Israel from 15 May 1948. Real ministers, real map, every fact sourced. Unity + deterministic C# sim.
#nullable enable
#if UNITY_EDITOR
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using Statecraft.Sim;
using UnityEngine;
namespace Statecraft.Game.Map
{
[Serializable]
public sealed class MapEditorTerrainEdit
{
public int q, r;
public string value = "";
}
[Serializable]
public sealed class MapEditorControlEdit
{
public int q, r;
public string period = "", value = "";
}
[Serializable]
public sealed class MapEditorLocationEdit
{
public string id = "";
public int q, r;
}
public sealed class MapEditorLocation
{
public readonly string Id, Name, Kind;
public readonly int BaseQ, BaseR;
public MapEditorLocation(string id, string name, string kind, int q, int r)
{ Id = id; Name = name; Kind = kind; BaseQ = q; BaseR = r; }
}
public sealed class MapEditorDependencies
{
public readonly IReadOnlyList<string> Cities, Sites, Corridors;
public MapEditorDependencies(IEnumerable<string> cities, IEnumerable<string> sites, IEnumerable<string> corridors)
{
Cities = cities.OrderBy(x => x, StringComparer.Ordinal).ToList();
Sites = sites.OrderBy(x => x, StringComparer.Ordinal).ToList();
Corridors = corridors.OrderBy(x => x, StringComparer.Ordinal).ToList();
}
}
/// <summary>One row of the diff preview (#1721 slice C): a terrain hex, a control hex in one period, or a location id
/// whose current value differs from the saved override file. Values are what the map shows: the saved file's
/// override, or the generated value when the file has none.</summary>
public sealed class MapEditorChange
{
public const string Terrain = "terrain", Control = "control", Location = "location";
public readonly string Kind, Period, Id, Saved, Current;
public readonly int Q, R;
public MapEditorChange(string kind, int q, int r, string period, string id, string saved, string current)
{ Kind = kind; Q = q; R = r; Period = period; Id = id; Saved = saved; Current = current; }
public override string ToString() => Kind switch
{
Terrain => FormattableString.Invariant($"terrain q={Q} r={R}: {Saved} -> {Current}"),
Control => FormattableString.Invariant($"control q={Q} r={R} {Period}: {Saved} -> {Current}"),
_ => $"location '{Id}': {Saved} -> {Current}",
};
}
/// <summary>The undoable data behind the Unity map editor. It edits only content/map/overrides.yaml; generated map
/// inputs and historical evidence stay read-only. Unity serializes the three edit lists, so Undo restores every
/// terrain, one-period control and location-position edit. The content root is serialized too, so after a domain
/// reload <see cref="Restore"/> rebuilds the map around the surviving edits.</summary>
public sealed class MapOverrideEditorDocument : ScriptableObject
{
[SerializeField] List<MapEditorTerrainEdit> terrain = new List<MapEditorTerrainEdit>();
[SerializeField] List<MapEditorControlEdit> control = new List<MapEditorControlEdit>();
[SerializeField] List<MapEditorLocationEdit> locations = new List<MapEditorLocationEdit>();
[SerializeField] string contentRoot = "";
string path = "", savedCanonical = "";
readonly Dictionary<(int q, int r), MapHex> baseHexes = new Dictionary<(int, int), MapHex>();
readonly Dictionary<string, MapEditorLocation> baseLocations = new Dictionary<string, MapEditorLocation>(StringComparer.Ordinal);
readonly List<string> landBiomes = new List<string>();
Content baseContent = null!;
Control1948 controlFile = null!;
public IReadOnlyCollection<MapHex> Hexes => baseHexes.Values;
public IReadOnlyCollection<MapEditorLocation> Locations => baseLocations.Values;
public IReadOnlyList<string> LandBiomes => landBiomes;
public IReadOnlyList<Control1948.Period> Periods => controlFile.Periods;
public IReadOnlyList<string> ControlValues => Control1948.EditorCodes;
public bool HasUnsavedChanges => Canonical() != savedCanonical;
public string OverridePath => path;
/// <summary>False after a domain reload, which keeps the serialized edits but not the map read from disk.</summary>
public bool IsLoaded => controlFile != null;
public static MapOverrideEditorDocument Load(string root)
{
var result = CreateInstance<MapOverrideEditorDocument>();
result.hideFlags = HideFlags.HideAndDontSave;
result.Reload(root);
return result;
}
public void Reload() => Reload(contentRoot);
/// <summary>Reads the map and the saved override file again and keeps the current edits (after a domain reload).</summary>
public void Restore() => ReadSaved(contentRoot);
void Reload(string root) => SetFrom(ReadSaved(root));
MapOverrides ReadSaved(string root)
{
if (string.IsNullOrWhiteSpace(root)) throw new ArgumentException("The content directory is required", nameof(root));
contentRoot = Path.GetFullPath(root);
path = Path.Combine(contentRoot, MapOverrides.FileName);
var eventRoot = Path.Combine(contentRoot, "events");
var events = Directory.Exists(eventRoot)
? Directory.GetFiles(eventRoot, "*.yaml").Select(x => "events/" + Path.GetFileName(x)).ToList()
: new List<string>();
baseContent = ContentLoader.Load(relative =>
{
if (relative == MapOverrides.FileName) return null;
var file = Path.Combine(contentRoot, relative);
return File.Exists(file) ? File.ReadAllText(file) : null;
}, events);
controlFile = Control1948.Parse(File.ReadAllText(Path.Combine(contentRoot, "map", Control1948.FileName)));
baseHexes.Clear();
foreach (var hex in baseContent.Hexes) baseHexes[(hex.Q, hex.R)] = hex;
landBiomes.Clear();
landBiomes.AddRange(baseContent.Hexes.Where(x => x.Land).Select(x => x.Biome).Distinct().OrderBy(x => x, StringComparer.Ordinal));
baseLocations.Clear();
foreach (var item in baseContent.SettlementHexes)
baseLocations[item.Id] = new MapEditorLocation(item.Id, baseContent.SettlementNames[item.Id], "settlement", item.Q, item.R);
foreach (var item in baseContent.MapLocations)
baseLocations[item.Id] = new MapEditorLocation(item.Id, item.Name, item.Kind, item.Q, item.R);
var source = File.Exists(path) ? File.ReadAllText(path) : "";
var parsed = MapOverrides.Parse(source);
parsed.ValidateMap(baseContent.Hexes, baseLocations.Keys);
parsed.ValidateControl(controlFile.EditorHexes, controlFile.Periods.Select(x => x.Id), Control1948.EditorCodes);
savedCanonical = MapOverrides.Serialize(parsed);
name = "Map overrides";
return parsed;
}
public string TerrainAt(int q, int r)
{
if (!baseHexes.TryGetValue((q, r), out var hex)) throw new ArgumentException(FormattableString.Invariant($"unknown hex q={q} r={r}"));
return terrain.FirstOrDefault(x => x.q == q && x.r == r)?.value ?? hex.Biome;
}
public string ControlAt(int q, int r, string period) =>
control.FirstOrDefault(x => x.q == q && x.r == r && x.period == period)?.value
?? controlFile.EditorCodeAt(q, r, period);
public (int q, int r) LocationAt(string id)
{
if (!baseLocations.TryGetValue(id, out var item)) throw new ArgumentException($"unknown location id '{id}'", nameof(id));
var edit = locations.FirstOrDefault(x => x.id == id);
return edit == null ? (item.BaseQ, item.BaseR) : (edit.q, edit.r);
}
public bool IsLand(int q, int r) => baseHexes.TryGetValue((q, r), out var hex) && hex.Land;
public void SetTerrain(int q, int r, string value)
{
if (!baseHexes.TryGetValue((q, r), out var hex)) throw new ArgumentException(FormattableString.Invariant($"unknown hex q={q} r={r}"));
if (!hex.Land) throw new ArgumentException(FormattableString.Invariant($"hex q={q} r={r} is not a land hex"));
if (!landBiomes.Contains(value)) throw new ArgumentException($"unknown land terrain '{value}'", nameof(value));
terrain.RemoveAll(x => x.q == q && x.r == r);
if (value != hex.Biome) terrain.Add(new MapEditorTerrainEdit { q = q, r = r, value = value });
}
public void SetControl(int q, int r, string period, string value)
{
var original = controlFile.EditorCodeAt(q, r, period);
if (!Control1948.EditorCodes.Contains(value)) throw new ArgumentException($"unknown control value '{value}'", nameof(value));
control.RemoveAll(x => x.q == q && x.r == r && x.period == period);
if (value != original) control.Add(new MapEditorControlEdit { q = q, r = r, period = period, value = value });
}
public void SetLocation(string id, int q, int r)
{
if (!baseLocations.TryGetValue(id, out var item)) throw new ArgumentException($"unknown location id '{id}'", nameof(id));
if (!baseHexes.TryGetValue((q, r), out var hex)) throw new ArgumentException(FormattableString.Invariant($"unknown hex q={q} r={r}"));
if (!hex.Land) throw new ArgumentException(FormattableString.Invariant($"hex q={q} r={r} is not a land hex"));
locations.RemoveAll(x => x.id == id);
if (q != item.BaseQ || r != item.BaseR) locations.Add(new MapEditorLocationEdit { id = id, q = q, r = r });
}
public MapEditorDependencies Dependencies(string id)
{
if (!baseLocations.TryGetValue(id, out var item)) throw new ArgumentException($"unknown location id '{id}'", nameof(id));
var current = LocationAt(id);
var cities = baseContent.Cities.Where(x => x.Id == id).Select(x => $"city '{x.Id}' uses this location identity");
var sites = baseContent.Sites.Where(x => x.Id == id || x.City == id
|| (x.Q == item.BaseQ && x.R == item.BaseR) || (x.Q == current.q && x.R == current.r))
.Select(x => $"site '{x.Id}'" + (x.City == id ? $" is bound to city '{id}'" : $" shares hex q={x.Q} r={x.R}"));
var corridors = baseContent.Corridors.SelectMany(x => x.Segments.Select((segment, i) => (corridor: x, segment, number: i + 1)))
.Where(x => x.segment.Hexes.Any(h => (h[0] == item.BaseQ && h[1] == item.BaseR) || (h[0] == current.q && h[1] == current.r)))
.Select(x => $"corridor '{x.corridor.Id}' segment {x.number} (to {x.segment.To}) crosses this location's hex; its hexes stay as traced");
return new MapEditorDependencies(cities, sites, corridors);
}
public bool Save(out string error)
{
try
{
var value = ToOverrides();
value.ValidateMap(baseContent.Hexes, baseLocations.Keys);
value.ValidateControl(controlFile.EditorHexes, controlFile.Periods.Select(x => x.Id), Control1948.EditorCodes);
var canonical = MapOverrides.Serialize(value);
if (canonical == savedCanonical) { error = ""; return true; }
// Validate the candidate through the game's full content loader before replacing the saved map: a valid
// land-hex move can still break a dependent record (for example a settlement moved onto a site).
var eventRoot = Path.Combine(contentRoot, "events");
var events = Directory.Exists(eventRoot)
? Directory.GetFiles(eventRoot, "*.yaml").Select(x => "events/" + Path.GetFileName(x)).ToList()
: new List<string>();
ContentLoader.Load(relative =>
{
if (relative == MapOverrides.FileName) return canonical;
var file = Path.Combine(contentRoot, relative);
return File.Exists(file) ? File.ReadAllText(file) : null;
}, events);
Directory.CreateDirectory(Path.GetDirectoryName(path)!);
var temporary = path + ".tmp-" + Guid.NewGuid().ToString("N");
try
{
File.WriteAllText(temporary, canonical);
var check = MapOverrides.Parse(File.ReadAllText(temporary));
check.ValidateMap(baseContent.Hexes, baseLocations.Keys);
check.ValidateControl(controlFile.EditorHexes, controlFile.Periods.Select(x => x.Id), Control1948.EditorCodes);
if (File.Exists(path)) File.Replace(temporary, path, null);
else File.Move(temporary, path);
}
finally { if (File.Exists(temporary)) File.Delete(temporary); }
savedCanonical = canonical;
error = "";
return true;
}
catch (Exception exception) when (exception is IOException || exception is UnauthorizedAccessException
|| exception is ArgumentException || exception is ContentException)
{
error = exception.Message;
return false;
}
}
/// <summary>The locations whose id contains <paramref name="query"/>, ignoring letter case, ordered by id
/// (#1721 slice C). Ordinal matching keeps the result the same in every editor language. A blank query lists all.</summary>
public IReadOnlyList<MapEditorLocation> SearchLocations(string query)
{
var text = (query ?? "").Trim();
return baseLocations.Values.Where(x => text.Length == 0 || x.Id.IndexOf(text, StringComparison.OrdinalIgnoreCase) >= 0)
.OrderBy(x => x.Id, StringComparer.Ordinal).ToList();
}
/// <summary>The diff preview (#1721 slice C): every terrain hex, control hex and period, and location whose current
/// value differs from the saved override file, sorted by row then column (control rows then by period, locations by
/// id). A saved override that is gone also counts when its value equals the generated map: Set* drops such an edit,
/// so only its presence changed, and the row lets the user see and revert it. Read-only; nothing is written.</summary>
public IReadOnlyList<MapEditorChange> Changes()
{
var saved = MapOverrides.Parse(savedCanonical);
var result = new List<MapEditorChange>();
foreach (var (q, r) in saved.Terrain.Select(x => (x.Hex.Q, x.Hex.R)).Concat(terrain.Select(x => (x.q, x.r))).Distinct()
.OrderBy(x => x.Item2).ThenBy(x => x.Item1))
{
var savedEdit = saved.Terrain.FirstOrDefault(x => x.Hex.Q == q && x.Hex.R == r);
var before = savedEdit?.Value ?? baseHexes[(q, r)].Biome;
var now = TerrainAt(q, r);
if (before != now || (savedEdit != null) != terrain.Any(x => x.q == q && x.r == r)) result.Add(new MapEditorChange(MapEditorChange.Terrain, q, r, "", "", before, now));
}
foreach (var (q, r, period) in saved.Control.Select(x => (x.Hex.Q, x.Hex.R, x.Period)).Concat(control.Select(x => (x.q, x.r, x.period)))
.Distinct().OrderBy(x => x.Item2).ThenBy(x => x.Item1).ThenBy(x => x.Item3, StringComparer.Ordinal))
{
var savedEdit = saved.Control.FirstOrDefault(x => x.Hex.Q == q && x.Hex.R == r && x.Period == period);
var before = savedEdit?.Value ?? controlFile.EditorCodeAt(q, r, period);
var now = ControlAt(q, r, period);
if (before != now || (savedEdit != null) != control.Any(x => x.q == q && x.r == r && x.period == period)) result.Add(new MapEditorChange(MapEditorChange.Control, q, r, period, "", before, now));
}
foreach (var id in saved.Locations.Select(x => x.Id).Concat(locations.Select(x => x.id)).Distinct().OrderBy(x => x, StringComparer.Ordinal))
{
var item = baseLocations[id];
var edit = saved.Locations.FirstOrDefault(x => x.Id == id);
var before = edit == null ? (item.BaseQ, item.BaseR) : (edit.Hex.Q, edit.Hex.R);
var now = LocationAt(id);
if (before != now || (edit != null) != locations.Any(x => x.id == id))
result.Add(new MapEditorChange(MapEditorChange.Location, now.q, now.r, "", id,
FormattableString.Invariant($"q={before.Item1} r={before.Item2}"), FormattableString.Invariant($"q={now.q} r={now.r}")));
}
return result;
}
/// <summary>Selected revert (#1721 slice C): puts one diff row back to its saved value and leaves every other edit as
/// it is. The caller owns the Undo record; nothing is written to disk.</summary>
public void Revert(MapEditorChange change)
{
if (change == null) throw new ArgumentNullException(nameof(change));
var saved = MapOverrides.Parse(savedCanonical);
switch (change.Kind)
{
case MapEditorChange.Terrain:
terrain.RemoveAll(x => x.q == change.Q && x.r == change.R);
terrain.AddRange(saved.Terrain.Where(x => x.Hex.Q == change.Q && x.Hex.R == change.R)
.Select(x => new MapEditorTerrainEdit { q = x.Hex.Q, r = x.Hex.R, value = x.Value }));
break;
case MapEditorChange.Control:
control.RemoveAll(x => x.q == change.Q && x.r == change.R && x.period == change.Period);
control.AddRange(saved.Control.Where(x => x.Hex.Q == change.Q && x.Hex.R == change.R && x.Period == change.Period)
.Select(x => new MapEditorControlEdit { q = x.Hex.Q, r = x.Hex.R, period = x.Period, value = x.Value }));
break;
case MapEditorChange.Location:
locations.RemoveAll(x => x.id == change.Id);
locations.AddRange(saved.Locations.Where(x => x.Id == change.Id)
.Select(x => new MapEditorLocationEdit { id = x.Id, q = x.Hex.Q, r = x.Hex.R }));
break;
default: throw new ArgumentException($"unknown change kind '{change.Kind}'", nameof(change));
}
}
public MapOverrides ToOverrides() => new MapOverrides
{
Terrain = terrain.Select(x => new TerrainOverride { Hex = new MapHexRef { Q = x.q, R = x.r }, Value = x.value }).ToList(),
Control = control.Select(x => new ControlOverride { Hex = new MapHexRef { Q = x.q, R = x.r }, Period = x.period, Value = x.value }).ToList(),
Locations = locations.Select(x => new LocationOverride { Id = x.id, Hex = new MapHexRef { Q = x.q, R = x.r } }).ToList(),
};
string Canonical() => MapOverrides.Serialize(ToOverrides());
void SetFrom(MapOverrides value)
{
terrain = value.Terrain.Select(x => new MapEditorTerrainEdit { q = x.Hex.Q, r = x.Hex.R, value = x.Value }).ToList();
control = value.Control.Select(x => new MapEditorControlEdit { q = x.Hex.Q, r = x.Hex.R, period = x.Period, value = x.Value }).ToList();
locations = value.Locations.Select(x => new MapEditorLocationEdit { id = x.Id, q = x.Hex.Q, r = x.Hex.R }).ToList();
}
// Isolated 0.3 authoring state; no window hookup or disk writer in this infrastructure slice.
// Serialize exact source for Undo/domain reload. Caller owns the Undo transaction.
[SerializeField] string infrastructureSource = "";
[SerializeField] string rejectedInfrastructureSource = "";
public string InfrastructureSource => infrastructureSource;
public string RejectedInfrastructureSource => rejectedInfrastructureSource;
public bool TryReplaceInfrastructure(string candidate, string selectedRuleset, out string error)
{
try
{
MapEditorOverlay.Parse(candidate, selectedRuleset);
infrastructureSource = candidate;
rejectedInfrastructureSource = "";
error = "";
return true;
}
catch (ContentException exception)
{
rejectedInfrastructureSource = candidate;
error = exception.Message;
return false;
}
}
// Return a fresh snapshot; callers cannot mutate the serialized document through this model.
public MapEditorOverlay InfrastructureCandidate() => MapEditorOverlay.Parse(infrastructureSource, SaveGame.Gdd03Ruleset);
}
}
#endif