⚔️ TERMINAL DUNGEON CRAWLER ⚔️
A community-driven RPG adventure — 2 heroes, 38 turns played
gxcsoccer@github ~ $ ./dungeon_crawler
HP [██████░░░░] 29/50 Lv.1
ATK 8 DEF 4 Gold 5 XP 25/50
📍 Dungeon Entrance
___||___
| .... |
| / \ |
|| ||
|| ^^ ||
A crumbling stone archway. Cold air flows from the depths below.
Exits: SOUTH
📜 Adventure Log:
> ⚡ Dragon King strikes back for 11 dmg!
> @gxcsoccer Escaped successfully!
> @gxcsoccer Moved to The Great Hall
> @gxcsoccer Moved to Dark Corridor
> @gxcsoccer Moved to Dungeon Entrance
| ⬇️ South |
📜 Adventure Log
| Hero | Moves |
|---|---|
 **[gxcsoccer](https://github.com/gxcsoccer)** | 37 |
 **[GaryXJT](https://github.com/GaryXJT)** | 1 |
| Turn | Time | Hero | Event | Issue |
|---|---|---|---|---|
| 38 | 2026-04-01 03:15 UTC | gxcsoccer |
⬆️ Moved to Dungeon Entrance | #39 |
| 37 | 2026-03-29 19:43 UTC | gxcsoccer |
⬆️ Moved to Dark Corridor | #38 |
| 36 | 2026-03-29 19:43 UTC | gxcsoccer |
⬆️ Moved to The Great Hall | #37 |
| 35 | 2026-03-29 19:42 UTC | gxcsoccer |
🏃 Escaped successfully! | #36 |
| 34 | 2026-03-29 19:42 UTC | gxcsoccer |
⚔️ Attacked Dragon King for 4 dmg! | #35 |
| 33 | 2026-03-29 19:42 UTC | gxcsoccer |
⚔️ Attacked Dragon King for 4 dmg! | #34 |
| 32 | 2026-03-29 19:41 UTC | gxcsoccer |
🐉 Dragon King appears! | #33 |
| 32 | 2026-03-29 19:41 UTC | gxcsoccer |
⬅️ Moved to Dragon King's Throne | #33 |
| 31 | 2026-03-29 19:40 UTC | gxcsoccer |
💰 Used Health Potion! +25 HP | #32 |
| 30 | 2026-03-29 19:39 UTC | gxcsoccer |
⬇️ Moved to Crystal Fountain | #31 |
| 29 | 2026-03-29 07:18 UTC | gxcsoccer |
💚 Rested and healed 30 HP | #30 |
| 28 | 2026-03-29 07:14 UTC | gxcsoccer |
⬆️ Moved to Underground Garden | #29 |
| 27 | 2026-03-29 07:13 UTC | gxcsoccer |
➡️ Moved to Crystal Fountain | #28 |
| 26 | 2026-03-29 07:13 UTC | gxcsoccer |
🏃 Escaped successfully! | #27 |
| 25 | 2026-03-29 07:13 UTC | gxcsoccer |
🏃 Failed to escape! Took 12 dmg! | #26 |
| 24 | 2026-03-28 19:46 UTC | gxcsoccer |
🐉 Dragon King appears! | #25 |
| 24 | 2026-03-28 19:46 UTC | gxcsoccer |
⬇️ Moved to Dragon King's Throne | #25 |
| 23 | 2026-03-28 19:46 UTC | gxcsoccer |
⬇️ Moved to The Great Hall | #24 |
| 22 | 2026-03-28 16:43 UTC | gxcsoccer |
💚 Rested and healed 20 HP | #23 |
| 21 | 2026-03-28 16:42 UTC | gxcsoccer |
➡️ Moved to Dusty Library | #22 |
| 20 | 2026-03-28 16:40 UTC | gxcsoccer |
⬆️ Moved to Dark Corridor | #21 |
| 19 | 2026-03-28 16:40 UTC | gxcsoccer |
⬆️ Moved to The Great Hall | #20 |
| 18 | 2026-03-28 16:40 UTC | gxcsoccer |
🏃 Escaped successfully! | #19 |
| 17 | 2026-03-28 16:39 UTC | gxcsoccer |
🏃 Failed to escape! Took 12 dmg! | #18 |
| 16 | 2026-03-28 16:37 UTC | gxcsoccer |
🐉 Dragon King appears! | #17 |
| 16 | 2026-03-28 16:37 UTC | gxcsoccer |
⬅️ Moved to Dragon King's Throne | #17 |
| 15 | 2026-03-28 13:37 UTC | gxcsoccer |
⬇️ Moved to Crystal Fountain | #16 |
| 14 | 2026-03-28 09:17 UTC | gxcsoccer |
💚 Rested and healed 30 HP | #15 |
| 13 | 2026-03-28 06:30 UTC | gxcsoccer |
💚 Rested and healed 30 HP | #14 |
| 12 | 2026-03-28 06:30 UTC | gxcsoccer |
➡️ Moved to Underground Garden | #13 |
🎮 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
