A Civilization-style strategy game about governing Israel from 15 May 1948. Real ministers, real map, every fact sourced. Unity + deterministic C# sim.
"""Unity-MCP (com.ivanmurzak.unity.mcp) is the project's standard AI-agent bridge for the Unity editor. These tests pin
how it is installed, so a fresh clone resolves it with no manual steps (a missing OpenUPM scope gave contributors
`error CS0246 'PlayerPrefsBool'`)."""
import json
import subprocess
from pathlib import Path
ROOT = Path(__file__).resolve().parents[3]
PKG, VERSION = "com.ivanmurzak.unity.mcp", "0.93.3"
OPENUPM = "https://package.openupm.com"
def manifest() -> dict:
return json.loads((ROOT / "unity/Packages/manifest.json").read_text(encoding="utf-8"))
def lock() -> dict:
return json.loads((ROOT / "unity/Packages/packages-lock.json").read_text(encoding="utf-8"))["dependencies"]
def test_manifest_pins_the_plugin_version():
assert manifest()["dependencies"][PKG] == VERSION
def test_openupm_registry_scopes_cover_every_openupm_package_in_the_lock():
regs = [r for r in manifest().get("scopedRegistries", []) if r["url"] == OPENUPM]
assert len(regs) == 1
scopes = regs[0]["scopes"]
assert "com.ivanmurzak" in scopes and "extensions.unity" in scopes
from_openupm = [name for name, d in lock().items() if d.get("url") == OPENUPM]
assert PKG in from_openupm and "extensions.unity.playerprefsex" in from_openupm
for name in from_openupm:
assert any(name == s or name.startswith(s + ".") for s in scopes), name
def test_lock_resolves_the_pinned_plugin_from_openupm():
entry = lock()[PKG]
assert entry["version"] == VERSION and entry["source"] == "registry" and entry["url"] == OPENUPM
def test_project_settings_do_not_commit_the_plugin_gate_defines():
# The plugin's resolver downloads its NuGet DLLs, then adds UNITY_MCP_READY and UNITY_MCP_DEPS_<n> on each
# machine. Committed, the defines reach a fresh clone before the DLLs do, and the plugin fails to compile
# (error CS0234 'System.Text.Json', ...), which stops batch mode. Leave that local change uncommitted: this reads
# the committed file, so a contributor's own working copy (which has the defines) still passes.
text = subprocess.run(["git", "-C", str(ROOT), "show", "HEAD:unity/ProjectSettings/ProjectSettings.asset"],
capture_output=True, check=True, text=True).stdout
assert "UNITY_MCP_" not in text
def test_downloads_and_generated_agent_files_are_ignored():
# The NuGet DLLs are third-party binaries fetched on first open; .mcp.json can carry the local server's bearer
# token; the generated skills change with every plugin version. UserSettings/ (the plugin's per-user config and
# local token) was already ignored.
ignore = (ROOT / ".gitignore").read_text(encoding="utf-8").splitlines()
for rule in ("unity/Assets/Plugins/NuGet/", "unity/Assets/Plugins/NuGet.meta", ".mcp.json", "unity/.claude/",
"unity/UserSettings/", "unity/Library/", "unity/Assets/packages-merged-link/",
"unity/Assets/packages-merged-link.meta", "unity/.agent/", "unity/.agents/", "unity/.cline/",
"unity/.codex/", "unity/.cursor/", "unity/.gemini/", "unity/.github/", "unity/.junie/",
"unity/.kilocode/", "unity/.opencode/", "unity/.roo/", "unity/opencode.json"):
assert rule in ignore, rule
def test_notices_and_licensing_name_the_plugin_and_its_dependencies():
notices = (ROOT / "THIRD-PARTY-NOTICES.md").read_text(encoding="utf-8")
for fact in (PKG, "Apache-2.0", "extensions.unity.playerprefsex", "ReflectorNet", "GameDev-MCP-Server", "nuget.org",
"UnityMcpGuard", "integrity, not authenticity", "no hash or signature check",
"with each package on nuget.org"):
assert fact in notices, fact
row = next(l for l in (ROOT / "LICENSING.md").read_text(encoding="utf-8").splitlines() if "`unity/Packages/`" in l)
assert "OpenUPM" in row and PKG in row and "Apache-2.0" in row
def test_update_popup_is_off_for_the_team():
# The plugin's own team kill-switch (ProjectSettings, meant to be committed): no update popup in any editor, batch
# runs included, and no OpenUPM ping. Version bumps come by pull request.
text = (ROOT / "unity/ProjectSettings/AI-Game-Developer-UpdateSettings.asset").read_text(encoding="utf-8")
assert "UnityMcpUpdateProjectSettings" in text and "disableUpdateNotificationsForTeam: 1" in text
CI_OFF = "-CI false -GITHUB_ACTIONS false -TF_BUILD false"
def test_every_documented_batch_unity_command_turns_the_plugins_ci_mode_off():
# The plugin treats CI, GITHUB_ACTIONS or TF_BUILD = true as CI: its resolver then skips its NuGet download but still
# adds its gate defines, so a fresh clone fails to compile and the batch run hangs (fix rounds 1 and 2). The plugin
# reads each key from the command line before the environment, so these three arguments win. Any line that starts
# Unity in batch mode on the project, in any form, must carry them.
files = [f for f in subprocess.run(["git", "-C", str(ROOT), "ls-files", "-z", "*.md", "tools/*.sh", "scripts/*.sh",
"unity/Assets/Editor/*.cs"],
capture_output=True, check=True, text=True).stdout.split("\0") if f]
files = [f for f in files if not f.startswith(("docs/superpowers/", "reports/", "research_notes/", "spikes/"))]
seen = 0
for rel in files:
for n, line in enumerate((ROOT / rel).read_text(encoding="utf-8").splitlines(), 1):
if "-batchmode" in line and "-projectPath" in line:
seen += 1
assert CI_OFF in line, f"{rel}:{n}"
assert seen >= 17
def test_ci_section_says_a_unity_job_must_turn_ci_mode_off():
text = (ROOT / "CONTRIBUTING.md").read_text(encoding="utf-8").split("## What CI runs", 1)[1].split("\n## ", 1)[0]
assert CI_OFF in text and "GITHUB_ACTIONS" in text and "TF_BUILD" in text
def test_docs_name_all_three_ci_variables():
for rel in ("CONTRIBUTING.md", "BUILDING.md", "README.he.md"):
text = (ROOT / rel).read_text(encoding="utf-8")
for fact in ("GITHUB_ACTIONS", "TF_BUILD", CI_OFF):
assert fact in text, (rel, fact)
def test_upstream_feature_request_draft_is_kept_for_the_owner():
text = (ROOT / "docs/unity-mcp-upstream-request.md").read_text(encoding="utf-8")
assert "versionDefines" in text and "ProjectSettings.asset" in text and "not filed" in text