Added State: a "pixelate" transition, state.transition("pixelate", color, duration, size): the screen breaks into growing blocks and comes back sharp. Skipped on Canvas Fixed Rendering: with subPixel off, each draw snaps to whole pixels once, where it lands, the same on Canvas, WebGL and WebGPU (#1765). Something at a fractional position can draw one pixel over Camera: with subPixel off, worldView…
Added Effects: colors take an alpha. Every color option and setColor takes [r, g, b] or [r, g, b, a], the alpha being the color's opacity ([r, g, b] stays opaque), RadialGradientEffect honours the alpha of its Color, and DropShadowEffect gains the setColor the others have. Four values used to break an effect (WebGL rejected them, and on WebGPU the fourth overwrote the next setting, such as an outl…
Fixed Rendering: entering a state no longer stalls its first frame compiling the shaders its stage had only started preparing. That frame now waits until they are ready, for at most 1.5s, and STATE_CHANGE and a transition's reveal come with it, so the reveal plays in full instead of running its course behind the stall Rendering: the first frame of a scene whose camera uses fog no longer stalls com…
Highlights: a game no longer stutters the first time an effect, a blend mode or a new kind of object appears. Shaders, pipelines and render targets are now prepared when the object is added, or during loader.preload(), rather than in the frame that first draws it, where a single first draw was measured at up to 140ms. Dropping a batch of meshes no longer stalls the frame either. Added Effects: Squ…
Added scaleRounding application setting: optional, and "fractional" by default, so nothing existing changes. "integer" constrains the automatic scale factor to a whole number of device pixels per source pixel and letterboxes the remainder, which is what stops pixel art showing uneven stems and shimmering edges; it applies to scaleMethod: "fit" only Sprite-sheet particles (framewidth, frameheight,…
What's Changed melonJS Team Release the adapters and the debug plugin alongside 20.8 (#1718) (86f2ff3) Release 20.8.0 (#1717) (20cc0c7) Examples: give the Ground Shadows scene a stage of its own (#1716) (32aa9d2) Ground shadows: shaped by the light, and laid on any floor (#1715) (555c543) Particles: motion in 3D, and the depth that culled every burst (#1713) (73d36fa) Changelog: bring the 20.8.0 e…
What's Changed melonJS Team Release 20.7.0 (#1695) (88402bc) Physics: a renderable that places itself collides at its pos (#1694) (b53c8d0) Physics: collision shapes follow the renderable, and segments collide as segments (#1693) (676314b) Physics: stop the builtin solver pushing bodies into static geometry (#1692) (c7247a8) Docs: the official plugins join the API reference (#1691) (82974fd) Physi…
What's Changed melonJS Team Release 20.6.0 (#1674) (ae6d96e) Jungle Rabbit: drop prewarmScene, which the preloader now does (#1673) (a22193f) Renderer: prewarm the mesh shaders and preloaded shader assets, behind the loading screen (#1672) (2094415) Camera: paint camera effects in screen space, so they draw on a Camera3d (#1671) (e9d161c) Examples: Jungle Rabbit, a low-poly river endless runner (#…
What's Changed melonJS Team Release 20.5.0 (#1669) (099678c) skills: align physics, UI and pooling with the source; fix the platformer's dead z (#1668) (919b92e) deviceTest: the example rendered no text at all (#1667) (3f1e30d) Renderer: sort the transparent pass by geometry, not by origin (#1666) (d1dc0b3) Camera roll, a degenerate-fade audio fix, and public Gradient rasterisation (#1665) (45e61e…
What's Changed melonJS Team Renderer: two caches that never hit, one per backend (#1652) (5ab23f5) Examples: the 3D examples await their level load (#1651) (398c40f) Level: an async option on load/reload/next/previous, and a microtask deferral (#1647) (6c3cba2) docs: correct how the skills installer places files (#1643) (44dc944) Distance fog: measure the height above the camera in view space (#16…
What's Changed melonJS Team Agent skills, an llms.txt API index, and the defects verifying them uncovered (#1620) (8e2f9be) chore: drop core-js, melonJS now has no runtime dependencies (#1618) (e55796e) audio: bring the backend in-tree, and give the loader a proper seam (#1617) (0a6fd85) ci: retry once when vitest loses its browser page (#1615) (8f05ba0) docs(readme): replace the dead bundlephobia…
What's Changed melonJS Team docs: write down the changelog convention, and refresh the release docs (#1613) (6b22c04) test(bench): stop drawmesh_bench wedging the shared GPU process (#1612) (1f871de) perf(webgpu): memoize the per-quad segment slot lookup (#1608) (7047a7d) perf(particles): compute particle bounds lazily (#1607) (441a392) fix(webgpu): reset batchers when a frame is abandoned (#1609)…
What's New A bug-fix release, and mostly one bug wearing seven faces. Two crashes were reported from a game in production; chasing the first turned up five siblings of the same shape, all fixed here. The shape: an engine loop hands control to your code, then carries on using state your code was free to tear down. "Remove me when this animation finishes" and "remove it on pickup" are the most ordin…
What's New Collision events, per shape. A body built from several shapes could only ever report one contact: onCollision and the onCollision* lifecycle surface the single pair chosen for physical resolution, so a character's footprint contact masked a simultaneous hurtbox contact. The new onShapeCollisionStart / onShapeCollisionActive / onShapeCollisionEnd report every overlapping shape pair, with…
What's New A new WebGPU backend, and WebGL 2 as the baseline. Version 20.0 introduces a complete WebGPU renderer covering the entire engine feature set, 2D and 3D, verified example-for-example against WebGL. At the same time the aging WebGL 1 path is retired, which frees the WebGL backend to modernize throughout. video.AUTO now tries WebGPU first, falls back to WebGL 2 if that is unavailable, and…
What's New 19.9.1 is a focused bug-fix release for the 19.9 line — 17 fixes, two long-standing open issues closed, no API additions, drop-in upgrade from 19.9.0. The headline: video sprites no longer stall in fullscreen. Large videos (1080p/4K) dropped to ~4fps the moment the game went fullscreen while everything else kept rendering at 60 — the browser parks off-DOM video elements on a slow backgr…
What's New Shader effects made easy. Effects that used to demand WebGL expertise, like a pond rippling with the scene reflected in it, heat haze, or frosted glass, now take a few lines of shader code: the engine hands your effect the screen behind it and the right coordinates, animated noise textures come built-in, and shaders preload like any other asset. See the new Water Overworld example for a…
What's New 3D grows up. glTF / GLB scene loading lands — author a scene in Blender (or any DCC tool), export a .glb, and load it like a Tiled map with level.load(...), with node animation, authored lighting, and real 3D bounds. And Sprite3d brings the 2.5D workflow: billboarded, frame-animated cut-out sprites that face a Camera3d (the Paper Mario look), sharing one FrameAnimation engine with the 2…
What's New 19.7.1 is a focused bug-fix release for the 19.7 line. Three engine bugs and a noise reduction — no breaking changes, no API additions, drop-in upgrade from 19.7.0. Alongside this release: @melonjs/spine-plugin 3.0.0 ships with Spine 4.3 runtime support, Skeleton.yDown adoption, native WebGL context-loss recovery, and a fully reworked Canvas renderer. The plugin requires melonjs >= 19.7…
What's New in melonJS 19.7.0 Highlights: Camera3d perspective camera lands. Every batched shader carries per-sprite depth as vec3 aVertex, unlocking 3D-projected sprites and meshes. Backward compatible with existing 2D code. New Features Camera3d — perspective camera extending Camera2d with fov, aspect, pitch, yaw, followOffset, lookAhead. Opt in via new Application(w, h, { cameraClass: Camera3d }…
What's New in melonJS 19.6.0 WebGL context-loss hardening release. Fixes a Windows + Chrome crash where a GPU switch lost the WebGL context and a partial GLShader.destroy() left the next frame's setUniform("uTime", …) reading from null uniforms. Beyond the crash, the renderer now transparently recovers the rest of the pipeline (vertex buffer, default GL state, batchers, texture cache) across a web…
What's New in melonJS 19.5.0 A physics-focused release. The headline is the new PhysicsAdapter abstraction — the same game code can now run on either the engine's built-in SAT physics (default, unchanged behavior) or on a third-party rigid-body engine via the physic Application setting. Two official adapters ship alongside the engine: @melonjs/matter-adapter (wraps matter-js) and @melonjs/planck-a…
What's New in melonJS 19.4.0 New Features GPU-accelerated WebGL 2 tile rendering for orthogonal TMX maps — each visible layer now renders as a single quad whose fragment shader walks the per-layer GID index texture and samples the tileset atlas, with no per-tile draw loop. Supports animated tiles, flip bits (H/V/AD), per-layer opacity/tint, per-layer blend mode, and oversized bottom-aligned tiles.…
What's New in melonJS 19.3.0 New Features Normal-map sprite lighting (closes #1416) — Sprite.normalMap accepts a paired normal-map image (or auto-detected from TextureAtlas({ normalMap })). Sprites with a normal map render through a dedicated LitQuadBatcher whose fragment shader runs a Lambertian light loop over the active Light2d instances — up to 8 concurrent lights, configurable Stage.ambientLi…
What's New in melonJS 19.2.0 New Features state.freeze(duration, music?) + Application.pause/resume/freeze — hit-stop / hit-pause primitive that pauses the stage for a fixed duration then auto-resumes. Returns a Promise<void> that resolves on unfreeze. Reentrant calls extend (don't stack); window blur cancels the freeze. Convenience proxies on Application for the same. Multi-pass post-effect chain…
What's New in melonJS 19.1.0 New Features Multi-texture batching — up to 16 textures drawn in a single batch/draw call, eliminating GPU flushes on texture changes. Automatically falls back to single-texture mode when a custom ShaderEffect is active. ~80% fewer draw calls on the platformer example (14 vs ~70 flushes/frame), with an estimated 30-50% FPS improvement on low-end mobile devices. highPre…
What's New in melonJS 19.0.0 New Features 3D mesh rendering — Mesh class for textured 3D triangle meshes with OBJ/MTL model loading, drawMesh() on both WebGL and Canvas renderers, Matrix3d.perspective() for perspective projection, mesh-to-canvas/ImageBitmap export and convex hull collision shapes 15 built-in ShaderEffect presets — FlashEffect, OutlineEffect, GlowEffect, DesaturateEffect, PixelateE…