phaser-scene-navigation
Standardized patterns for Phaser scene transitions, navigation testing, and scene lifecycle management. Use when testing scene transitions, navigating between game scenes, or when scene navigation discovery issues occur. Documents scene transition methods, wait patterns, and console log fallback verification.
来源信息
- 仓库
- pmarashian/cursor-agent-skills
- 最近来源活动
- 2026年2月13日 19:51
- 检测到的 SKILL.md 语言
- 英语
- 星标
- 2
- 分支
- 1
安装方式
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
检查来源文件
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
文件资源管理器
3 个文件正在显示 SKILL.md
SKILL.md
来源说明 · 只读预览- name
- phaser-scene-navigation
- description
- Standardized patterns for Phaser scene transitions, navigation testing, and scene lifecycle management. Use when testing scene transitions, navigating between game scenes, or when scene navigation discovery issues occur. Documents scene transition methods, wait patterns, and console log fallback verification.
# Phaser Scene Navigation
## Overview
Standardize Phaser scene transitions and navigation testing patterns. Improve reliability of scene navigation testing.
## Scene Transition Methods
- `this.scene.start('SceneName', data)` - Start new scene with data
- `this.scene.switch('SceneName')` - Switch to existing scene
- Test seam: `window.__TEST__.commands.clickStartGame()` - Navigate via UI
See `references/transition-methods.md` for detailed transition patterns.
## Navigation Testing
**Use test seam commands when available**:
- `clickStartGame()` - Navigate to game
- `clickPlayAgain()` - Restart game
**Wait patterns**:
- Wait for scene initialization before accessing test seam
- Wait 1-2 seconds after transition before checking test seam
- Use console logs to verify scene transitions
**Don't rely solely on test seam sceneKey** (may lag on transitions)
See `references/navigation-testing.md` for detailed testing patterns.
## Scene Lifecycle
- Test seams are set up in `create()` method
- Each scene creates its own `window.__TEST__` object
- Old scene's test seam may persist briefly after transition
- Wait 1-2 seconds after transition before checking test seam
## Common Navigation Patterns
- **MainMenu → GameScene**: Use `clickStartGame()` test command
- **GameScene → LevelCompleteScene**: Automatic on exit reach
- **GameScene → GameOverScene**: Automatic on timer expire
- **Any scene → MainMenu**: Use `this.scene.start('MainMenu')`
## Resources
- `references/transition-methods.md` - Scene transition methods and data passing
- `references/navigation-testing.md` - Wait patterns, console log verification
在 GitHub 查看