Version 4.2.1 - Giedi - 9th July 2026 Fixes Stencil option stencilInvert works correctly (an alpha bug prevented it from having the intended effect) Framebuffers now correctly clear stencil on use The global stencil settings defaulted to deactivating the stencil write mask, so it couldn't actually run the clear process correctly. Write mask is now enabled by default, but is never triggered because…
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 mo…
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 numer…
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 manage…
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 a…
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.WrapMod…
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 rend…
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 rounde…
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 w…
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 onl…
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 S…