geekcomputers / geekcomputers/Python

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

Đang mở Phù hợp với người mới
#3,205 2 bình luận 0 reaction 0 người được giao Xem trên GitHub

Chưa có ai nhận issue này.

Ngôn ngữ chính
Python
Star
35.4k
Fork
12.9k
Merge trung bình
2 giờ 37 phút
Pull request đã merge (30 ngày)
1

Mô tả

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)

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Hướng nghiên cứu

Tạo adventure_game.py làm điểm vào cho trò chơi phiêu lưu dạng văn bản Choose-your-own-adventure được mô tả trong issue. Chạy thủ công và xác minh rằng chương trình yêu cầu nhập tên, đưa ra các lựa chọn con đường bên trái/bên phải cùng kết quả của chúng, và in "Not a valid option" cho các lựa chọn không hợp lệ.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Đánh giá

Công nghệ
python
Lĩnh vực
cli, game-dev
Loại issue
Tính năng
Độ khó
2/5
Thời gian dự kiến
1-3 giờ
Mức độ hoạt động
Sôi nổi
Độ rõ ràng
Đặc tả rõ ràng
Mức phù hợp với người mới
85/100

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.