v3-to-v4-migration

Detail Phaser v3 to v4 breaking changes and API differences.

Updated Apr 26, 2026
One-click install
npx skills add https://github.com/kehwar/pixi-square --skill v3-to-v4-migration-kehwar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: v3-to-v4-migration
Source: https://github.com/kehwar/pixi-square/tree/main/.agents/skills/v3-to-v4-migration
Command: npx skills add https://github.com/kehwar/pixi-square --skill v3-to-v4-migration-kehwar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Migrating Phaser v3 projects to Phaser v4 is complex due to many breaking changes, API shifts, and platform updates. This skill provides a comprehensive guide and a migration checklist to help teams upgrade efficiently without missing critical steps.

Core Features & Use Cases

  • Comprehensive migration coverage including renderer changes (pipelines to render nodes), FX/mask replacements, tint, camera matrix, texture coordinates, DynamicTexture, shaders, lighting updates, and other v3-to-v4 changes.
  • Structured migration checklist that guides developers from initial assessment to code changes and testing, with real-world scenarios across common Phaser 3 projects.
  • Practical references and links to related topics (e.g., v4 new features, setup, and config considerations) to accelerate the upgrade process.

Quick Start

Run the migration guide to step through all breaking changes and complete the upgrade 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 my Phaser 3 project to Phaser 4?

Migrate Phaser 3 to Phaser 4 by stepping through a structured migration checklist that covers breaking changes, API differences, and practical upgrade steps across your codebase. This process guides you from initial assessment through code changes to testing.

What are the breaking changes when upgrading from Phaser 3 to Phaser 4?

Breaking changes in the Phaser 3 to Phaser 4 migration include renderer shifts from pipelines to render nodes, FX and mask replacements, camera matrix updates, texture coordinate changes, DynamicTexture modifications, and lighting and shader updates.

How do I handle renderer and shader changes in a Phaser v3 to v4 migration?

Handle renderer and shader changes in a Phaser v3 to v4 migration by transitioning from pipelines to render nodes and applying the provided shader and lighting update references to adjust your rendering logic.

Is there a migration checklist for upgrading large Phaser 3 codebases to v4?

Yes, a structured migration checklist exists for upgrading large Phaser 3 codebases to v4. It guides developers through initial assessment, code modifications for breaking changes, and testing with real-world scenarios across common projects.

Do I need to understand Phaser v3 to v4 API differences before starting the migration?

Yes, you need an understanding of Phaser v3 to v4 API differences before starting the migration. The process requires knowledge of breaking changes in cameras, textures, and masks to apply practical upgrade steps correctly.