MustafaKucukcoskun/Refine-agent-kit / shared/.agent/skills/phaser-patterns
phaser-patterns
VerifiedPhaser game development patterns for scene architecture, asset loading, pooling, physics, and input handling.
Phaser Patterns Skill
1. Scene Architecture
- Split each screen/section (Preload, MainMenu, Game, GameOver) into separate Phaser
Sceneclasses. - To fully stop the current scene and switch to another, use
this.scene.start('GameScene'). - To overlay screens without stopping (e.g., UI Overlay, Pause Menu), use
this.scene.launch('UI').
2. Asset Pipeline
- Always write a dedicated Boot/Preload Scene for efficient asset loading:
preload() { this.load.image('player', 'assets/player.png'); this.load.atlas('sprites', 'assets/sprites.png', 'assets/sprites.json'); // Texture Atlas is the best practice over multiple images. } - Never load assets via file system calls in the middle of gameplay (inside create or update).
3. Performance: Object Pooling
- For objects that constantly appear and disappear on screen such as bullets and enemies (open-world RPG, Bullet Hell, etc.), do NOT
sprite.destroy()andnew Sprite()each time. Garbage collection will cause the game to stutter. - Instead, create a
Phaser.GameObjects.GrouporPhysics.Arcade.Group, set dead objects tosetActive(false).setVisible(false), and when a new bullet is needed, pull a passive one from the group withgetFirstDead()and reactivate it.
4. Physics (Arcade vs Matter)
- For 90% of 2D Platformer, Top-down shooter projects, the
Arcadephysics engine is excellent (uses AABB collision, incredibly performant). ChooseMatter.jsif complex polygon hitboxes, chain mechanisms, or friction-based vehicle physics are required.
5. Input and Movement
- For simple movement, use
if (cursors.left.isDown)logic inside the Update method, but if moving with physics, do not directly manipulate the sprite's x,y coordinates (sprite.x += 1). Instead, direct the engine:sprite.setVelocityX(-200). - Coordinate manipulation breaks wall collision detection and can cause objects to pass through the camera.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 192k | Updated | Claude CodeCodex | Verified | Install |