project-mobile-command/README.md
StillHammer 3dfaffc75a Setup initial: Mobile Command project with GroveEngine
- Architecture basée sur GroveEngine (hot-reload C++17)
- Structure du projet (src, config, external)
- CMakeLists.txt avec support MinGW
- GameModule de base (hot-reloadable)
- Main loop 10Hz avec file watcher
- Configuration via JSON
- Documentation README et CLAUDE.md

 Build fonctionnel
 Hot-reload validé
🚧 Prochaine étape: Prototype gameplay

🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-01 11:05:51 +08:00

157 lines
4.3 KiB
Markdown

# MOBILE COMMAND
**Survival Management / Base Building / Tactical Expeditions**
Genre de jeu de gestion/survie où vous commandez un train blindé mobile à travers l'Ukraine en guerre (2022-2025).
## Concept Central
**"La guerre change. Tu dois changer avec elle."**
Gérez un train blindé et ses expéditions (drones + humains). L'économie du jeu suit la réalité de la guerre :
- **2022** : Humains abondants, drones rares, scavenge facile
- **2025** : Humains quasi-impossibles à recruter, drones industrialisés, scavenge = suicide
Le jeu force une évolution : De commandant infantry-heavy (2022) à opérateur de swarms de drones (2025).
## Stack Technique
- **Engine** : GroveEngine (hot-reload C++17 module system)
- **Plateforme** : PC (Steam)
- **Rendu** : 2D (sprites ou vector)
- **Public** : 16+ (Thèmes de guerre, violence, choix moraux)
- **Build** : CMake 3.20+, MinGW/GCC
## Architecture Projet
```
mobilecommand/
├── external/
│ └── GroveEngine/ # GroveEngine (symlink vers ../groveengine)
├── src/
│ ├── main.cpp # Main application loop
│ └── modules/
│ └── GameModule.* # Core game loop (hot-reloadable)
├── config/
│ └── game.json # Game configuration
├── build/ # Build directory
│ ├── mobilecommand.exe # Main executable
│ └── modules/ # Hot-reloadable modules (.dll)
└── CMakeLists.txt
```
## Getting Started
### Prerequisites
- CMake 3.20+
- C++17 compiler (MinGW/GCC on Windows)
- GroveEngine (included via symlink)
### Build
```bash
# Configure (first time)
cmake -B build -G "MinGW Makefiles"
# Build everything
cmake --build build -j4
# Build modules only (for hot-reload workflow)
cmake --build build --target modules
```
### Run
```bash
# Run from build directory
cd build
./mobilecommand.exe
# Or use the run script
./run.sh
```
### Hot-Reload Workflow
1. Start Mobile Command: `./build/mobilecommand.exe`
2. Edit a module: `src/modules/GameModule.cpp`
3. Rebuild: `cmake --build build --target modules`
4. **Module reloads automatically with state preserved**
## Piliers de Design
1. **Gestion/Optimisation** (core) - Puzzles logistiques, choix difficiles
2. **Survival Tension** - Ressources critiques, pertes permanentes
3. **Progression Temporelle Inversée** - Courbes Humains/Drones qui s'inversent
4. **Événements > Combat** - 70% events/survie, 30% combat
5. **Drones + Humains** - Valeurs différenciées (drone = outil, humain = irremplaçable)
## Systèmes Clés
### Train Builder (Double Slice)
- Vue double slice (Gauche + Droite)
- Balance 2 axes (Latéral G↔D, Longitudinal Avant↔Arrière)
- Déséquilibre → malus vitesse/fuel
- Rebuild fréquent (optimisation constante)
### Équipes + Commandants
- 5-7 commandants nommés (personnalités, skills)
- Membres d'équipe = nombre abstrait
- Mort commandant = CATASTROPHE
### Évolution Drones (Timeline)
- 2022: Mavic commercial → Reco basique
- 2023: Mavic + grenades → FPV expérimental
- 2024: FPV doctrine + Ground drones
- 2025: Swarms coordonnés + AI semi-autonome
### Fame System
- Investissement long terme via communication
- Débloquer : dons, équipement, recrutement, accès marchés
- Risk/Reward : Influenceurs en mission
## Roadmap Développement
### Prototype (3-6 mois) - EN COURS
- [x] Setup projet GroveEngine
- [x] Build system fonctionnel
- [x] Hot-reload validé
- [ ] Train basique (3 wagons)
- [ ] Craft simple (1 ressource → 1 drone)
- [ ] 1 mission combat Rimworld-style
- [ ] 3-5 events
- [ ] Loop complet minimal
### MVP (12-18 mois)
- Train complet (tous wagons)
- Craft medium depth
- 5 types missions + 20 events
- Expedition system
- Campaign Act 1 jouable
### Full Game (24-36 mois)
- Polish tous systèmes
- Campaign complète (4 acts)
- 100+ events
- Balancing complet
- UI/UX polish + Audio
## Documentation
**Concept Doc complet** : Voir `../couple-repo/Projects/CONCEPT/mobile_command_v2.md`
## Status
**PROTOTYPE SETUP** - Version 0.1.0 (1er décembre 2025)
- ✅ Setup initial du projet
- ✅ GroveEngine intégré
- ✅ Build system configuré
- ✅ Hot-reload fonctionnel
- 🚧 Prochaine étape : Prototype gameplay
---
*Objectif secondaire : Valider GroveEngine en conditions réelles*