A "Choose Your Own Adventure" Story: A text-based game where students can add different rooms or choices to a branching story. Each student can build a small part of the narrative
choose-your-own-adventure/ ├── main.py # The main game engine ├── README.md # This file ├── CONTRIBUTING.md # Guide for adding new stories └── story/ # Folder containing all story files ├── start.txt # The starting story ├── forest.txt # Example story section ├── cave.txt # Example story section └── ... # More story files
Simple Story Format: Contributors only need to write "From:", "Title:", and story text Automatic Connections: The game automatically builds the adventure tree Beginner Friendly: No programming knowledge needed to add stories Error Handling: Gracefully handles missing files or formatting errors Case Insensitive: Flexible file name references Multiple Endings: Create different paths and conclusions
The example adventure includes:
- A mysterious forest setting
- Village encounters
- A dragon's cave
- Magical crystals
- Multiple possible endings
Check out CONTRIBUTING.md for step-by-step instructions on how to add new story sections to the adventure! Requirements
Python 3.x (no external libraries needed) Basic text editor Git (for contributing)
This project is perfect for:
Teaching basic file I/O and text processing Learning about data structures (dictionaries, lists) Understanding open-source collaboration Creative writing exercises Version control practice with Git
This project is open source and available for educational use. Feel free to fork, modify, and share!
Happy Adventuring! 🗡️✨