general
General Architecture Documentation
Core architectural concepts, design patterns, and system design documentation for Reaction v2.
Navigation
Core Architecture
- System Overview - Complete architectural design and module relationships
- Data Flow - Frame execution pipeline and module communication ⚠️ OUTDATED
- Performance Strategy - Optimization approaches and technical constraints
- Technical Decisions - Design choices and rationale
Implementation Guides
- Implementation Guide - Step-by-step implementation approach ⚠️ STUB
- Determinism - Fixed-point arithmetic and cross-platform consistency
- Variable Timing System - Time slice scheduling and player action management ⚠️ PROPOSED
- State Management - Snapshots, rollback, and multiplayer synchronization ⚠️ STUB
- Ghost Simulation - Predictive action visualization system ⚠️ PROPOSED
Architectural Approach
Modular Design: Modules with focused responsibilities
WebGPU Processing: Physics, reactions, and rendering use GPU compute
Deterministic Requirements: Identical inputs must produce identical outputs for PvP through simultaneous single-read/single-write GPU passes
Active Region System: Process only chunks with changing tiles ⚠️ NOT IMPLEMENTED: Active region optimization was decided against
Major Technical Challenges
⚠️ Unsolved Issues Requiring Design Work:
- Frame rate coordination between physics, reactions, and rendering systems
- GPU thread execution determinism guarantees (current approach: simultaneous read/write passes)
- Specific rule compilation pipeline implementation