Implement choose-your-own-adventure game with OOP, file I/O, and type safety

[Copilot]

Implements CS3620 Project 1: a mystery/thriller adventure game meeting all specified requirements.

Implementation

Core game (adventure_game.py)

• StoryNode class: narrative segments with choices and state
• Adventure class: game engine managing 54 story nodes, inventory, score, and progression
• JSON-based save/load system with error handling
• 50 decision points across 4 endings (best, good, moderate, bad)

Technical requirements

• Type hints throughout: Dict[str, str], List[str], Optional[str], Callable
• Control structures: while loops (game loop), for loops (iteration), if/elif/else (logic), try/except (file I/O)
• Functional patterns: lambda for file filtering, list comprehensions
• 15+ functions including save/load, display, navigation, and validation methods

Example usage

from adventure_game import Adventure

game = Adventure()
game.play()  # Interactive gameplay

# Save/load support
game.save_game()  # Writes JSON with player state, inventory, score
game.load_game()  # Restores from adventure_save.json

Testing & Documentation

• test_game.py: 6 automated tests validating OOP, file I/O, story structure, type hints
• demo_playthrough.py: demonstrates complete path to best ending
• Documentation: README, requirements verification, code examples

Metrics

• 54 narratives (270% of 20 required)
• 50 decision points (500% of 10 required)
• 100% type hint coverage

Original prompt

These are the project requirements:
An Entertaining Adventure Story (No lorem Ipsum)
Use of Functional and/or Object-Oriented Programming.
Use of Control Structures, Functions, File Handling (Ex: Can choose a specific file to load to make a decision or write the user's adventure to a file), and Python Types.
A Minimum of 10 User Decision Points.
A Minimum of 20 Narratives.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[BraydenPierce]

@copilot how can I set a default name for a character if the user doesnt enter one?

[Copilot]

@copilot how can I set a default name for a character if the user doesnt enter one?

The code already handles this on lines 851-853 of adventure_game.py:

self.player_name = input("\nEnter your detective name: ").strip()
if not self.player_name:
    self.player_name = "Detective"

If the user presses Enter without typing anything, .strip() returns an empty string, and the code sets the default name to "Detective". You can change "Detective" to any default name you prefer.