just_game_engine_cli 0.2.0
just_game_engine_cli: ^0.2.0 copied to clipboard
The Just Game Engine's commands for `just` (just_core_cli): run and build games, check releases hold no editor, manage scenes and migrate saved files.
0.2.0 #
Publish it last: after every version its game set names (the engine and its packages, just_game_engine_formats 0.3.0, the Asset Store 0.3.0, the editor 0.1.0 and its core 0.1.0, and the kits, tagged in their repositories) and after just_core_cli 0.2.0, whose tool set 2026.11 names this version. A game made with it fetches them all.
Requires just_core_cli ^0.2.0 and just_game_engine_formats ^0.3.0; depends on dart_mcp ^0.5.2 and meta ^1.15.0.
Breaking #
- The extension that reads a game on disk is
ProjectGame(wasGameProject), by the naming rule for extensions. Its members are unchanged:releaseRules(),editorReachableFrom(),checkReleaseBuild(),devOnlyPlugins(),checkFormats(),editorIsOpen(). JustProject.editorReachableFromthrowsReleaseImportsUncheckedwhen it could not look everywhere it had to: the entry point is not there, the project's packages were never fetched, or an import names a package pub did not resolve or a file that is not there. It used to return no offenders, sojust game checksaid "No editor code is reachable" for a typo injust.json'sentry.game, or for a game whose packages weren't fetched. A script that calls it catches the exception, or fails.- The commands' subcommands (
GameRunCommand,GameBuildCommand,GameCheckCommand,GameSceneCommand— wasSceneCommand—,GameDoctorCommand,GameUpgradeCommand,GameMigrateCommand,GameMcpCommand,GameInitCommand,GameLinkCommand) and the MCP server's classes are@internal: the public API isGameCommand. The in-process runner's typedefs areInProcessJustandInProcessRun(wereJustRunner, which clashed with just_core_cli's command runner, andJustRun). lib/src/is laid out by feature, one barrel per folder:game/andrelease/(on every platform),project/,mcp/andcommands/(wheredart:iois).src/create/templates.g.dartissrc/game/bundled_templates.g.dart(andsrc/native.dartis gone: see Removed). The public library's exports are unchanged apart from the renames.EditorPresenceis gone: the editor's heartbeat is just_game_engine_formats'EditorHeartbeat, which the editor writes through too (EditorPresence.path→EditorHeartbeat.path,beat→interval,stale→staleAfter,isFresh(touched, now:)→!EditorHeartbeat.decode(text, modified: touched).isStale(now)).editorIsOpen()reads the beat the file holds, and a file without one (an editor before 0.1.0, which wrote its process ID) by when it was last written, as before. The two packages kept the path and timings in step by hand.- The game set is 2026.11 (with just_core_cli's tool set 2026.11): just_game_engine ^2.0.0, just_game_engine_formats ^0.3.0, just_physics_engine ^2.0.0, just_box_2d ^0.2.0, just_jolt ^0.2.0, just_inputs ^0.2.0, just_tiled ^0.5.0, just_dart ^0.3.0, just_graphics_engine ^0.2.0, just_deflate ^0.1.0, just_audio_engine ^2.0.0, just_asset_store ^0.3.0, just_game_engine_editor ^0.1.0, just_editor_core ^0.1.0, just_world_builder_kit and just_third_person_kit ^0.2.0-beta.1.
game upgrade(andjust upgrade) moves a game onto it. It no longer has just_material_editor: the package is retired (it was an empty placeholder; materials are the editor's own), sogame init --localno longer links a checkout of it, andgame doctorandgame upgradeno longer check or move its version.
Added #
- Games are pinned to Flutter 3.47.9. just_game_engine draws 3D with Flutter GPU, a preview whose API changes between Flutter versions, so each engine release works with one Flutter. This package declares the version in its pubspec (
just:→flutter: 3.47.9), where just_core_cli 0.2.0 reads it before the package is fetched:just createmakes the game with that Flutter (installing it when the user says so) and writes it into the game'sjust.json, andjust upgrademoves it with this package.GameSet.flutterPinholds the same version (a test keeps them equal), andGameSet.flutteris now a range,>=3.47.1 <3.48.0: 3.48 is out until the engine is tried on it. A new game's pubspec holds it to that range (environment: flutter:), which pub enforces for the game itself, so a plainflutter pub geton another Flutter says so;GameSet.bump(game upgrade) moves the range with the set (listed asGameSet.flutterKey). - At a terminal,
game init's steps tick and end with their time, itspub getprinting out of sight unless it fails, andgame check,game scene validateandgame doctormark their lines with a coloured✓ ! ✗. Plain text is as it was. - The game template's
AGENTS.mdsaysjust flutter analyzeandjust flutter test: the Flutter the game pins. just game mcp: an MCP server for AI assistants (Claude Code, VS Code, Cursor, …), on stdin and stdout. It serves the engine as the game resolved it, so an assistant stops guessing 1.x or Flame APIs:search_docs: keyword search over just_game_engine's guides (doc/guides/, from the version that ships them), the packages' README, MIGRATION and CHANGELOG, and their public API.read_doc: a guide or note, whole or one section.get_api: a type or member's signature, doc comment, import, constructors, members and subtypes, with what replaces a deprecated one, read from the packages' source (export chains followed across packages).project_info,list_scenes,validate_scenesandcheck_game(game doctorandgame check) run in-process, their output kept off the MCP stream.- Every tool only reads. The server's instructions give the engine's versions and the rules that trip people up.
- A new game has
AGENTS.md(how it is built, its commands, those rules), aCLAUDE.mdthat points to it, and.mcp.jsonand.vscode/mcp.json, which startjust game mcp. ReleaseImportsUnchecked(itsentry,reasons, thereachabletrails found anyway, and amessage), andFormatsCheck.endingAs, new text that ends as a file did.game check --json'srelease-importsresult hasunchecked, the reasons a walk could not look.
Changed #
game doctorandgame initsay whether Flutter or Dart is too old or too new for the engine (GameSet.flutterhas an upper bound now), and the fix isjust sdk install <version>— the version the game pins, orGameSet.flutterPin— instead offlutter upgrade.- The release-imports walk reads only packages that can reach editor code: those that are, or depend on (
.dart_tool/package_graph.json), a package the release rules name, or the project itself. Flutter and the rest are never read: about 250 ms on the platformer template, where it read 2,294 files in 1.4–1.8 s warm (5 s cold). Without a package graph every package is walked, as before. game build --editor-entryno longer walks the editor's entry point, whose result it ignored: its build is the proof. Before building,game buildrefuses an entry point that is not there; a walk that could not look (the packages not fetched yet) is a warning, and after the build the build is checked — or, for a platform whose build the check can't read (apk,ios…), the source is walked again, and the command fails if it still can't be.game scene migratewrites any scene whose migration changed it, a current-format one included (a timeline it keeps inline brought up to date, now that the formats rename and update at any version); a scene nothing changes is left as it is, byte for byte. The kits' rules (MigrationSafety) are asked only when an older scene is rewritten.game doctorjudges the entry point's imports by the game's release rules, asgame checkdoes (package:just_editor_core/…andpackage:just_asset_store/…count too, and a game file named likeeditor_theme.dartdoesn't), names the imports it found, readspubspec.yaml's dependencies however they are indented or written, and asks git whether the editor's folders are ignored (/.editor_trash/,.editor_trashor an ignore further up count; without git it reads.gitignoreas git would).check release-buildlooks for the engine's renamed 3-D physics system (Physics3DSystem) in a 2-D game's release.- The
emptytemplate draws its stand-in player withRectangle2DComponent, the engine's new name forRectangleComponent. - A new game's
AGENTS.mdand the MCP server's rules sayEngine.getSystemis gone (it was deprecated); theemptytemplate's boot lists animators and timelines among the engine's standard systems. game init --localfinds checkouts with just_core_cli'sDevLinks.scanAll(the same folder named two ways is one checkout), and reads the pubspec's name withPubspecFields; the MCP server reads versions and pub-cache packages with just_core_cli'sResolvedPackage.
Fixed #
- The release-imports check no longer passes without having looked (see Breaking):
game checkfails with "The editor-import check of lib/main.dart proves nothing: …", and a forbidden import counts whether or not pub resolved its package. - A declined question fails with a reason: answering no to
game scene delete,game migrateorgame upgradeexits 1 with "Nothing was changed: … was declined." (and--json'serrorsays so); it said nothing. game scene migrate,game scene renameandgame migratewrite a file the same way: as the editor writes it, ending as it did — CRLF stays CRLF (a Windows checkout withcore.autocrlf), and a final newline stays.scenedropped the final newline, and every migrated file came out LF.MigrationSafety(and sogame migrate,game migrate --checkandjust upgrade) no longer stops with aFileSystemExceptionat a package whosejust_store.jsonisn't UTF-8 or can't be read: it is no kit, as one that isn't JSON.just game mcpno longer ends when its background read of the engine's API fails: a folder it can't list or a file its scanner trips on is left out and named,get_apiandsearch_docssay what is missing, and the rest is served.
Removed #
src/native.dart(the public library exports thecommands/andproject/barrels instead), and the private copies of just_core_cli's pubspec readers and checkout scan.
0.1.4 #
just createworks again. The game set took just_game_engine_editor and just_editor_core from the Asset Store, but they are on pub.dev and the store doesn't list them, sogame initfailed atjust store install just_game_engine_editor("not in any of your sources") and the new project was removed. They now come from pub.dev: a new game lists the editor in itsdev_dependencies, and the store runs only for a--template(and--local'sstore link). Only plugins (kits and editor tools) still come from the store.- The game set asks for just_physics_engine ^1.4.1, the version on pub.dev and the one the engine needs. ^1.5.0 doesn't exist, so
just doctorwarned about it in every new game.
0.1.3 #
- The Asset Store is part of the editor from just_game_engine_editor 0.1.0-dev.2, so the game set 2026.10 asks for the editor at ^0.1.0-dev.2 and no longer has just_asset_store_editor.
game init(just create) installs the editor alone, and a new game'sEditorWiring.moduleslists only the store items' modules (storeModules()). - The game set asks for just_game_engine ^2.0.0-dev.3, whose animators leave a scene's saved animation fields as they were authored (the third-person template reads the new playing values).
- The game set asks for just_asset_store ^0.1.1, which installs editor tools and kits into
plugins/{category}/{name}/and content intopackages/{category}/{name}/. - The release checks look for the editor's store module by its new names (
BuiltInAssetStoreModule,asset_store.open); just_asset_store stays forbidden in a release. game inittakes--localonce for each folder of checkouts, as just_core_cli 0.1.2'sjust create --localpasses them (saypackages/andplugins/), and registers the store items of all of them; a package checked out in two of them stops it.
0.1.2 #
- Needs just_core_cli ^0.1.1, which trusts just_asset_store from pub.dev (
PluginTrust.onPubDev). Game set 2026.10 takes the store from pub.dev, and just_core_cli 0.1.0 trusted it only from a checkout or its git repository, sogame init(just create) refused to run it under--yesand asked about it in a terminal. Now it runs without asking, as it did from its git tag. - just_asset_store is a dev dependency again, as it was before 0.1.1: the store is a tool, and a game never ships it.
game init --localregisters its checkout among the store items again. game link --unlink --checknames what each stranded package needs: its git source, or, for a store item,just store install <id>. It no longer tells you to add just_asset_store as a git dependency with no URL.
0.1.1 #
- The game set 2026.10 moves to just_game_engine_formats ^0.2.0, just_physics_engine ^1.5.0, just_graphics_engine ^0.1.0-dev.2, just_game_engine_editor and just_editor_core ^0.1.0-dev.1 (their first releases), just_third_person_kit ^0.1.0-dev.1, and has just_world_builder_kit ^0.1.0-dev and just_material_editor ^0.1.0-dev.1 (its first release). just_graphics_editor leaves the set: editing 3D graphics is the editor's own.
game scene validateaccepts entries that place a prefab.
0.1.0 #
just_editor_core, the editor's module contract split out ofjust_game_engine_editor, is in the game set (it comes with the editor and the kits) and editor-only for a release: nothing a release builds may import it.
The first release: the Just Game Engine's commands for just (just_core_cli 0.1.0), as a plugin every game has in its dev dependencies.
- Running and shipping:
game run [--editor];game build <platform> [--editor-entry], then a check that the release build holds no editor (and, in a 2D game, no 3D physics), on the web in the JavaScript and, from a--wasmbuild, the WebAssembly;game check [release-imports|release-build|formats]. - Scenes:
game scene list|new|rename|delete|order|migrate|validate, written as the editor writes them, and never while the editor has the project open. - The engine's versions:
GameSetholds the engine's packages (with the Asset Store from git and the editors from the store) and the Flutter and Dart they need;game initstarts a game on it,game doctorchecks against it, andgame upgrade [--check]moves the pubspec's one-line constraints to it (never a package that is ahead of it back) — theupgradehook ofjust upgrade, which fetches the packages in its transaction. - Setup and upgrades:
game doctor(the editor kept to debug builds and out of the game's imports and dependencies, git ignores, the macOS network entitlement);game migrate [--check] [--engine-only] [--force]rewrites old scenes, timelines and animator graphs in one transaction, and only those: a file of another kind is never read as one of them. An open editor stops it only when there is something to rewrite;--checkanswersjust upgradebefore it changes anything. - Hooks:
create(game init: the game template, the first level, the editor from the Asset Store, Flutter GPU for a 3D game),check,doctor,upgrade,migrateandlink(game link: store items registered afterjust dev link;just dev unlinkrefused while only the links supply a package), whichjust create,just check,just doctor,just upgradeandjust dev link|unlinkrun.game doctoralso checks the SDK floors, the engine's versions and the store's links to checkouts. - The toolkit, on every platform including the web (JavaScript and WebAssembly):
GameSet,GameTemplate,GameEntries,ReleaseRules,ReleaseImports,ReleaseBuild(withReleaseBuildFiles),FormatsCheckandEditorPresencework on text. Wheredart:iois, theGameProjectextension onJustProjectreads a game on disk for them (releaseRules(),editorReachableFrom(),checkReleaseBuild(),checkFormats(),editorIsOpen()), and the commands run.