v18.3.0

What's New in melonJS 18.3.0

New Features

• Bezier curve drawing — bezierCurveTo(), quadraticCurveTo(), and arcTo() path methods, matching the Canvas 2D API. WebGL renderer tessellates via Path2D.
• Gradient fills — createLinearGradient() and createRadialGradient() methods for both Canvas and WebGL renderers, usable with all fill methods
• Dashed lines — setLineDash() and getLineDash() for stroke operations on both renderers
• Tiled object factory registry — extensible registerTiledObjectFactory() and registerTiledObjectClass() APIs for plugins to register custom Tiled object handlers without modifying engine code

Changed

• Application as entry point — new Application(width, height, options) auto-calls boot(), making it a standalone entry point. video.init() is deprecated.
• Game singleton decoupled — internal modules no longer import from the barrel index.js; game singleton uses setDefaultGame pattern
• Stage lifecycle — onResetEvent(app, ...args) and onDestroyEvent(app) now receive the Application instance as first parameter
• Container defaults — dimensions default to Infinity (no intrinsic size, no clipping), removing dependency on game.viewport
• EventEmitter — native context parameter support on on()/once(), eliminating .bind() closure overhead

Bug Fixes

• BitmapText bounding box — width uses last glyph visual extent; height uses actual glyph extents instead of capHeight; baseline shifts use real glyph metrics for all baselines; y offset starts at first visible pixel
• BitmapText multiline baseline — shift applied once for entire text block instead of per-line (which caused accumulating offsets)
• Camera2d — floating containers with Infinity bounds (e.g., HUD) are now always visible, fixing a regression where HUD elements stopped rendering
• Sprite flicker — time-based flickering (~15 flashes/sec) replaces per-draw-call toggle that broke with multi-camera setups
• Path2D — fix quadraticCurveTo/bezierCurveTo startPoint reference bug and adaptive segment count
• Application — fix settings mutation, white flash on load, pool cleanup errors
• WebGLRenderer — fix setBlendMode premultipliedAlpha tracking
• Text — fix multiline textBaseline y offset, power-of-two texture sizes

Performance

• BitmapText — precompute glyphMinTop/glyphMaxBottom once in font parsing; cache measureText results in setText/resize

v18.2.2

What's Changed

melonJS Team

• Chore: fix missing README on the npm release (58a534d)
• Copy root README into melonjs package during dist (6ef58cd)
• Bump spine-plugin to 2.0.1 (501de1f)

Full Changelog: 18.2.1...18.2.2

v18.2.1

What's Changed

melonJS Team

• Fix loading screen logo persisting after preload completes (3f0be6f)

Full Changelog: 18.2.0...18.2.1

v18.2.0

What's New in melonJS 18.2.0

New Features

• Multi-camera support — stages can now have multiple cameras for split-screen, minimaps, and multi-viewport layouts
• Extensible batcher system — custom Batcher subclasses with configurable maxVertices, indexed drawing (settings.indexed), and custom projection uniform names (settings.projectionUniform)
• Tiled 1.8–1.12 full support — oblique maps, capsule shapes, list properties, embedded base64 images, tile sub-rectangles, tilerendersize/fillmode, layer blend modes, per-object opacity/visibility, repeatx/repeaty, parallaxoriginx/parallaxoriginy, class-type properties, isCollection flag
• RoundRect as collision shape — can now be used for SAT collision via polygon-approximated rounded corners
• Expanded blend modes — Canvas: overlay, darken, lighten, color-dodge, color-burn, hard-light, soft-light, difference, exclusion; WebGL2: darken, lighten via gl.MIN/gl.MAX

Changed

• TypeScript — converted plugin, camera, particles emitter, state, audio, application, input, UI, and pointer modules to TypeScript
• CDN URLs — README now uses cdn.jsdelivr.net instead of esm.run (which is still in beta)

Bug Fixes

• WebGLRenderer — setBatcher() now rebinds the shared vertex buffer when switching batchers, allowing custom batchers with their own GL buffers
• WebGLRenderer — setBlendMode() now accepts a premultipliedAlpha parameter for correct blending with non-premultiplied textures
• Renderer — add base setBlendMode() and GPURenderer property to fix TypeScript casts
• Plugin — plugin.register() now uses pluginClass.name for reliable name derivation
• TMXTileset — fix animation key using first frame tile ID instead of the tile's own ID
• CanvasRenderer — replace bezier ellipse approximation with native context.ellipse() (with polyfill)
• Plugin — fix plugin.get() throwing TypeError when searching by name with no match
• Events — fix duplicate BLUR entry (was missing FOCUS)
• UIBaseElement — fix isDraggable JSDoc and released default
• Application — fix constructor options not being optional, fix getUriFragment() unsafe cast
• CanvasRenderer — setProjection() now properly applies the projection matrix as a canvas 2D transform

Spine Plugin

• @melonjs/spine-plugin migrated into the monorepo — custom SpineBatcher with two-color tinting, indexed drawing, expanded example with 17 official Spine characters

v18.1.0

What's New in melonJS 18.1.0

New Features

• ShaderEffect class — simplified custom shader API that only requires a fragment apply(color, uv) function. Vertex shader, uniforms, and texture sampling boilerplate are handled automatically. Silently disabled in Canvas mode.
• create-melonjs CLI — scaffold a new game project in seconds with npm create melonjs my-game
• Inline source code viewer — examples now have a "Show Code" button to view syntax-highlighted source alongside the running game
• API docs landing page — new home page with quick start, feature overview, and common tasks
• API docs categories — sidebar organized into 14 categories (Rendering, Physics, Input, etc.)

Changed

• Physics — collision response is now mass-proportional; overlap and velocity correction are split based on relative mass
• Entity — deprecated in favor of Sprite/Renderable + Body (#1008)
• Loader — modernized with Promise-based asset loading for improved parallel performance; onload/onProgress/onError deprecated in favor of events
• TMX — refactored TMXUtils into reusable decode.ts and xml.ts modules
• Compositor → Batcher — Compositor, QuadCompositor, PrimitiveCompositor renamed to Batcher, QuadBatcher, PrimitiveBatcher (old names still work with deprecation warnings)

Bug Fixes

• Texture cache overflow — flush and rebatch when GPU texture units are exhausted instead of throwing (#1280)
• setAntiAlias — now controls GL texture filtering (GL_NEAREST vs GL_LINEAR) on all bound textures (#1279)
• createPattern leak — clean up previous GPU texture when repeat mode changes (#1278)
• Custom shader support — properly flush and restore default shader per draw call, fix setUniform using wrong GL program, reset sampler uniform on shader switch
• TMX — fix hexagonal pixelToTileCoords mutation, canvas memory leak, collision shape dimensions, XML parsing crash, GC pressure from vector allocations
• Sprite — fix body-renderable misalignment with trimmed atlas frames, visual vibration on flip, jumping on rotated frames (#1201, #1214)
• Path2D — fix SVG arc parsing and ellipse rotation (#1198)
• WebGLRenderer — fix polygon corruption from vertex mutation, scissor restore, drawVertices vertex count, resize setAntiAlias corruption
• Z-ordering — fix reset during collision response

Performance

• TMX loading — ~20-40% faster via tileset caching, pre-allocated decode buffers, and fast path for base64 data
• WebGL rendering — fillRect, fillEllipse, fillArc, fillRoundRect, fillPolygon now generate geometry directly, bypassing path2D and earcut
• WebGL batching — quad rendering uses gl.drawElements with index buffer (33% less vertex data), redundant sampler calls eliminated, zero-allocation save/restore stacks
• Collision — index-based pool access instead of array push/pop in SAT detection
• Container — O(n) accumulator pattern in getChildByProp/getChildByType instead of O(n²)

Developer Experience

• 74 JSDoc typo and grammar fixes across 32 files
• Coin glow shader example in the platformer demo
• Updated typescript-boilerplate and plugin-template for melonJS 18
• Archived es6-boilerplate with redirect notice

Full Changelog: 18.0.0...18.1.0

v18.0.0

What's New in melonJS 18.0.0

New Features

• Color constructor — now also accepts another Color object as parameter
• Renderer — new backgroundColor property for clearing background between frames
• Pool system — new type-safe createPool() API with improved performance; destroy renamed to release

Changed

• Build system — replaced rollup with esbuild (@hornta)
• Documentation — replaced webdoc with typedoc (@hornta)
• Test framework — replaced mocha and puppeteer with vitest in browser mode (@hornta)
• TypeScript — extensive conversion across the codebase: color, math, geometry, platform, DOM, keyboard, timer, application settings, pool, and more (@hornta)
• Monorepo — migrated to pnpm workspaces with turbo (@hornta)
• Renderable — anchorPoint now uses the lighter ObservablePoint class instead of ObservableVector2d
• Math — namespace Math is now deprecated and renamed to math for consistency
• Deprecated API removal — all classes and methods deprecated since version 15 and lower have been removed (see Upgrade Guide)

Bug Fixes

• Body — fix setCollisionType() not accepting numeric values; fix setVertices() fallback creating Point instead of Polygon
• Camera — fix moveTo() upper bound clamping; fix focusOn() double-counting position
• Container — fix addChildAt() rejecting valid index; fix getNextChild() returning wrong child; fix removeChildNow() crash when not attached to root
• Physics — fix collision response velocity projection; fix shapes tunneling through polyline junctions; fix persistence for child bodies during reset (@Vareniel); fix step() crash with undefined ancestor
• Renderable — fix Light2D color blending in Canvas mode (@Vareniel)
• CanvasRenderTarget — fix arguments passed to convertToBlob() (@hornta)
• TypeScript — fix missing OffscreenCanvas type for TextureAtlas constructor
• Video — fix implicit global reference to HTMLVideoElement
• Docs — fix floating default shown for UI elements (@SergioChan)

Performance

• Collision — pre-built SAT function dispatch lookup table; reduced hot path overhead
• Container — cache camera references outside per-child update loop
• Physics — reduced iteration overhead in world.step()
• QuadTree — reduced array allocations in retrieve() and insert()
• Observable vectors — rewritten for better performance
• Color — faster clone() method
• Pool — optimized implementation

New Contributors

• @SergioChan made their first contribution

Full Changelog: 17.4.0...18.0.0

v17.4.0

Added

• Renderer: new lineJoin property to set the line join style (only support "round" for now in WebGL mode)
• Renderer: add support for line thickness for strokePolygon and strokeRect operations in WebGL

Changed

• Chore: Update to TypeScript 5.5

Fixed

• Renderer: fix fillEllipse() method in WebGL mode (that was stroking the ellipse instead)
• TypeScript: fix most (if not all) missing declarations

v17.3.0

Added

• Renderer: add support for line thickness when using strokeLine() in WebGL

Changed

• Renderer: the setLineWidth() method is now deprecated and replaced by a lineWidth class property

Fixed

• Renderer: fix animation when using multi-texture atlas in WebGL mode
• TMX: fix tsx file type import when using a React / Vue build step (thanks @customautosys)
• Typedef: fix missing definition for video.init() settings parameter, and Application constructor parameter

v17.2.0

Added

• Audio: add missing optional id parameter to 3D / Spatial audio methods
• Core: add platform detection if running as a standalone web app
• Loader: add missing unload implementation for font assets

Fixed

• Loader: properly return an error when attempting to load FontFace assets on non-browser platforms
• Renderer: fix a regression when a global canvas is available (e.g. webapp adapter for wechat)
• Renderer: fix a regression when forcing WebGL1 rendering mode (leading to an exception)
• Renderer: fix a regression when using the canvas rendering mode where antialias setting was not being applied on cached tinted elements

v17.1.0

Added

• Audio: added/exposed 3D Spatial Audio method (stereo(), position(), orientation() and panner())
• Loader: image resources can now take an array of src urls with different format (preparing for later usage)
• Math: added a isPowerOfFour() method
• Renderer: new renderTarget property specifying the default CanvasRenderTarget to use when rendering

Changed

• Renderer: CanvasTexture is now deprecated and replaced by a new CanvasRenderTarget class

Fixed

• Core: prevent multiple temporary canvas creation when calling isWebGLSupported multiple times