Add Cloud Agent dev environment + mod validation tooling - #1
Draft
IAALAI wants to merge 1 commit into
Draft
Conversation
- .cursor/environment.json + install.sh install vic3-tiger (canonical Victoria 3 mod validator) idempotently. - scripts/validate_mod.py: offline well-formedness checks (Paradox script brace/quote balance, localization BOM/format, metadata JSON, PNG signature). - scripts/validate.sh: runs the offline checks and, when a Victoria 3 game directory is available (VIC3_DIR), the full vic3-tiger validation. Co-authored-by: IAALAI <iaalai@iaalai.cn>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Sets up a reproducible, repo-managed development environment for the
ttlVictoria 3 content mod. The mod has no traditional build system — "development" means editing Paradox script (.txt), localization (.yml), and image assets. The relevant "application" for a mod developer is a validator, so this environment installs the canonical one and adds an offline validation harness.Because
.cursor/environment.jsonis committed, this becomes the highest-precedence environment source: merging this PR activates the environment for future Cloud Agents (no dashboard Save needed).Changes
.cursor/environment.json— repo-managed Cloud Agent environment; runs the install script on setup..cursor/install.sh— idempotent bootstrap that installsvic3-tigerv1.19.0(the canonical Victoria 3 mod validator) to/usr/local/binand makes the validation scripts executable. Retries downloads with exponential backoff.scripts/validate_mod.py— dependency-free offline well-formedness checker:{ }brace balance and quote-termination (comment- and string-aware)..ymlUTF-8 BOM,l_<language>:header, andKEY:<n> "value"entry format..metadata/metadata.jsonJSON validity..pngasset signature integrity.scripts/validate.sh— wrapper that runs the offline checks and, when a Victoria 3 install is available viaVIC3_DIR, the fullvic3-tigersemantic validation.Why an offline harness
vic3-tigerperforms full cross-reference validation but requires the copyrighted Victoria 3 game files, which cannot be shipped in a Cloud Agent VM. The offline harness runs the meaningful checks that do not need the base game, so the environment has a working end-to-end validation flow out of the box. Full semantic validation is a single command away for anyone with the game installed.Validation
scripts/validate.shvalidates all 24 mod files: 0 errors, 0 warnings.bld-20260806-ae0f6634-b787-4b9e-830e-e1353496187dSUCCEEDED (fresh git checkout + install).vic3-tiger 1.19.0andpython3on PATH, setup files present, harness clean (24 files, 0 errors), and broken-fixture detection confirmed.