v3-to-v4-migration

Map Phaser v3 to v4 breaking changes into actionable migration steps.

1|Updated May 3, 2026

Search Tags:#migration #breaking changes #filters #phaser #phaser4 #render nodes #shader api

Ready to run

npx skills add https://github.com/WanderTheWeeb/papas_trauma --skill v3-to-v4-migration-wandertheweeb

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: v3-to-v4-migration
Source: https://github.com/WanderTheWeeb/papas_trauma/tree/main/skills/v3-to-v4-migration
Command: npx skills add https://github.com/WanderTheWeeb/papas_trauma --skill v3-to-v4-migration-wandertheweeb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the confusion and bugs caused by breaking API and rendering changes when upgrading a Phaser 3 project to Phaser 4.

Core Features & Use Cases

Renderer migration: Convert v3 custom WebGL pipelines to v4 RenderNodes using RenderConfig#renderNodes, and avoid direct WebGL calls to prevent state conflicts.
FX/mask and tint refactors: Replace v3 FX and BitmapMask with the unified Filter system (including mask migration), and update tint behavior using tintMode / Phaser.TintModes.
System-wide breaking changes checklist: Address camera matrix differences, GL texture coordinate orientation, DynamicTexture/RenderTexture render semantics, shader/GLSL loading updates, and removed objects/plugins/utilities.

Quick Start

Ask the assistant: "I’m upgrading my Phaser 3 codebase to Phaser 4—what exact changes do I need to make for renderer, filters/masks, tint, camera matrices, shaders, and the full migration checklist?"

Frequently Asked Questions about v3-to-v4-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I migrate custom WebGL pipelines to Phaser 4 render nodes?▼

To migrate custom WebGL pipelines to Phaser 4, convert them to RenderNodes using RenderConfig#renderNodes. Avoid direct WebGL calls during the migration to prevent state conflicts and ensure proper rendering behavior.

What is the best way to update Phaser 3 BitmapMask and FX for the new filter system?▼

The best way to update BitmapMask and FX for the new filter system is replacing them with the unified Filter system. This mask migration includes updating tint behavior using tintMode and Phaser.TintModes constants.

Why do my texture coordinates and camera matrices break after upgrading to Phaser 4?▼

Texture coordinates and camera matrices break after upgrading to Phaser 4 due to system-wide breaking changes involving GL texture coordinate orientation and camera matrix math differences. Update your affected logic to match the new v4 semantics.

How do I resolve shader and GLSL loading errors when upgrading to Phaser 4?▼

To resolve shader and GLSL loading errors when upgrading to Phaser 4, update your shader configuration and uniforms according to the new v4 loading updates. Use the structured migration checklist to address removed systems or objects.

Does Phaser 4 change how RenderTexture and DynamicTexture render behavior works?▼

Yes, Phaser 4 changes RenderTexture and DynamicTexture render behavior semantics. You must update affected code to follow the new v4 concepts for DynamicTexture and RenderTexture render methods during your migration process.