Skip to content

alt-shreya/cli-choose-your-own-ascii-art

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🗡️ ASCII Adventure: Choose Your Own Story

A captivating command-line choose-your-own-adventure game that rewards your choices with stunning ASCII art! Navigate through mystical realms, face legendary creatures, and discover your destiny through beautiful text-based graphics.

✨ Features

  • Interactive Storytelling: Make choices that determine your fate
  • Stunning ASCII Art: Each path leads to amazing text-based graphics
  • Multiple Endings: Discover treasure, meet unicorns, become a wizard, or face peril
  • Keyword Recognition: Type keywords like "dragon", "castle", "magic" to jump to specific paths
  • Immersive Experience: Typewriter effects and dramatic pauses enhance the adventure
  • Replayability: Multiple paths and endings encourage exploration

🎮 How to Play

Quick Start

python3 ascii_adventure.py

Game Controls

  • Use numbers (1-4) to select from menu options
  • Type keywords to jump directly to specific adventures:
    • castle, enchanted → Castle path
    • forest, dark, trees → Forest path
    • dragon, mountain, fire → Dragon path
    • wizard, tower, magic → Wizard path
    • treasure, gold → Treasure ending
    • unicorn, magical → Unicorn ending

🗺️ Adventure Paths

🏰 The Enchanted Castle

Face ancient riddles and stone guardians in a quest for royal treasures.

🌲 The Dark Forest

Navigate through mysterious woods where glowing mushrooms and ancient runes guide your way.

🏔️ The Dragon's Mountain

Climb treacherous peaks to encounter a legendary dragon in its mountain lair.

🔮 The Wizard's Tower

Ascend the spiral staircase to meet a wise wizard who offers magical potions.

🎨 ASCII Art Gallery

The game features hand-crafted ASCII art for:

  • 🐉 Majestic Dragons
  • 🏰 Enchanted Castles
  • 💎 Treasure Hoards
  • 🦄 Magical Unicorns
  • 🧙 Wise Wizards
  • 🌲 Mysterious Forests
  • 💀 Dramatic Endings

🛠️ Technical Details

Requirements

  • Python 3.6 or higher
  • Terminal/Command Prompt
  • Standard Python libraries only (no external dependencies)

Installation

  1. Clone this repository:

    git clone https://github.com/yourusername/cli-choose-your-own-ascii-art.git
  2. Navigate to the project directory:

    cd cli-choose-your-own-ascii-art
  3. Run the game:

    python3 ascii_adventure.py

File Structure

cli-choose-your-own-ascii-art/
├── ascii_adventure.py    # Main game file
├── README.md            # This documentation
└── LICENSE              # MIT License

🎭 Game Features Explained

Story Branching

The game uses intelligent choice recognition:

  • Numbered choices: Traditional menu selection (1, 2, 3, 4)
  • Keyword input: Natural language commands ("go to castle", "find dragon")
  • Multiple paths: Each choice leads to unique storylines and ASCII art

ASCII Art System

Each story outcome displays custom ASCII art:

  • Static Art: Beautiful pre-drawn scenes
  • Contextual Display: Art matches your story choices
  • Dramatic Timing: Pauses and effects enhance the visual impact

Interactive Elements

  • Typewriter Effect: Text appears character by character
  • Screen Clearing: Clean presentation between scenes
  • Replay System: Start new adventures without restarting

🎯 Tips for Players

  1. Explore Keywords: Try typing descriptive words instead of numbers
  2. Read Carefully: Story clues often hint at the best choices
  3. Experiment: Each playthrough can reveal new paths
  4. Think Creatively: Sometimes unconventional answers work best
  5. Enjoy the Art: Take time to appreciate the ASCII graphics

🤝 Contributing

Contributions are welcome! Here are ways to help:

  • Add New Paths: Create additional story branches
  • Improve ASCII Art: Enhance or add new text graphics
  • Bug Fixes: Report and fix any issues
  • Feature Ideas: Suggest new game mechanics

Development Setup

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Test thoroughly
  5. Submit a pull request

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

🌟 Acknowledgments

  • Inspired by classic text-based adventure games
  • ASCII art created with love for retro gaming enthusiasts
  • Built for the joy of interactive storytelling

🚀 Future Enhancements

  • Save/Load game progress
  • Character stats and inventory system
  • Sound effects (terminal beeps)
  • More complex branching narratives
  • Randomized encounters
  • Achievement system
  • Color support for terminals

Ready for adventure? Run python3 ascii_adventure.py and let your story begin! 🗡️✨

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages