mage

Appearance

Changelog ​

patch: v3.31.1 Latest ​

Level loading fixes:

  • Levels whose names contain spaces or capitals (e.g. "Sunny Meadow") now load their preloaded assets — level asset keys keep their exact case instead of being lowercased
  • Router now URL-decodes the location hash, so navigating to such a level no longer bounces back to /; Router.goTo encodes each route segment to match
  • Each texture URL is now fetched and decoded once: repeat loads of the same file (including particle textures) reuse the first load, with a per-use clone so wrap/repeat/offset settings stay independent
  • Images.load now waits for textures, so a level's textures are ready before it starts

minor: v3.31.0 ​

Collision decomposition:

  • A MODEL_SHAPE collider can now use collision variants — precomputed sets of convex hulls shipped alongside a model — to approximate concave shapes (doorways, arches, gaps) that a single convex hull would fill in
  • Select a variant per placed instance with the new collisionVariant physics option; each hull in the set becomes a leaf of the element's compound body, and every leaf still reports contacts under the model's own UUID
  • Variant hull sets are loaded automatically from model asset dependencies keyed collision:<variant>

minor: v3.30.0 ​

  • Version re-tag of v3.29.0; no functional changes.

minor: v3.29.0 ​

Model-shape colliders and static collision events:

  • New MODEL_SHAPE collider type (briefly named HULL during development) — wraps the element's own geometry in a convex hull, ideal for imported models. It collides with every other collider type and can be static or dynamic
  • New collisionEvents physics option: opt a static (mass-0) body into collision reporting so overlapping static bodies emit PHYSICS_EVENTS.ELEMENT.COLLISION — useful for trigger zones (events only, no physical response)
  • A subtree whose colliders are all NONE is now treated as a valid "no collider" configuration instead of an error

patch: v3.28.2 ​

Collider building overhaul:

  • All Box, Sphere, MODEL_SHAPE and NONE colliders are now built through a single world-space path, so a collider lines up with its visible mesh regardless of scale, rotation, geometry offset, or nesting — and a runtime enablePhysics() collider is placed identically to an imported one
  • Rotated box colliders are now sized by their true extents instead of an inflated axis-aligned bounds
  • New NONE collider type: an element with no shape of its own that still acts as the rigid frame its physics-enabled descendants weld to
  • Sky and Skybox scenery are now excluded from physics — they no longer generate enormous colliders
  • Physics realization is now isolated per element on import, so one bad element can't abort the whole scene

patch: v3.28.1 ​

Reparenting and import fixes:

  • Child scale is now persisted when reparenting elements
  • Child transforms are reconstructed relative to their parent on import
  • Fixed case-mismatched relative imports inside the engine

minor: v3.28.0 ​

Compound physics bodies:

  • Rigidly-attached children now contribute compound colliders to their parent's physics body
  • Compound bodies are rebuilt when elements are reparented at runtime
  • Fixed compound child collider placement

patch: v3.27.4 ​

Kinematic colliders:

  • Added kinematic collider support for movable platforms — kinematic bodies push dynamic bodies but are driven by their element's transform

patch: v3.27.3 ​

Per-axis texture wrapping:

  • setTexture options now support wrapS and wrapT for independent horizontal/vertical wrapping
  • The legacy single wrap option still works as a fallback for both axes

patch: v3.27.2 ​

Texture offset:

  • setTexture options now support offset: { x, y } alongside repeat
  • Added Element.setTextureOptions(textureType, options) to update options on an already-set texture

patch: v3.27.1 ​

Reparenting fix:

  • World transform is now preserved when reparenting elements out of, or between, parents

minor: v3.27.0 / v3.26.0 ​

Per-level physics configuration:

  • Physics can now be configured per level via the physics config resolver
  • Configurable gravity ({ x, y, z }) and simulation step settings, merged over common defaults
  • Fixed a TDZ crash in handleVehicleUpdate and camera positioning in SmoothCarFollow

patch: v3.25.8 ​

Bounding box unification:

  • Unified how bounding boxes are calculated across the engine
  • Sphere and player collider sizes now use world-space AABBs

patch: v3.25.7 ​

Layers and overridable bounding boxes:

  • Gizmos are now rendered on a separate layer
  • Element.boundingBox can now be overridden
  • Now re-exporting LineSegments2, LineSegmentsGeometry and LineMaterial

patch: v3.25.6 ​

Physics dispatcher fix:

  • Added missing sendElementDisposed to the physics dispatcher

patch: v3.25.5 ​

Behaviour change — default physics mass:

  • Bodies without an explicit mass are now static (mass: 0) instead of dynamic (mass: 1)
  • Set mass explicitly on elements that should react to forces and gravity

patch: v3.25.4 ​

Physics race condition:

  • Fixed the retry loop in setThirdPersonControls to clear stale entries before re-adding

patch: v3.25.3 ​

On-demand physics:

  • Physics is now enabled on demand when Third Person Controls are requested — no need to enable physics upfront in your configuration

patch: v3.25.2 ​

Error handling:

  • Added missing .catch() on the init() chain in GameRunner.start()

patch: v3.25.1 ​

Physics and Third Person Controls improvements:

  • Improved the physics system and third person controls behaviour
  • Removed debug logging, engine-wide lint cleanup

minor: v3.25.0 ​

Third Person Controls:

  • New ThirdPersonControl, available via controls.setThirdPersonControls(target, options) and the CONTROLS.TPS constant
  • Physics pipeline fixes to support character controllers
  • Added new examples

patch: v3.24.10 ​

Universe fix:

  • Fixed universe imports

patch: v3.24.9 ​

Keyboard input:

  • isKeyPressed is now tracked correctly using keydown/keyup events

patch: v3.24.8 ​

Mouse input:

  • Controls now dispatch the previously missing drag_end event

patch: v3.24.7 ​

Camera serialization:

  • Camera position is now synced from its holder before serializing in toJSON

patch: v3.24.6 ​

Scene integrity:

  • Duplicate elements are now prevented when adding elements to the scene

patch: v3.24.5 ​

Importer fixes:

  • Fixed importing cameras
  • Fixed FBX models that have a root offset

patch: v3.24.4 ​

Animations and skeletons:

  • Skinned models and their skeletons are now handled correctly
  • Added animation crossfade functions for smooth transitions between animations

patch: v3.24.3 ​

Scenery effects:

  • Scenery effects are now usable outside of examples, with working import/export

patch: v3.24.2 ​

Parent/child handling:

  • Better parent/child handling using attach/add, with correct position handling and importing

patch: v3.24.1 ​

Particles fix:

  • Fixed deleting emitters

minor: v3.24.0 ​

Particles rewrite:

  • All particle emitters now use only the Proton engine
  • Particle emitters can now be imported and exported (serialization support)

patch: v3.23.44 ​

Lights fix:

  • Lights now update their matrix when updated

patch: v3.23.43 ​

Lights fix:

  • Fixed using the wrong function when deserialising sunlights

patch: v3.23.42 ​

Editor support:

  • Camera holder now sets its UUID correctly and is selectable

patch: v3.23.41 ​

Behaviour change — element storage:

  • Elements are now stored and looked up by UUID instead of by name

patch: v3.23.40 ​

Camera improvements:

  • Camera now supports setPosition() method with position syncing
  • Added getPosition() returning a plain {x, y, z} object
  • Added update(dt) method to Camera class

Asset path resolution improvements:

  • Root-relative paths (starting with /) are now preserved as-is across Audio, Images, and Models loaders
  • These paths are served from the public folder and no longer have MAGE_ASSETS_BASE_URL prepended incorrectly

patch: v3.23.39 ​

Asset path resolution improvements:

  • Root-relative paths (starting with /) are now preserved as-is across Audio, Images, and Models loaders
  • These paths are served from the public folder and no longer have MAGE_ASSETS_BASE_URL prepended incorrectly

patch: v3.23.38 ​

Input validation improvements:

  • Added better input validation for number types
  • Improved validation across input handlers

patch: v3.23.37 ​

Importer fixes:

  • Models are now correctly imported into the scene

patch: v3.23.36 ​

Build and importer fixes:

  • Fixed babel version target for better browser compatibility
  • Fixed importer texture loading issues

patch: v3.23.35 ​

Material import improvements:

  • Now setting all material properties correctly on import

patch: v3.23.34 ​

Importer path fix:

  • Fixed importer not using the correct asset path

patch: v3.23.33 ​

Texture runtime fix:

  • Added missing needsUpdate=true after setting textures at runtime

patch: v3.23.32 ​

Asset URL handling:

  • Better handling of asset URLs throughout the engine

patch: v3.23.30 ​

Loader updates:

  • Updated FBXLoader to latest version

patch: v3.23.29 ​

URL resolution:

  • Using correct URLs for asset loading

patch: v3.23.28 ​

Image path fixes:

  • Fixed images not using resolved paths (part 2)

patch: v3.23.27 ​

Image path fixes:

  • Fixed images not using resolved paths

patch: v3.23.26 ​

Missing asset handling:

  • Better handling of missing assets with improved error messages

patch: v3.23.25 ​

Asset importing improvements:

  • Better importing of modules using MAGE_ASSETS_BASE_URL environment variable for relative path resolution

patch: v3.20.1 ​

Better tweening:

  • exposing tweenTo function from easing module.
  • Supporting repeat option for between.js

minor: v3.20.0 ​

Fixed a series of issues:

  • Keyboard input was compromised and no longer working.
  • Lights body was not properly set.
  • Added easing functions and looping to the constants.
  • Fixed camera not setting its body properly.

minor: v3.19.0 ​

Added Labels to the engine. The following has been added:

  • LabelComponent: When creating a Label, make your Inferno component extend the LabelComponent class, as it has the required instructions for the engine.
  • Label element: uses an Inferno component to render HTML as 3D content in your application.
  • html-to-image: This library is being used to export Inferno components to images.

patch: v3.17.10 ​

Added missing .None to easing function used by Entities.

patch: v3.17.9 ​

Fixed typo.

patch: v3.17.8 ​

Fixed a bug occuring when switching levels with Physics settings enabled.

patch: v3.17.7 ​

Improved disposal of Entities.

patch: v3.17.6 ​

A few improvements:

  • Models.getModel has been renamed to Models.get : a deprecation warning message will be displayed when using getModel
  • Entities now have a addTo method, which allows Entities to be added to other entities. (Similar to .add, but with addTo the Entity is the child).

patch: v3.17.5 ​

Performance improvements.

patch: v3.17.4 ​

fixed SelectiveOutline

patch: v3.17.3 ​

Retrieving hierarchy, updated lights names

### patch: v3.17.2

Supporting Other texture maps.

minor: v3.17.0 ​

Particle Systems are now extending Entity.

patch: v3.16.7 ​

New Math function, new Pass.

patch: v3.16.3 ​

Fixed error in Physics, exporting builtin Scripts.

minor: v3.16.0 ​

Fixed many things, new Scripts, improved Element class.

patch: v3.15.2 ​

Added Palettes.

patch: v3.15.1 ​

Allowing uI to be enabled/disabled in config.

patch: v3.14.2 ​

Allowing transparent scene.

patch: v3.14.1 ​

Physics is dispatching explosions.

minor: v3.14.0 ​

Improved Physics events:

javascript
export const PHYSICS_EVENTS = {
    DISPATCH: 'physics:dispatch',
    TERMINATE: 'physics:terminate',
    LOAD: {
        AMMO: 'physics:load:ammo',
    },
    READY: 'physics:ready',
    INIT: 'physics:init',
    UPDATE: 'physics:update',
    
    ADD: {
        BOX: 'physics:add:box',
        VEHICLE: 'physics:add:vehicle',
        MODEL: 'physics:add:model',
        PLAYER: 'physics:add:player',
        SPHERE: 'physics:add:sphere',
    },

    ELEMENT: {
        DISPOSE: 'physics:element:dispose',
        COLLISION: 'physics:element:collision',
        UPDATE: 'physics:element:update',

        SET: {
            POSITION: 'physics:element:set:position',
            QUATERNION: 'physics:element:set:quaternion',
            LINEAR_VELOCITY: 'physics:element:set:linear_velocity'
        },

        APPLY: {
            IMPULSE: 'physics:element:apply:impulse'
        }
    },

    VEHICLE: {
        SET: {
            POSITION: 'physics:vehicle:set:position',
            QUATERNION: 'physics:vehicle:set:quaternion'
        },
        RESET: 'physics:vehicle:reset',
        
        SPEED: 'physics:vehicle:speed',
        DIRECTION: 'physics:vehicle:direction'
    }
};

patch: v3.13.3 ​

Introduced new physics events:

RESET_CAR_EVENTSET_CAR_QUATERNION_EVENT

These two events are currently not used by the Physics module.

patch: v3.0.4 ​

Fixed an issue where the keyboard was not supporting numbers.

patch: v3.0.3 ​

Sprites can now rotate using setRotation(angle).

patch: v3.0.2 ​

Fixed a bug in the Mouse module, that wasn't dispatching the right events.

patch: v3.0.1 ​

Fixed a bug where sprites didn't receive mouse input.

MAJOR: v3.0.0 🥳 ​

Renamed Scene to Level, renamed BaseMesh to Element and BaseEntity to Entity.

Copyright © 2026 Mage Studio