phaser-migrate

Migrate Phaser 3 game projects to Phaser 4 by resolving breaking API changes.

17|1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/Yakoub-ai/phaser4-gamedev --skill phaser-migrate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: phaser-migrate
Source: https://github.com/Yakoub-ai/phaser4-gamedev/tree/main/skills/phaser-migrate
Command: npx skills add https://github.com/Yakoub-ai/phaser4-gamedev --skill phaser-migrate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill resolves the friction of upgrading game projects from Phaser 3 to Phaser 4 by identifying breaking API changes, behavioral drifts between release candidates, and deprecated features that cause silent failures.

Core Features & Use Cases

  • Breaking Change Detection: Automatically scans source code for removed classes like Geom.Point and deprecated plugins.
  • Behavioral Drift Correction: Provides specific guidance for RC6 to RC7 regressions, such as animation timing and geometry mask issues.
  • TypeScript Configuration: Ensures your project environment is correctly set up for the Phaser 4 type system.

Quick Start

Run the phaser-migrate skill to scan your current project directory for all necessary code updates and configuration changes required for a successful Phaser 4 upgrade.

Frequently Asked Questions about phaser-migrate

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

FAQPage Schema
How do I migrate my Phaser 3 game to Phaser 4?

Migrating a Phaser 3 game to Phaser 4 requires identifying breaking API changes, updating dependencies, and adjusting configurations for the Phaser Beam renderer. You must systematically verify geometry, animation, and physics logic for compatibility with Phaser 4 release candidates.

What breaking changes do I need to fix when upgrading to Phaser 4?

Upgrading to Phaser 4 involves fixing removed classes like Geom.Point and updating deprecated plugins. You also need to correct behavioral drifts between release candidates, such as animation timing and geometry mask issues that cause silent failures.

Do I need to update TypeScript configuration for Phaser 4?

Yes, updating TypeScript configuration for Phaser 4 is required to ensure your project environment is correctly set up for the new Phaser 4 type system. This prevents compilation errors during the source code refactoring process.

How do I resolve animation timing regressions in Phaser 4 release candidates?

Resolving Phaser 4 animation timing regressions requires applying specific behavioral drift corrections when moving between release candidates. You must target the animation logic directly to restore proper timing functionality affected during the upgrade.

What is the best way to scan my project for deprecated Phaser 3 features?

Scanning for deprecated Phaser 3 features is best handled by systematically analyzing your source code for removed classes and outdated plugins. This detects breaking API changes and identifies necessary refactoring for a successful Phaser 4 upgrade.

Why does my geometry mask logic fail silently after upgrading to Phaser 4?

Geometry mask logic fails silently after upgrading to Phaser 4 due to behavioral drift between release candidates. Correcting these specific regressions requires targeted verification of your geometry logic to ensure compatibility with the latest updates.