Version 4.2.0 - Giedi - 19th June 2026

New Features

• New game config options:
  • render.alphaStrategy: hint to shaders to handle alpha in different ways.
  • render.stencil: disable stencil buffer creation in a game, saving memory.
  • render.stencilAlphaStrategy: set the default alpha strategy used within Stencil objects, where regular alpha does nothing.
• CustomContext game object is a container which can modify the DrawingContext at render time. This is an advanced rendering technique which reaches into the deep settings of the renderer. Potential uses include:
  • Toggling stencil testing
  • Selectively activating alpha handling strategies
  • Freehand GL scissor modification
• Mesh2D game object renders textured triangles. It batches with regular sprites.
  • Mesh2D#buildOrderedIndices precomputes an optimized index list (Mesh2D#indicesOrdered) which arranges triangles into quad-forming pairs, synthesizing degenerate triangles where a triangle has no edge-sharing partner. You choose the optimization strategy (0 fast, 1 medium, 2 high), paying the cost once when the topology is stable. Use Mesh2D#useOrderedIndices (and Mesh2D#setUseOrderedIndices) to toggle between the ordered and unordered lists without rebuilding.
  • Mesh2D#renderAsTriangles (and Mesh2D#setRenderAsTriangles) renders the mesh as individual triangles via the new BatchHandlerTri render node, which is suitable for dynamic topology that cannot be optimized into quads.
• BatchHandlerTri render node draws individual textured triangles (gl.TRIANGLES) as a batch. It extends BatchHandlerQuad, reusing its shader, vertex layout, and texture handling, and adds a batchTriangles method which accepts vertex and index arrays directly.
• TransformerVertex render node now splits its per-vertex run into setupMatrix (build the transform matrix once per GameObject) and transformVertex (project a single vertex with the cached matrix). Mesh rendering uses this to avoid rebuilding the transform matrix for every vertex. run is unchanged for existing callers.
• Stencil game object is a container whose contents modify the stencil buffer. This is a fast way to persistently mask the game canvas. There are many ways to combine stencils. The default approach is to add layers to the stencil mask.
  • Unlike stencil masks in Phaser 3, Stencil objects are universal, persistent, and support anything as a stencil source, so long as it draws pixels. Use sprites and filter outputs as stencil sources!
  • Operating modes include addLayer, subtractLayer, clear, and clearRegion. Add and subtract can be inverted.
• StencilReference game object re-renders a target Stencil with different settings. This is useful for removing or reusing stencil geometry.
• AlphaStrategy setting used in the render system allows you to use GLSL discard instead of alpha in many shaders. This is inefficient, but is useful for some effects and situations.
  • Game config can set a default alpha strategy.
  • Stencil and CustomContext allow you to set an alpha strategy.
  • Most Phaser shaders handle alpha strategy. Custom shaders must implement it themselves, but you can use compositing (filtersForceComposite) to run graphics through a compatible shader.
  • Strategies include:
    • keep: use alpha as normal.
    • dither: use a dithering algorithm to select pixels to discard.
    • threshold: discard all pixels below a certain alpha.
• BatchHandler render node now has a config option for topology, allowing extended nodes to opt into different triangulation modes.
• BatchHandlerTri render node renders textured triangles. It is used by Mesh2D in triangle rendering mode. This can be more efficient than attempting to compile triangles into quads, which is the default strategy.
• DrawingContext adds more controls:
  • Alpha strategy
  • Color writemask
  • Stencil parameters
• WebGLGlobalWrapper now handles stencil write mask.
• WebGLStencilParametersFactory now takes an extra writeMask parameter.
• TintModes.MULTIPLY_TWO is a new tint mode which uses a secondary color. This can create powerful new tint effects, such as fire or inversion.
  • To support this, the encoding of tint mode in shaders with the ApplyTint addition has been changed. The inTintEffect shader attribute has changed from a float to a vec4, and its encoding has changed from a float32 to four uint8s. This should only affect deep uses of the render system.
  • Game objects with the Tint component now support a second tint per corner (tint2TopLeft etc), and have a new method setTint2(). Additionally, the Mesh2D and Tile objects support constant tint via tint2. (TilemapGPULayer does not support tinting on tiles.)
• Timestep#setFPSLimit method changes the frame rate at runtime. This method updates derived properties, making it safer than manually adjusting Timestep#fpsLimit.

New Feature: Cone Lights

Cone lights are standard Phaser dynamic lights restricted to a directional cone. They are useful for flashlights, lantern beams, vision cones, headlights, searchlights, and other focal light sources.

Cone lights run through the existing WebGL lighting shader. They do not require a mask, a second Camera, or rendering the map twice. Any Game Object that already works with Phaser lighting can be lit by a cone light.

Full details can be found in the Phaser 4 Cone Lights.md file in the docs folder in this repo.

• Light.coneEnabled is a new boolean property that controls if the light is restricted to a cone.
• Light.coneRotation is a new number property that sets the cone direction in radians.
• Light.coneInnerAngle is a new number property that sets the inner cone angle in radians.
• Light.coneOuterAngle is a new number property that sets the outer cone angle in radians.
• Light.setCone is a new method that sets a Light to be a Cone light.
• Light.setConeRotation is a new method that sets the cone light rotation.
• Light.setConeAngles is a new method that sets the cone light inner and outer angles.
• Light.disableCone is a new method that disables a cone light.
• LightsManager.addConeLight is a new method that creates a cone-limited light.
• The DefineLights GLSL shader gains two new uniforms: vec2 direction and vec3 cone.

Thanks to @FSDevelop for adding this feature.

Changes

• GameObjects.Components.Filters now adds its RenderStep just before the core render method. This allows other steps to run beforehand.
• WebGLStencilParametersFactory now defaults to:
  • enabled: true (stencil test is on by default; testing showed little performance impact)
  • func: gl.EQUAL (stencil test now passes if the stencil buffer is EQUAL to 0)

Fixes

• Layer no longer has a duplicate RenderStep which does nothing.
• SpriteGPULayer no longer tries to access global namespace for Phaser functionality, which can cause a crash in modules.
• SpriteGPULayer no longer has a Mask component, as it's a Canvas feature but the object is WebGL only.
• DrawingContext no longer attempts to unbind textures based on the game canvas, which cannot exist and just wastes time.
• A Blitter will now call destroy on its Bob Game Objects as part of its own destroy process. Fix #7292 (thanks @samme)
• Fixed a bug where the Line width and height values were not being updated after a call to setTo(). Fix #7270 (thanks @samme)
• Phaser.Math.Pow2 now exports GetPowerOfTwo, IsSizePowerOfTwo and IsValuePowerOfTwo. Fix #7309 (thanks @Visualizeit
  )

Version 4.1.0 - Salusa - 30th April 2026

New Features

• RenderConfig#mipmapRegeneration option allows certain framebuffer-based objects to use mipmaps if the game is configured to use mipmaps. This has a cost because mipmaps must be recreated after every change. Currently it only applies to DynamicTextures; Filters cannot render mipmaps. Thanks @flow!
• Layer is now a true GameObject. This fixes numerous small inconsistencies, and some big issues such as Filters not working. Thanks @rexrainbow for reporting the initial issue!
• The base filter Controller now has getPaddingCeil(), which returns the ceiling of the current padding. This is mostly used internally to avoid quality loss from fractional padding. If your code calls getPadding() on a filter controller (typically in a custom render node), you should replace it with getPaddingCeil().

Fixes

• Fix reversions in rounded rectangle handling. Thanks @laineus!
• Remove duplicate function definition and exposed internal code docs from RectangleCanvasRenderer.
• Fix duplicate texture name resulting from RenderTexture#saveTexture. Thanks @UnaiNeuronUp!
• Fix framebuffers (in filters and DynamicTextures) using mipmaps incorrectly. Now filters do not render with mipmaps. Thanks @flow!
• Fix lack of default export in ESM build. Thanks @kibertoad!
• Fix lack of Class and LOG_VERSION export in ESM build. Thanks to many users including @flow and @rex for helping investigate this!
• Fix Utils.Array.GetRandom often returning null if only startIndex was specified. Now it always returns an array element if part of the array is within range, as documented.

After years of development, Phaser 4 is here. This is the biggest release in Phaser's history - a ground-up rebuild of the WebGL renderer with a completely new architecture, while keeping the API you know and love.

Highlights

• New Render Node Architecture - The v3 pipeline system has been replaced with a clean, node-based renderer. Each render node handles a single task, WebGL state is fully managed, and context restoration is built in. Faster, more reliable, and much easier to extend.
• Unified Filter System - FX and Masks from v3 are now a single, powerful Filter system. Apply filters to any game object or camera with no restrictions. Ships with Blur, Glow, Shadow, Pixelate, ColorMatrix, Bloom, Vignette, Wipe, ImageLight, GradientMap, Quantize, Blend, and many more.
• SpriteGPULayer - Render a million sprites in a single draw call, up to 100x faster than standard rendering. GPU-driven animations on position, rotation, scale, alpha, tint, and frame.
• TilemapGPULayer - Render an entire tilemap layer as a single quad. Per-pixel shader cost means up to 4096 x 4096 tiles with no performance penalty. Perfect texture filtering with no seams.
• Overhauled Tint System - Six tint modes: MULTIPLY, FILL, ADD, SCREEN, OVERLAY, HARD_LIGHT. Color and mode are now separate concerns.
• New Game Objects - Gradient, Noise (Cell 2D/3D/4D, Simplex 2D/3D), CaptureFrame, and Stamp.
• Improved Lighting - As simple as sprite.setLighting(true). Self-shadows, explicit light height, works across most game objects.
• Shader and TileSprite Improvements - Cleaner config-based Shader API, #pragma GLSL directives, TileSprite now supports atlas frames and tile rotation.
• AI Agent Skills - 28 comprehensive skill files included in the repository covering every major Phaser subsystem, plus a dedicated v3 to v4 migration skill. Point your AI coding agent at the skills/ folder for deep Phaser 4 knowledge.

Install

npm install phaser

Links

• 📖 Full Changelog
• 🔄 Migration Guide (v3 to v4)
• 📚 API Documentation](https://docs.phaser.io)
• 🎮 Examples
• 💬 Discord

Thank You

Phaser wouldn't have been possible without the fantastic support of the community. Thank you to everyone who supports our work, who shares our belief in the future of HTML5 gaming, and Phaser's role in that.

Happy coding everyone!

Rich and the whole team at Phaser Studio

New Features

• Actions.AddEffectBloom allows you to quickly set up a bloom effect, using several filters, on a target Camera or GameObject.
• Actions.AddEffectShine allows you to quickly set up a shine effect, using a new Gradient and filters, on a target Camera or GameObject.
• Actions.AddMaskShape allows you to quickly add shapes to a target Camera or GameObject as Masks. Blurred edges and inversion are supported.
• Actions.FitToRegion transforms an object to fit a region, such as the screen.
• Display.Color: several helper methods now support modifying an existing Color object instead of creating a new one.
  • HSLToColor
  • HexStringToColor
  • IntegerToColor
  • ObjectToColor
  • RGBStringToColor
  • ValueToColor
• Display.Color.Interpolate: an extra interpolation mode is available.
  • HSVWithHSV: new method to interpolate HSV values, in HSV space.
  • ColorWithColor has new parameters to allow it to operate in HSV space.
    • hsv flag sets it to operate in HSV space.
    • hsvSign flag can force it to interpolate hue either ascending or descending. Default behavior picks the shortest angle.
• Display.ColorBand describes a transition between two colors. Intended for use in gradients.
• Display.ColorRamp describes a range of colors using ColorBands. Intended for use in gradients.
• GameObject#isDestroyed flag helps you avoid errors when accessing an object that might have removed expected properties during destruction.
• GameObjects.Gradient is a new game object which renders gradients.
  • Gradient shapes include:
    • LINEAR
    • BILINEAR
    • RADIAL
    • CONIC_SYMMETRIC
    • CONIC_ASYMMETRIC
  • Gradient repeat modes include:
    • EXTEND: flat colors extend from start and end.
    • TRUNCATE: transparency extends from start and end.
    • SAWTOOTH: gradient starts over every time it completes.
    • TRIANGULAR: gradient reverses direction every time it gets to the end or start.
  • Optional Interleaved Gradient Noise based dithering to eliminate banding.
• GameObjects.NineSlice has two new parameters: tileX, tileY, which allow non-corner regions of the NineSlice to tile instead of stretch. Some stretching is still applied to keep the tile count a whole number. Thanks to @skhoroshavin for this contribution!
• GameObjects.Noise renders noise patterns.
  • Control value power curve.
  • Select from trigonometric or PCG algorithms.
  • Output grayscale, random color, or random normals.
• Cellular noise objects: GameObjects.NoiseCell2D, NoiseCell3D and NoiseCell4D provide cellular/Worley/Voronoi noise.
  • Render cellular noise with sharp or smooth edges, or random flat colors.
  • Smoothly animate scroll through the XY plane or evolve the pattern through Z or ZW axes.
  • Add octaves of detail.
  • Supports rendering as a texture or normal map for use in other effects.
• Simplex noise objects: GameObjects.NoiseSimplex2D and NoiseSimplex3D provide simplex noise.
  • Render simplex noise, the successor to Perlin Noise.
  • Use gradient flow to smoothly loop noise animation.
  • Add octaves of detail.
  • Apply turbulence and output shaping for a variety of effects.
  • Supports rendering as a texture or normal map for use in other effects.
• Tint is overhauled.
  • tint and setTint() now purely affect the color settings.
    • Previously, both would silently deactivate fill mode.
  • tintFill and setTintFill() are removed.
  • New property tintMode and new method setTintMode() now set the tint fill mode.
  • Phaser.TintModes enumerates valid tint modes.
    • MULTIPLY
    • FILL
    • ADD
    • SCREEN
    • OVERLAY
    • HARD_LIGHT
  • FILL mode now treats partial alpha correctly.
  • BitmapText tinting now works correctly.
  • Conversion tip: foo.setTintFill(color) becomes foo.setTint(color).setTintMode(Phaser.TintModes.FILL).
• CombineColorMatrix filter for remixing alpha and other channels between images.
• GradientMap filter for recoloring images using a gradient and their own brightness.
• Key filter for removing or isolating colors.
• ImageLight filter for image-based lighting, a soft, highly realistic form of illumination.
• PanoramaBlur filter for adjusting images for ImageLight.
• NormalTools filter for manipulating normal maps.
• Quantize filter for reducing colors and dithering.
• Vignette filter returns from Phaser 3.
  • Now sets a configurable border color instead of erasing alpha.
  • Also supports limited blend modes.
• Wipe filter returns from Phaser 3.
  • Now allows you to set the texture displayed in wiped-away regions.
  • Now provides helper functions to set directional reveal/wipe effects.
• Math.Hash provides fast hashes of 1, 2, 3, or 4 dimensional input, using trigonometric or PCG methods.
• Math.HashCell provides hashes of 1, 2, 3, or 4 dimensional input, using hash results in a Worley noise field. This produces a continuous but lumpy field.
• Math.HashSimplex provides hashes of 1, 2, or 3 dimensional input, using a simplex noise implementation. This produces a continuous, smooth field.
• Texture#setSource method for updating the source of a texture. Note that, while the source will update, derived values such as object sizes will not. It's advisable to switch between textures of identical size to avoid unexpected transforms.
• Texture#setDataSource method already existed, but has been changed to be more useful like setSource.
• TextureManager#addFlatColor method for creating a flat texture with custom color, alpha, width, and height. This is intended to act as a temporary stand-in for textures you might not have loaded yet.
• TextureSource#updateSource method for switching sources directly.
• New Phaser.Types.Textures.TextureSource and Phaser.Types.Textures.TextureSourceElement types to simplify the increasing number of sources for a texture.

Fixes

• Fix TimeStep#stepLimitFPS to drop fewer frames, running much more smoothly at the target frame rate. Thanks to @flow and @Antriel for discussing the topic.
  • Documentation in FPSConfig#limit now clarifies that frame limits are only necessary when artificially slowing the game below the display refresh rate.
• Fix Shape not respecting lights even though it had the lighting component.
• Fix SpriteGPULayer creation time handling getting confused by 0.
• Fix blend modes leaking onto siblings within a Container. Thanks to @saintflow47, @tickle-monster and @leemanhopeter for reporting this.
• Fix texture offsets in ParseXMLBitmapFont. Thanks to @leemanhopeter.
• Fix DynamicTexture turning black if it initially has a power-of-two resolution and is resized to a non-power-of-two resolution. Now any WebGL texture resize will wrap with REPEAT if it is power of two, or CLAMP_TO_EDGE if not. Thanks to @x-wk for reporting this.
• Fix TextureManager.addUint8Array method, which got premultiplied alpha wrong and flipY wrong.

New Features

• Texture#setWrap() provides easy access to texture wrap mode in WebGL, which would otherwise be very technical to alter on WebGLTextureWrapper objects. This is probably of most use to shader authors. Thanks @Legend-Master for raising an issue where power-of-two sprites had unexpected wrapping artifacts.
• Phaser.Textures.WrapMode.CLAMP_TO_EDGE is always available.
• Phaser.Textures.WrapMode.REPEAT will only be applied to textures with width and height equal to powers of 2.
• Phaser.Textures.WrapMode.MIRRORED_REPEAT likewise requires powers of 2.
• Added new optional sortByY parameter to the Tilemap createFromObjects method (thanks @saintflow47)

Clarifications

• Clarified that Tilemap.createLayer() with gpu flag enabled only works with orthographic layers, not hexagonal or isometric. Thanks @amirking59!

Updates

• Gamepad buttons initialize as not being pressed, which created a problem when reading Gamepads in one Scene, and then reading them in another Scene. If the player held the button down for even a fraction of a second in the first scene, the second scene would see a bogus Button down event. The Button class now has a new optional isPressed boolean parameter which the Gamepad class uses to resolve this, initializing the current pressed state of the Button (thanks @CryonautLex)

Fixes

• Blend filter parameter texture now correctly documented as string.
• ColorMatrix filter correctly blends input alpha.
• ColorMatrix.desaturate is no longer documented as saturation.
• Container now updates the blend mode it passes to children more accurately, preventing blend modes from leaking from one child into another child's filters. Thanks @leemanhopeter!
• Filters now correctly handles non-central object origins when the object is flipped. Thanks @ChrisCPI!
• Glow filter acts consistently when knockout is active.
• Grid shape now sets stroke correctly from optional initialization parameters, at 1px wide. (Use Grid#setStrokeStyle() to customize it further.) Thanks @Grimshad!
• Mask filter now correctly resizes and clears when the game resizes to an odd width or height, fixing a bug where masks might overdraw themselves over time. Thanks @leemanhopeter!
• ParallelFilters filter memory leak eliminated (this would occur when both passes had active filters).
• TilemapGPULayer now respects camera translation. Thanks @aroman!
• Fixed a crash in TweenBuilder when the targets array contains null or undefined elements (thanks @aomsir)
• The Loader GetURL function did not treat file:// URLs as absolute. When a baseURL is set, it gets prepended to an already-absolute path, producing double-prefixed URLs (thanks @aomsir)
• Fixed a bug where multiple Timeline events with once set to true would silently break the timeline and prevent all future events from firing. Fix #7147 (thanks @TomorrowToday)

Examples, Documentation, Beta Testing and TypeScript

Thanks to the following for helping with the Phaser Examples, Beta Testing, Docs, and TypeScript definitions, either by reporting errors, fixing them, or helping author the docs:

@chavaenc
@Urantij
@justin-calleja
@DayKev
@samme
@ospira

New Features

• Mask filter now supports scaleFactor parameter, allowing the creation of scaled-down framebuffers. This can save memory in large games, but you must manage scaling logic yourself. Thanks to kimdanielarthur-cowlabs for developing the initial solution.
• Camera has the new property isObjectInversion, used internally to support special transforms for filters.
• Shader has the new method renderImmediate, which makes it straightforward to use renderToTexture when the object is not part of a display list, or otherwise needs updating outside the regular render loop.

Improvements

• Drawing contexts, including filters, can now be larger than 4096 if the current device supports them. Thanks to kimdanielarthur-cowlabs for suggesting this.
• Balance rounded rectangle corners for smoothness on small corners while preventing excessive tesselation.

Fixes

• PhysicsGroup.add and StaticPhysicsGroup.add will now check to see if the incoming child already has a body of the wrong type, and if so, will destroy it so the new correct type can be assigned.
• Blocky filter now has a minimum size of 1, which prevents the object from disappearing.
• TilemapGPULayer now takes the first tileset if it receives an array of tilesets (which is valid for Tilemaps but not for TilemapGPULayer). Thanks to ChrisCPI for the fix.
• Filters now correctly transform the camera to focus objects with intricate transforms.
• Filters now correctly handle parent transforms when focusing to the game camera.
• DynamicTexture method startCapture now handles nested parent transforms correctly. This is used in Mask, so masks within Container objects should behave correctly too.
• Children of filtered Container/Layer objects are correctly added to the current camera's renderList. This fixes an issue with input on overlapping interactive objects.

This update improves performance related to data buffer size, primarily affecting filters, including masks. A game that was bottlenecked by filters on mobile devices may experience speedups of 16x or more. A desktop system, or a scene with no filters, may be broadly unaffected, save for memory savings.

New Features

• BatchHandlerQuadSingle render node added.
  • This is just a copy of BatchHandlerQuad with space for 1 quad.
  • The rendering system uses this node internally for transferring images in some steps of the filter process.

Changes

• BatchHandler render nodes now create their own WebGL data buffers.
  • This uses around 5MB of RAM and VRAM in a basic game.
  • Dedicated buffers are an optimum size for batch performance.

Removals

• WebGLRenderer#genericVertexBuffer and #genericVertexData removed.
  • This frees 16MB of RAM and VRAM.
• BatchHandlerConfig#createOwnVertexBuffer type property removed.
• TileSprite no longer supports texture cropping.

Fixes

• Lighting fixed on rotated or filtered objects.
• Added missing 'this' value for Group.forEach and StaticGroup.forEach (thanks @TadejZupancic)
• Fix createFromTiles to handle multiple tilesets when using sprite sheets. Fix #7122 (thanks @vikerman)
• Fix audio files not loading from Base64 data URIs (thanks @bagyoni)

Documentation / TypeScript Enhancements

Thanks to the following people:

@captain-something
@DayKev
@ixonstater

Version 3.90 - Tsugumi - 23rd May 2025

New Features

• GameObjects.Rectangle.setRounded is a new method that will allow the Rectangle Shape Game Object to have rounded corners. Pass the radius to set for the corners, or pass a value of zero to disable rounded corners.
• GameObjects.Rectangle.isRounded is a new read-only boolean that can be used to determine if the Rectangle Shape Game Object has rounded corners, or not.
• GameObjects.Rectangle.radius is a new read-only number that is the size of the rounded corners. Do not set directly, instead use the method setRounded.
• Added Phaser.Math.Angle.GetClockwiseDistance() to get the shortest nonnegative angular distance between two angles. PR #7092 (thanks @samme)
• Added Phaser.Math.Angle.GetCounterClockwiseDistance() gets the shortest nonpositive angular distance between two angles. PR #7092 (thanks @samme)
• Added Phaser.Math.Angle.GetShortestDistance() gets the shortest signed angular distance between two angles. (This is like Phaser.Math.Angle.ShortestBetween() but in radians.) PR #7092 (thanks @samme)
• Added Phaser.GameObjects.BitmapText#setDisplaySize method to BitmapText to get the original scaled size of 1. PR #6623 (thanks @samme)
• Added fallback for Web Audio on Firefox. Firefox doesn't implement positionX, positionY and positionZ properties on the AudioListener instances at the moment. This prevents the follow feature from WebAudioSound to operate on Firefox. PR #7083 (thanks @raaaahman)

Updates

• The EXPAND Scale Mode has been updated to now clamp the size of the canvas that is created, preventing it from growing too large on landscape ultra-wide displays. Fix #7027 (thanks @leha-games @rexrainbow)
• An Error will now be thrown if you try to create a DOM Game Object but haven't correctly configured the Game Config (thanks @samme)

Bug Fixes

• An erroneous console.log was left in the Text Game Object. This has now been removed.
• Particle emitter color RGB arrays are cleared before repopulating. Fix #7069 (thanks @Golen87 @samme)
• Phaser.Animations.AnimationFrame correctly uses frame duration when it is set. Fix #7070 (thanks @sylvainpolletvillard)
• Particle emitter custom moveTo functions can now move particles. Fix #7063 (thanks @samme)
• Changed ImageCollections default Tileset values from null to undefined. Fix #7053 (thanks @Snoturky)
• Chained tweens now persist correctly even after calling Phaser.Tweens.BaseTween#stop. Fix #7048 (thanks @FranciscoCaetano88)
• New left-to-right Text Game Objects now includes the default canvas.dir = 'ltr and context.direction = 'ltr';. Fixes a bug in Chrome 134 & Edge 134 where calling destroy() on a right-to-left Text Game Object prevents the next created left-to-right Text Game Object from rendering. Fix #7077 (thanks @Demeno)
• Grid Game Objects renders lineWidth correctly in WebGL mode. Fix #7029 (thanks @AlvaroNeuronup)
• Added collisionMask and collisionCategory checks to Phaser.Physics.Arcade.World#separate to allow individual physics game objects within a physics group to have it's own unique collision categories. Fix #7034 (thanks @frederikocmr)
• Fixed Arcade Physics bug causing immovable circle objects to move when pushed by polygons. Fix #7054 (thanks @hunkydoryrepair)
• Fixed createFromTiles to handle multiple tilesets when using sprite sheets. Fix #7122 (thanks @vikerman)
• Fixed audio files not loading from Base64 data URIs (thanks @bagyoni)

Examples, Documentation, Beta Testing and TypeScript

Thanks to the following for helping with the Phaser Examples, Beta Testing, Docs, and TypeScript definitions, either by reporting errors, fixing them, or helping author the docs:

@justin-calleja
@ixonstater
@DayKev

This release candidate introduces better pixel art controls, and fixes performance issues related to pixel art options.

Updates since RC2:

New Features

• GameObject#vertexRoundMode added to control vertex pixel rounding on a per-object basis.
  • Options include:
    • "off": Never round vertex positions.
    • "safe": Round vertex positions if the object is "safe": it is rendering with a transform matrix which only affects the position, not other properties such as scale or rotation.
    • "safeAuto" (default): Like "safe", but only if rendering through a camera where roundPixels is enabled.
    • "full": Always round vertex positions. This can cause sprites to wobble if their vertices are not safely aligned with the pixel resolution, e.g. during rotations. This is good for a touch of PlayStation 1 style jank.
    • "fullAuto": Like "full", but only if rendering through a camera where roundPixels is enabled.
  • GameObject#willRoundVertices(camera, onlyTranslated) returns whether vertices should be rounded. In the unlikely event that you need to control vertex rounding even more precisely, you are intended to override this method.
• Blocky filter added. This is similar to Pixelate, but it picks just a single color from the image, preserving the palette of pixel art. You can also configure the pixel width and height, and offset. This is a good option for pixelating a retro game at high resolution, setting up for additional filters such as CRT emulation.

Changes

• WebGL2 canvases are now compatible with the WebGL renderer.
• Optimize multi-texture shader.
  • Shader branching pattern changed to hopefully be more optimal on a wider range of devices.
  • Shader will not request the maximum number of textures if it doesn't need them, improving performance on many mobile devices.
  • Shader no longer performs vertex rounding. This will prevent many situations where a batch was broken up, degrading performance.

Fixes

• WebGLSnapshot and snapshot functions based on it now return the correct pixel, instead of the one above it (or nothing if they're at the top of the image).
• ArcadePhysics#closest() and #furthest() are properly defined (thanks @samme).
• GamepadPlugin.stopListeners and GamepadPlugin.disconnectAll now have guards around them so they won't try to invoke functions on potentially undefined gamepads (thanks @CryonautLex)
• Arcade Physics OverlapCirc() and OverlapRect() error when useTree is false. Fix #7112 (thanks @samme)

Documentation / TypeScript Enhancements

Thanks to the following people:

@ospira
@samme
@OuttaBounds
@raaaahman

Updates since RC1:

New Features

• RenderConfig#renderNodes allows you to add render nodes at game boot.
• ShaderQuadConfig#initialUniforms lets you initialize a Shader with uniforms on creation.
• Shader#setUniform(name, value) lets you set shader program uniforms just once, instead of putting them all into the setupUniforms() method, where some uniforms might be set redundantly after init. This wraps Shader#renderNode.programManager.setUniform.

Changes

• TextureManager#addDynamicTexture now has forceEven parameter.

Fixes

• Fix parent transform on filtered objects (e.g. masks inside containers).
• Fix camera shake.
• Add typedefs for the { internal, external } structure of Camera#filters (and GameObject#filters).
• Fix FilterList#addMask docs.
• In Layer and Container objects, use that object's children for the displayList passed to RenderWebGLSteps.
• Fix positioning of Group members and offset objects in DynamicTexture#draw.
• Fix Shadow filter direction.