Plugin Migration Status (historical)

Lifecycle: HISTORICAL SUPPORTING
Recovered from legacy wiki path content/archive/architecture/PLUGIN_MIGRATION.md (attic copy retained; not deleted).
Prefer current SSOT pages for production decisions. Last promoted: 2026-07-20.

Plugin Migration Status — Funday App Shell

This document tracks the progress of migrating existing games to the unified app shell with FundayBridge v1.

Legend

✅ Completed
🚧 In Progress
⏳ Pending
❌ Not Started

Migration Checklist

Plugin	Embed Mode (`?embed=1`)	Bridge Events	HUD Integration	Notes
hexapipes	✅	✅	✅	Reference implementation for Svelte plugin
pong-multiplayer	✅	✅	✅	Uses Agones allocation for multiplayer
tictactoe-multiplayer	✅	🚧	🚧	Needs telemetry wiring
networked-snake-multiplayer	✅	✅	✅	Integrated with FundayBridge v1 and embed mode
battle-arena-demo	⏳	⏳	⏳	Requires embed adaptation
minigolf	⏳	⏳	⏳	Awaiting asset cleanup
snake-casual	✅	✅	✅	Integrated with FundayBridge v1 and embed mode
yatzy	⏳	⏳	⏳	Group table support needed
nitro-racers	⏳	⏳	⏳	3D canvas adjustments required
neodreams	⏳	⏳	⏳	Large asset migration

Migration Steps

Embed Mode
- Detect ?embed=1
- Hide plugin chrome
- Ensure responsive layout (100% viewport)
Bridge Events
- Handshake (ack)
- game:ready
- funday:nav:set
- funday:analytics-event
- funday:score-submitted
HUD Integration
- Update titles/status
- Provide actions (pause/restart)
- Report latency/players if applicable
Testing
- Standalone vs embed
- Theme/locale reactiveness
- Agones allocation (if dedicated)

Next Actions

Prioritize high-traffic games: pong-multiplayer, hexapipes, snake series
Create bridge wrappers for React/Vue plugins
Coordinate with dev teams for asset cleanup
Add automated tests for embed regressions

References

Bridge Spec: docs/BRIDGE_V1.md
Plugin Embed Guide: docs/PLUGIN_EMBED_GUIDE.md
App Shell Guide: docs/APP_SHELL.md
Sandbox Security: docs/SANDBOX_SECURITY.md
SDK: /game-plugins/_sdk/funday-bridge.js