⚔️ TERMINAL DUNGEON CRAWLER ⚔️
A community-driven RPG adventure — 2 heroes, 4 turns played
gxcsoccer@github ~ $ ./dungeon_crawler
HP [██████████] 50/50 Lv.1
ATK 8 DEF 4 Gold 0 XP 0/20
📍 The Great Hall
| || || |
| || || |
| *~~* |
| || || |
|_||__||_|
A vast stone hall with crumbling pillars and ancient runes on the floor.
⚔️ Skeleton Knight appears!
Enemy HP [██████████] 35/35
Exits: NORTH | WEST | EAST | SOUTH
📜 Adventure Log:
> ⚡ Poison darts shoot from the walls!
> @gxcsoccer Moved to Dusty Library
> @gxcsoccer Rested and healed 20 HP
> @GaryXJT Moved to The Great Hall
> ⚡ Skeleton Knight appears!
| ⚔️ Attack | 🛡️ Defend | 🏃 Run |
📜 Adventure Log
| Hero | Moves |
|---|---|
 **[gxcsoccer](https://github.com/gxcsoccer)** | 3 |
 **[GaryXJT](https://github.com/GaryXJT)** | 1 |
| Turn | Time | Hero | Event | Issue |
|---|---|---|---|---|
| 4 | 2026-03-26 04:08 UTC | GaryXJT |
🐉 Skeleton Knight appears! | #5 |
| 4 | 2026-03-26 04:08 UTC | GaryXJT |
⬇️ Moved to The Great Hall | #5 |
| 3 | 2026-03-15 07:31 UTC | gxcsoccer |
💚 Rested and healed 20 HP | |
| 2 | 2026-03-15 07:31 UTC | gxcsoccer |
➡️ Moved to Dusty Library | |
| 1 | 2026-03-15 07:30 UTC | gxcsoccer |
⚡ Poison darts shoot from the walls! | |
| 1 | 2026-03-15 07:30 UTC | gxcsoccer |
⬇️ Moved to Dark Corridor |
🎮 How to Play
This is a community-driven dungeon crawler RPG! Everyone controls the same hero together.
How it works:
- Click an action button above (e.g. South, Attack)
- This creates a GitHub Issue automatically
- A GitHub Action processes your move and updates this README
- The issue is closed with a confirmation comment
Game mechanics:
- ⬆️⬇️⬅️➡️ Move through the dungeon rooms
- ⚔️ Attack enemies to deal damage (ATK - enemy DEF + random 0~3)
- 🛡️ Defend to take half damage and counter-attack
- 🏃 Run from combat (60% success rate)
- 💚 Rest at peaceful locations to heal HP
- 🛒 Shop to buy potions, weapons, and armor
Leveling up:
- Defeat enemies to earn XP and Gold
- Level up at XP thresholds: 20, 50, 100, 180, 300
- Each level grants +5 HP, +2 ATK, +1 DEF and full heal
Death & Respawn:
- If HP reaches 0, the hero falls
- Click any button to respawn at the entrance with base stats
- Your contribution to the hero list is preserved!
Dungeon Map (📍 10 rooms):
[Entrance]
|
[Hallway] <- trap!
/ \
[Armory] [Library] <- treasure / rest
\ /
[Great Hall] <- Skeleton Knight
/ | \
[Crypt] [Throne] [Garden]
| Dragon! |
[Vault] [Fountain] <- shop
