How phase-rs/phase works
phase.rs is an MTG rules engine and game client: players build decks or draft, start games, make decisions through the client, and play against the rules engine or other players. The README documents the Rust engine running natively and as WASM, with browser and Tauri clients, AI, multiplayer, deck building, and metagame feeds. Source excerpts show details of the rules and native-engine layers, but not the full client wiring; edges below reflect documented relationships or indexed source references.
Main entry points: zone_pipeline.rs Rules engine · App.tsx React client · native_engine.rs Desktop host · DraftIntro.tsx Draft interface
Components 20
Game client
- React client
client/src/App.tsx - Desktop host
client/src-tauri/src/native_engine.rs - Engine adapters
client/src/adapter/engine-worker.ts - Game interface
client/src/components/board/GameBoard.tsx - Deck builder
client/src/components/deck-builder/DeckBuilder.tsx
Rules engine
- Rules engine
crates/engine/src/game/zone_pipeline.rs - Game state
crates/engine/src/game/game_object.rs - Combat rules
crates/engine/src/game/combat.rs - Ability rules
crates/engine/src/game/functioning_abilities.rs - Replacement effects
crates/engine/src/game/engine_replacement.rs - WASM engine
crates/engine-wasm/src/lib.rs
Game modes
- AI opponent
crates/phase-ai/src/session.rs - Draft sessions
crates/draft-core/src/session.rs - Draft interface
client/src/components/draft/DraftIntro.tsx
Online services
- Multiplayer server
crates/phase-server/src/persistence.rs - Message validation
crates/server-core/src/client_message_wire_guard.rs - Lobby service
lobby-worker/src/index.ts
Cards and feeds
- Card data
client/src/services/engineRuntime.ts - Metagame feeds
crates/feed-scraper/src/main.rs
Other components
- Player
Connections 19
- Player → React client: plays through
README.md - React client → Rules engine: uses rules
README.md - Rules engine → React client: drives gameplay
README.md - Player → Deck builder: builds decks
README.md - Player → Draft interface: drafts cards
README.md - Player → Lobby service: joins games
README.md - Rules engine → WASM engine: compiles to
README.md - Desktop host → Engine adapters: imports
client/src-tauri/src/native_engine.rs - Desktop host → Game interface: exposes gameplay
- Rules engine → Game state: uses game objects
crates/engine/src/game/zone_pipeline.rs - Rules engine → Replacement effects: consults effects
crates/engine/src/game/zone_pipeline.rs - Rules engine → Ability rules: reads active abilities
crates/engine/src/game/functioning_abilities.rs - Rules engine → Combat rules: resolves combat
crates/engine/src/game/zone_pipeline.rs - Rules engine → AI opponent: supports decisions
- Draft interface → Draft sessions: runs draft sessions
- Multiplayer server → Message validation: validates messages
- Lobby service → Multiplayer server: coordinates games
- Rules engine → Card data: uses card data
- Metagame feeds → Deck builder: supplies metagame data