1475505/miliastra-beyond-simulator

miliastra-beyond-simulator is a 2D + Lua development sandbox and playtest simulator for the miliastra/千星奇域 game engine. It executes client-side Lua scripts outside the real game, renders the corresponding UI, and reacts to player input so that an AI agent or a human developer can iterate on a project without repeatedly opening the official client and editor. The product is distributed as three independent packages that share the same core: a DeepSeek Harness plugin (dsh-plugin-beyond-simulator), a browser-based full-stack web app (beyond-simulator-web), and a local MCP stdio server (beyond-simulator-mcp). All three are published to npm under matching names and are also installable from the GitHub repository 1475505/miliastra-beyond-simulator or from a prebuilt .tgz whose filename and version are recorded in release/manifest.json.

The recommended workflow is a seven-step loop: write a design proposal, define TDD test cases, build an HTML prototype for confirmation, prepare art references and assets, implement the Lua scripts and UI in the simulator, run automated playtests, and finally verify the exported assets on the real engine. The Harness plugin additionally ships a "千星 2D+Lua 游戏制作" Agent preset that can be selected when starting a new session, and a playtest skill so the agent can drive the simulator, read screenshots, inspect logs, and replay recorded test timelines. Installation requires Node.js 22+; the Harness route uses dsh plugin --profile web add dsh-plugin-beyond-simulator (or github:1475505/miliastra-beyond-simulator for source builds) followed by dsh --profile web --dump-config and dsh web. Source builds also need pnpm 10.15.0, and the first install may prompt for build-script approval.

The editor covers 11 client widget types with image, text, and preset-button editors, supports 5 PC/phone canvases for layout checks, and simulates 1–8 local players across separate viewports with shared variables and signals. Save data is a single JSON archive containing server UI, client UI templates, and Lua scripts; the package can also export supported GIA subsets, UI authoring JSON, and individual script bundles. Important limits: emulator success does not guarantee real-device success, the server side only models variables and signals (no full official node graph or network play), image previews are limited to IDs 100001–100006, and the bundle does not include the official asset library or its Lua API docs. The project is licensed GPL-3.0-only; automated npm publishing is driven by npm-* Git tags after binding a Trusted Publisher, and the self-contained test suite runs from a clean checkout using only repo sources and synthetic data.