A Bevy-aligned game engine in MoonBit, now running in a native-only architecture.

• mgstudio-engine/: engine core + native runtime bridge (runtime_native/*)
• mgstudio-page/: docs-only static site for example catalog and run instructions
• bevy/: local gitignored Bevy baseline checkout for parity reference
• scripts/: project scripts (native smoke, parity tooling)

1. Install MoonBit and update registry.
2. Run an example directly:

moon -C mgstudio-engine run --target native examples/3d/3d_scene

Representative examples:

• examples/2d/sprite
• examples/2d/2d_shapes
• examples/3d/pbr
• examples/3d/3d_shapes
• examples/3d/3d_scene
• examples/ui/widgets/button

• moon -C mgstudio-engine check --target native
• moon -C mgstudio-engine test --target native
• moon -C mgstudio-engine build --target native <package>
• ./scripts/smoke_bevy_examples.sh
• ./mgstudio-engine/scripts/parity_hard_gates.sh

• Static parity gates are run through ./mgstudio-engine/scripts/parity_hard_gates.sh and cover:
  • forbidden legacy shaders/mgstudio / shaders/mgstudio_runtime references
  • forbidden example asset provenance outside the engine runtime tree
• Visual runtime parity is checked separately through ./mgstudio-engine/scripts/gate_visual_runtime.sh.
• In CI, the static subset runs with MGSTUDIO_PARITY_SKIP_VISUAL=1, while the visual gate runs as its own macOS job and uploads screenshot/log artifacts.

See docs/PARITY_GATES.md for the current gate contract.

• MGSTUDIO_ASSETS_DIR (default: ./assets)
• MGSTUDIO_DATA_DIR (default: ./tmp/data)

• WASM/Web runtime and mgstudio CLI were removed in this native-only cutover.
• Planning artifacts under .private/ are git-ignored and should not be committed.