Skip to content

dawnlarsson/magic-framework

Repository files navigation







npx magic-framework new <folder-name>

Bun runtime is currently only supported.

🔮 Features

Core Functionality

  • CLI & Project creation
  • CLI <--> Client debug bridge, connection status overlay
  • Assets & Project hot-reloading
  • Project bundling

Development Tools

  • Data-driven per-instance state machine
  • Input support (keyboard, mouse, mobile touch, controllers (Xbox))
  • Binary static asset bundler

Work In Progress

  • Math utilities
  • Audio capabilities
  • Blazingly fast logging™

⚗️ TODOs

Build and Asset Management

  • Build step version of stateInstancer
  • MOF: Magic 3D Object Format
  • Mesh and material builder
  • Use web workers to load/parse asset bundle
  • Investigate: wasm module hot reload
  • Investigate: image formats, custom wasm decoder?
  • Investigate: Zig support (wasm)

Audio Enhancements

  • Volume control
  • Pitch adjustment

Blender Integration

  • Find local version of Blender
  • Overwrite MOF exporter script
  • .blend hot-reload exporter

Performance and Reloading

  • Chunked hot reload (no full rebuild)
  • WebGPU & WebGL integration

🪄 License

Magic Framework is licensed under MIT.

Logos and visual assets are created and copyright held by Alve Larsson, 2024.