Add project docs, .gitignore, and solution items

Added README, design spec, roadmap, and contributing guide for PokerRogue. Updated .gitignore with Visual Studio template. Introduced .slnx solution file to organize documentation under Solution Items.
This commit is contained in:
Michal Vrba
2026-02-09 13:59:15 +01:00
commit 48099e9de7
6 changed files with 863 additions and 0 deletions
+80
View File
@@ -0,0 +1,80 @@
# PokerRogue
**PokerRogue** is a single-player **arcade poker roguelike RPG** where combat is resolved through a fast, simplified Texas Hold’em system.
Poker is not a minigame — **poker *is* the combat system**.
---
## 🎮 High Concept
- **Genre:** Roguelike / RPG / Arcade Strategy
- **Core Mechanic:** Texas Hold’em reimagined as combat
- **Platform:** PC (Desktop)
- **Engine:** MonoGame (DesktopGL)
- **Runtime:** .NET 10
You fight enemies by raising, guarding, folding, and using skills that bend probability.
Builds, relics, and enemies radically change how poker is played.
---
## 🧠 Core Pillars
- **Fast arcade hands** (20–40 seconds)
- **Clear risk vs reward** (Pot = Damage)
- **Build-driven gameplay**
- **Readable enemies, not solver AI**
- **High replayability**
---
## 🕹️ Gameplay Loop
1. Start a run
2. Navigate a procedural map
3. Fight enemies via poker combat
4. Gain skills, relics, upgrades
5. Defeat a boss
6. Die → unlock meta progression
7. Repeat
Average run: **25–35 minutes**
---
## 🧩 Project Structure
```
PokerRogue.sln
├─ PokerRogue.Game (MonoGame DesktopGL)
├─ PokerRogue.Core (Game logic, engine-agnostic)
└─ PokerRogue.Tests (optional)
```
---
## 🛠️ Tech Stack
- C#
- .NET 10
- MonoGame 3.8+
- MGCB Content Pipeline
- Custom SpriteBatch UI
---
## 🚀 Project Status
**Early development / pre-alpha**
Currently focusing on:
- Core combat prototype
- Arcade poker rules
- UI & game feel
---
## 📄 Documentation
- `PokerRogue_Specification.md` – full design & technical spec
- `ROADMAP.md` – planned milestones
- `CONTRIBUTING.md` – contribution guidelines
---
## 📜 License
TBD (likely MIT or custom indie license)