Michal Vrba
48099e9de7
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.
81 lines
1.7 KiB
Markdown
81 lines
1.7 KiB
Markdown
# 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)
|