🏕️ Survivor in the Wilderness

A Python text-based adventure game where your choices determine your survival in the wild.
Explore, hunt, cook, collect, and survive through danger — one decision at a time.

---

📘 Overview

Survivor in the Wilderness is a fully interactive text-based adventure game written in Python. The game immerses players in a wilderness survival story, where each decision affects your fate — gather resources, fight animals, explore mysterious locations, and uncover secrets.

---

🎯 Objective

Your goal is to survive through an entire day in the wild by making smart choices. Every location you explore gives opportunities or dangers — gather items, hunt deer, cook meals, and face the ultimate challenge: the wild grizzly bear.

---

🧩 Features

• 🌳 Explore multiple locations (Forest, River, Lake, Woodlands, and more)
• 🪓 Collect items and build your inventory dynamically
• 🔥 Craft fires, cook food, and regain health
• 🎯 Hunt animals like deer and fish for survival
• 🐻 Face the final boss — a dangerous grizzly bear
• 💬 Text-based interface with typing effect for immersion
• 🎮 Replayable — every run can lead to different outcomes

---

📂 Folder Structure

Survivor-In-The-Wilderness/
│
├── main.py                  # Main game script
├── README.md                # Project documentation
├── Flowchart.pdf            # Project documentation
└── LICENCE                  # MIT Licence

---

⚙️ Setup & Run Instructions

To play the game on your own system:

1. Make sure you have Python 3.13 or above installed.
2. Download or clone this repository:

git clone https://github.com/Sheikh-H/Survivor-In-The-Wilderness.git

3. Navigate into the project folder:

cd Survivor-In-The-Wilderness

4. Run the game using:

python main.py

Once launched, follow the text prompts to play and make your decisions wisely!

---

🧠 Game Mechanics & Logic

Here’s how the key systems work behind the scenes:

• Player Stats: Health and damage dynamically change based on actions and inventory.
• Inventory System: Items like apples, fire starters, fishing lines, and weapons affect gameplay.
• Choice-based Progression: Player input determines the story’s flow — explore, rest, or battle.
• Combat System: Uses Python’s random library to simulate variable damage outcomes.
• Typewriter Effect: Achieved via sys.stdout and time.sleep() to enhance immersion.

---

💻 Key Libraries Used

• random – for generating random damage and outcomes
• sys – for text typing and output control
• time – to control pacing and timing
• os – to clear the console for smoother flow

---

🎮 Gameplay Preview

Before we begin, please Enter Your Name:
> Sheikh

Welcome Player 'Sheikh' to the 'Survivor In The Wilderness' Game

Would you like to start the game? (Yes or No):
> yes

Dropping you into the game now...
...
You've just woken up in the wilderness at 5AM...
What will you do first?

---

🏕️ Progression Path

1. Morning: Explore the forest or river to gather essentials.
2. Midday: Hunt deer and gather food for survival.
3. Afternoon: Fish at the lake and collect useful tools.
4. Evening: Cook, rest, and explore the woodlands.
5. Nightfall: Survive the grizzly bear encounter to win the game.

---

🏆 Win Condition

Defeat the grizzly bear in combat and survive the night. The game ends with a twist — another survivor emerges… but are they friend or foe?

---

📸 Example Inventory Progression

['Fire Starter', 'Bow and Arrow', 'Cooked Fish', 'Apple', 'Lost Hatchet']

---

🚀 Future Improvements

• Add save/load functionality
• Include a GUI version with tkinter or pygame
• Implement difficulty levels
• Expand storyline with new biomes and choices

---

📄 Licence

This project is licenced under the MIT Licence — see the LICENCE file for details.

MIT Licence

Copyright (c) 2025 Sheikh Hussain

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

---

Footnote

🗣️ Feel free to follow, connect, and chat!

By Sheikh Hussain 💚

---