Skip to content

๐Ÿ—บ๏ธ๐Ÿ’ป Text-based Treasure Hunt Game in C using DSA (Stacks, Queues, Linked Lists, Trees & Graphs) ๐Ÿ’Ž๐Ÿง  | Solve riddles ๐Ÿง™โ€โ™‚๏ธ, find shortest paths ๐Ÿงญ, and race against time โฑ๏ธ!

License

Notifications You must be signed in to change notification settings

Rolling-Thunder07/magical-treasure-hunt

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

32 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿง™โ€โ™‚๏ธโœจ MAGICAL TREASURE HUNT โœจ๐Ÿฐ

*Because who needs a social life when you can argue with fictional wizards in your terminal?*


Welcome to the most unnecessarily elaborate way to procrastinate on your actual responsibilities! This is a text-based adventure game written in C (yes, C - because I'm apparently stuck in 1972 and proud of it) where you explore a mystical castle, annoy wizards with your presence, and hunt for treasure like a caffeinated Indiana Jones with commitment issues.

๐ŸŽ“ Academic Achievement Unlocked: This masterpiece was crafted as a DSA (Data Structures and Algorithms) project assignment, proving that learning can be fun when you add enough wizards and terrible puns. Created in collaboration with a dear friend Dhananjay ๐Ÿ‘ฆ who probably questions our life choices as much as I do! ๐Ÿค๐Ÿ’ป


๐ŸŽฎ What Even Is This?

Remember when games had actual imagination instead of just better graphics? Yeah, me neither, but I decided to create one anyway! This is a console-based adventure where you:

  • ๐Ÿšถโ€โ™€๏ธ Stumble around a 10-room castle like a lost tourist
  • ๐Ÿง™โ€โ™‚๏ธ Meet 5 wizards who apparently have nothing better to do than quiz random strangers
  • ๐Ÿงฉ Answer riddles that range from "Harry Potter trivia" to "things your grandpa would ask"
  • ๐Ÿ’Ž Find treasure (spoiler: it's in room 7 - oops, did I say that out loud?)
  • ๐Ÿ’€ Die spectacularly if you get too many answers wrong (bazinga! - death by trivia)


๐ŸŽฏ Features That Will Blow Your Mind*

*Results may vary. Mind-blowing not guaranteed.

  • ๐ŸŒˆ COLORS! Because black and white terminals are for quitters
  • ๐Ÿ—บ๏ธ Dynamic Map System - Watch your sad little path grow as you get more lost
  • โค๏ธ Lives System - You get 2 lives because I'm generous (unlike real life)
  • โฑ๏ธ Time Tracking - So you can see exactly how much of your life you've wasted
  • ๐Ÿง  Memory Management - I use malloc() like a responsible adult (mom would be proud)
  • ๐Ÿ“Š Step Counter - Because apparently we're turning exploration into a fitness tracker now


๐Ÿฐ The Cast of Characters (AKA My Imaginary Friends)

The Wizards Who Definitely Need Hobbies:

wizards


  • ๐Ÿง™โ€โ™‚๏ธ Albus Dumbledore - Asks about levitation charms (yes, it's Wingardium Leviosa, Hermione)
  • ๐Ÿ–ค Severus Snape - Tests your Horcrux knowledge (emo wizard energy)
  • ๐Ÿฑ Minerva McGonagall - Poses riddles that would make your brain hurt
  • ๐Ÿป Rubeus Hagrid - Talks about magical creatures (probably wants to adopt them all)
  • ๐Ÿ’€ Lord Voldemort - The final boss who's basically a magical psychopath


The Locations (My Virtual Real Estate Portfolio):

  • ๐Ÿšช Castle Entrance - Where dreams begin and hope dies
  • ๐Ÿ“š Ancient Library - For when you want to feel intellectually superior
  • โšฐ๏ธ Ancient Crypt - Spooky vibes only
  • ๐ŸŒฟ Eastern Garden - Nature, but make it mystical
  • ๐Ÿ—ผ Tower Base - Vertical architecture appreciation zone
  • ๐Ÿ”— Dungeon - 50 Shades of Medieval
  • ๐Ÿงช Alchemist's Laboratory - Breaking Bad: Fantasy Edition
  • ๐Ÿ’Ž Treasure Room - The whole point of this exercise
  • ๐Ÿ›๏ธ Great Hall - Where epic stuff probably happened once
  • ๐Ÿ”ฎ Secret Chamber - Because every castle needs one


๐Ÿ› ๏ธ Installation (AKA How to Ruin Your Productivity)


typing 3

Prerequisites:

  • A C compiler (gcc recommended, unless you're feeling adventurous)
  • A terminal that supports ANSI colors (most do, unless you're using Windows XP)
  • The ability to type without looking at the keyboard (optional but impressive)
  • A sense of humor (mandatory)


Compilation Ritual:

# Clone this masterpiece
git clone https://github.com/Rolling-Thunder07/magical-treasure-hunt.git
cd magical-treasure-hunt

# Compile like it's 1999
gcc src/treasure_hunt.c -o treasure_hunt

# Run and question your life choices
./treasure_hunt

For Windows Users (My Condolences):

# Use WSL or suffer in silence
# Or try: gcc treasure_hunt.c -o treasure_hunt.exe



๐ŸŽฒ How to Play (Like You Need Instructions)

  1. Run the game - ./treasure_hunt
  2. Read the pretty intro - I spent time on those ASCII decorations
  3. Choose your destiny - Use numbers 1-6 like a civilized human
  4. Navigate the castle - North/South/East/West (it's not rocket science)
  5. Meet wizards - Answer their riddles or face the consequences
  6. Find the treasure - It's literally the objective
  7. Brag to your friends - As if they'll be impressed


Controls (Because Apparently This Needs Explaining):

  • 1 - Go North โฌ†๏ธ (up, away from your problems)
  • 2 - Go South โฌ‡๏ธ (down, toward your destiny)
  • 3 - Go East โžก๏ธ (right, because left is wrong)
  • 4 - Go West โฌ…๏ธ (left, but we don't talk about that)
  • 5 - Show Map ๐Ÿ—บ๏ธ (for when you're hopelessly lost)
  • 6 - Quit ๐Ÿšช (coward's way out)


๐Ÿ“ธ In-game Screenshots





๐Ÿค“ Technical Mumbo Jumbo (For Fellow Code Nerds)

  • Language: C (because I hate myself and love pointers)
  • Data Structures: Arrays, Structs, Linked Lists (the holy trinity)
  • Memory Management: Dynamic allocation with malloc() (living dangerously)
  • UI: ANSI color codes (fancy terminal aesthetics)
  • Input Validation: Robust error handling (unlike my life choices)
  • Architecture: Procedural programming (old school cool)

Code Statistics (That Nobody Asked For):

  • Lines of Code: ~500+ (We got carried away)
  • Functions: 15+ (decomposition is key, kids)
  • Structs: 3 (Location, Wizard, Question - the perfect trio)
  • Global Variables: A few (I know, I know, but sometimes you gotta live a little)
  • Comments: Excessive (future me will thank present me)


๐Ÿ› Known Issues (AKA My Shame List)

  • Wizards might judge your life choices (working as intended)
  • Some riddles are harder than others (life isn't fair)
  • You might get addicted to this pointless game (seek help)
  • The treasure room might be too easy to find (I'm not great at hiding things)
  • My Hindi-English mixed comments might confuse you (cultural diversity!)


๐Ÿค Contributing (Join Our Madness)


tenor (1)


Want to make this game even more ridiculous? We accept pull requests for:
  • ๐ŸŽญ More wizards with questionable riddles
  • ๐Ÿฐ Additional castle rooms (I ran out of creativity)
  • ๐ŸŽจ Better ASCII art (mine looks like a 5-year-old drew it)
  • ๐Ÿ› Bug fixes (please, I'm begging you)
  • ๐ŸŒŸ New features (but keep it nerdy)

How to Contribute:

  1. Fork this repository (hit that button like it owes you money)
  2. Create a branch (git checkout -b feature/amazing-addition)
  3. Make your changes (try not to break everything)
  4. Test thoroughly (please, for the love of Dijkstra)
  5. Submit a pull request (explain your genius)


๐Ÿ“œ License

This project is licensed under the "Do Whatever You Want But Don't Blame Me" License - see the LICENSE file for details. (Actually, it's probably MIT, but the sentiment remains.)


๐Ÿ™ Acknowledgments

  • Harry Potter Universe - For providing riddle inspiration and childhood trauma
  • My Terminal - For enduring countless compilation errors
  • Stack Overflow - My real programming teacher
  • Coffee - The true MVP of this project
  • My Sanity - Sacrificed for your entertainment
  • Anyone who actually plays this - You're the real heroes


๐Ÿ“ž Contact Me (If You Dare)


contact


Found a bug? Have a suggestion? Want to tell me this game changed your life?
  • ๐Ÿ“ง Email: hk689125@gmail.com (professional inquiries and existential programming discussions)
  • ๐Ÿ™ GitHub: @Rolling-Thunder07 (where all my code babies live)
  • ๐Ÿ’ผ LinkedIn: Hritik Kumar (for networking and pretending to be professional)

*Instagram? Facebook? Twitter? I don't have time for those - I'm too busy debugging my social life. Plus, my relationship status with social media is "It's Complicated" (mostly because I spend more time watching movies-series-anime (cinephile spotted :)) and talking to compilers than humans).* ๐Ÿ˜…

๐ŸŽฏ Final Words

This game represents approximately 47 hours of my life that I'll never get back, 23 cups of coffee, 8 existential crises, and 1 moment of pure satisfaction when it finally compiled without warnings.

If you enjoy this game, great! If you don't, that's okay too - I already have imposter syndrome anyway.

Now go forth and find that treasure! And remember: in a world full of AAA games with billion-dollar budgets, sometimes the best adventures happen in a humble terminal window with nothing but imagination and way too much free time.

May your pointers never be null, and may your segfaults be few.

Happy Adventuring! ๐ŸŽฎโœจ

dance (1)


P.S. - If you actually read this entire README, you either have too much time on your hands or you're procrastinating on something important. Either way, welcome to the club! ๐Ÿค“

About

๐Ÿ—บ๏ธ๐Ÿ’ป Text-based Treasure Hunt Game in C using DSA (Stacks, Queues, Linked Lists, Trees & Graphs) ๐Ÿ’Ž๐Ÿง  | Solve riddles ๐Ÿง™โ€โ™‚๏ธ, find shortest paths ๐Ÿงญ, and race against time โฑ๏ธ!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages