An adventures game where it can extend as much as you like.

Open Beginner friendly
#3,205 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
85/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Active
Tech stack
python
Domain
cli, game-dev

Research direction

Create adventure_game.py as the entry point for the text-based choose-your-own-adventure described in the issue. Run it manually and verify that it asks for a name, presents the left/right road choices and their outcomes, and prints "Not a valid option" for invalid choices.

Written by the indexing model from the issue text.

Description

Is your feature request related to a problem?
The repository currently lacks a text-based interactive adventure/choose-your-own-path game. This is a fun, beginner-friendly project type that's great for practicing conditionals, string input handling, and branching program flow — but it's also naturally suited to being extended collaboratively, since a text adventure can keep growing with new paths, endings, and story branches.

Describe the Solution
Add an adventure_game.py file implementing the initial skeleton of a text-based choose-your-own-adventure game where:

The player enters their name and receives a welcome message
The player faces a fork in a dirt road and chooses to go left or right
Left path leads to a river, where the player chooses to swim across (bad ending — eaten by an alligator) or walk around (bad ending — runs out of water)
Right path leads to an old bridge, where the player chooses to cross (good ending — successfully crosses) or head back (bad ending — gets lost)
Invalid inputs at any choice point are handled with a "Not a valid option" message

This is intentionally an open starting point, not a finished game. I'm submitting this as a base structure so that other contributors can extend it over time by:

Adding new branching paths and choices at each existing decision point
Adding entirely new story arcs/locations beyond the current two endings per path
Adding more "good" endings, items/inventory mechanics, or a scoring system
Refactoring the branching logic into functions/a scene-based structure as the story grows (to keep the code maintainable as more contributors add paths)

Describe Alternatives
An alternative would be to build out a fully complete game in a single PR before submitting. However, keeping it intentionally small and open-ended encourages community contribution and makes it easier for new/beginner contributors to add a single new path or ending as their first contribution to the repo.
Additional Context
This kind of project is a good "good first issue" magnet — new contributors can add a single elif branch and a couple of print statements without needing to understand the whole codebase, making it a great low-barrier entry point for first-time open source contributors.
Complexity

Simple (< 50 lines)
Medium (50-200 lines)
Complex (> 200 lines)

Dominant language
Python
Stars
35.4k
Forks
12.9k
Avg merge
2h 37m
Merged PRs (30d)
1

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from geekcomputers/Python

All issues in geekcomputers/Python

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.