Skip to content

Evic7/escape-the-dungeon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

3 Commits
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ‰ Escape the Dungeon

Escape the Dungeon is a text-based dungeon adventure game written in C++, where every choice matters. You awaken imprisoned, surrounded by danger, guards, secrets, and a sleeping dragon that stands between you and freedom.

This project was built as a first C++ game to explore low-level control, performance-oriented design, and state-driven gameplay.

๐ŸŽฎ How to Play

The game runs entirely in the terminal/command line

Read the story carefully and choose actions by entering numbers

Press ENTER to advance dialogue and dramatic moments

Your decisions affect:

Survival

Combat outcomes

Items you obtain

How the story ends

There is no save system โ€” your choices are permanent.

โš”๏ธ What You Will Face

As you explore the dungeon, you will encounter:

๐Ÿงฑ Dark tunnels and hidden passages

๐Ÿ—๏ธ Locked gates and guarded doors

๐Ÿ›ก๏ธ Heavily armed guards

๐Ÿ’ฐ Treasure chests that may helpโ€”or distractโ€”you

๐Ÿ‰ A sleeping dragon guarding the only true escape

Some paths reward patience and stealth. Others force you into brutal combat.

Choose wisely.

๐Ÿง™ Combat System

The game features a turn-based boss battle against the dragon, including:

Player health and stamina

Shield blocking mechanics

Heavy attacks with stamina cost

Randomized damage and reactions

Healing potions

Visual health bars and sound effects (Windows)

Combat is optionalโ€”but sometimes unavoidable.

๐ŸŽ’ Items & Inventory

You may acquire items such as:

Torch โ€“ Required to explore dark areas

Rope โ€“ Can save your life in unexpected situations

Sword โ€“ Necessary for combat

Shield โ€“ Reduces incoming damage

Dragon Key โ€“ The only way to open the final gate

Items directly influence what actions are available to you.

๐ŸŽญ Characters & Actors

The Player โ€“ A prisoner fighting to escape

Dungeon Guards โ€“ Some talk, some attack, all judge your choices

The Sleeping Dragon โ€“ Ancient, powerful, and unforgiving

The Dungeon Itself โ€“ A silent enemy shaped by your decisions

๐Ÿ Endings

There are multiple endings, including:

Escaping the dungeon alive

Dying by poor decisions

Being defeated by guards

Being slain by the dragon

Failing to retrieve the Dragon Key

Not all victories require combatโ€”but not all mercy is rewarded.

๐Ÿ› ๏ธ Technical Highlights

Written entirely in C++

State-driven game flow

Modular room and event system

Input validation

Windows console enhancements:

Colored text

Sound effects

Screen clearing

No external libraries required

๐Ÿš€ Why This Project

This game was created focusing on:

Performance-aware programming

Manual control of game flow

Understanding lower-level application design

It serves as both a learning milestone and a complete, playable experience.

๐Ÿ“Œ Requirements

Windows (for sound and console effects)

C++ compiler (g++, MSVC, etc.)

About

A text-based dungeon adventure game written in C++, featuring branching choices, combat, inventory, and multiple endings.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages