# GroveEngine - Modular C++ Architecture

# 🌳 GroveEngine

Experimental Modular C++ Engine Architecture
Blazing-fast hot-reload • Modular design • AI-assisted development
🔥 0.4ms Hot-Reload 🧩 Modular Architecture ⚠️ Experimental 📜 Dual License (GPL v3 / Commercial 1%)

## Functional Architecture

Application Layer
Game Logic Module Custom
Your game code - autonomous, hot-reloadable

- 200-300 lines recommended
- No infrastructure code
- Pure business logic

UI Module Phase 7
Complete widget system with 10+ widget types

- Button, Panel, Label, Slider
- Checkbox, TextInput, ProgressBar
- Image, ScrollPanel, Tooltip
- Retained mode rendering

Custom Modules Your Code
Add unlimited custom modules dynamically

- AI, Physics, Audio
- Networking, Persistence
- Hot-swappable

↓ Publish / Subscribe ↓

### 🔌 IIO Pub/Sub Messaging Layer

IntraIOManager • TopicTree Pattern Matching • Decoupled Communication
Sub-millisecond routing
Wildcard patterns (render:*, ui:*)
Zero module coupling
Thread-safe design
↓ System Services ↓
System Modules Layer
BgfxRenderer Phase 8
Multi-backend 2D rendering (DX11/12, OpenGL, Vulkan, Metal)

- Sprite batching by texture
- Tilemap instancing
- Particle effects
- Debug overlay (8x8 font)
- RHI abstraction layer

InputModule Phase 1-3
Cross-platform input handling with SDL2

- Mouse (move, button, wheel)
- Keyboard (keys, text input)
- Thread-safe buffering
- Gamepad: Phase 2 TODO

NetworkIO TODO
Distributed messaging and remote IPC

- Distributed pub/sub
- Remote module communication
- Network transparency

↓ Core Infrastructure ↓
Core Engine Infrastructure
ModuleLoader Validated
Dynamic .so/.dll hot-reload system

- 0.4ms average reload time
- 0.055ms best performance
- 100% state preservation
- Cache bypass on reload

SequentialModuleSystem Active
Single-threaded module execution

- Deterministic order
- Simple debugging
- Low overhead
- Multi-threaded: TODO

Factory Pattern Complete
Swappable infrastructure components

- EngineFactory
- ModuleSystemFactory
- IOFactory

## Performance Metrics

0.4ms
Hot-Reload Average
0.055ms
Best Reload Time
20+
Integration Tests
100%
State Preservation
1%
Commercial Royalty
GPL v3
Open Source License