v4-new-features

Phaser 4 adds Filters replacing FX and BitmapMask, RenderNodes replacing Pipelines, new game objects like CaptureFrame, Gradient, Noise, SpriteGPULayer, and TilemapGPULayer, plus Lighting and RenderSteps components and new tint modes.

Call enableFilters() on the game object, then use filters.internal for object-local effects or filters.external for screen-space effects. For example, sprite.filters.internal.addGlow() replaces sprite.preFX.addGlow() from v3.

No, SpriteGPULayer supports a single texture per layer with no multi-atlas support. It renders up to millions of quads in one draw call, and members should be populated once since buffer updates are expensive.

RenderNodes replaced Pipelines in Phaser 4. Each RenderNode handles a single rendering task via a run() method, and game objects reference nodes through role-based maps like Submitter, Transformer, and Texturer.

TilemapGPULayer supports only a single tileset with one texture image, orthographic tilemaps only, and a maximum of 4096x4096 tiles. Editing tiles requires a manual generateLayerDataTexture() call to update the layer.

Call sprite.setLighting(true) instead of the v3 setPipeline('Light2D') approach. Self-shadowing is enabled with setSelfShadow(), and lighting works on Image, Sprite, Text, TilemapLayer, and most other game objects.