Skip to content

Latest commit

 

History

11 Commits

Folders and files

Repository files navigation

Sundrop Caves - A Mining Adventure Game

Python Version License

assets/readme/main_menu.png


Overview

Sundrop Caves is a text-based mining adventure game inspired by Stardew Valley, created as a Year 1 school assignment project. Players take on the role of a miner trying to earn 500 GP (gold pieces) by mining ores, upgrading equipment, and managing resources.


Features

  • Mining System: Mine copper, silver, and gold ores with different pickaxe levels
  • Inventory Management: Carry limited resources and store excess in your warehouse
  • Upgrade System: Improve your pickaxe and backpack capacity
  • Dynamic Map: Randomized ore replenishment and fog-of-war exploration
  • Scoreboard: Compete for the best scores based on efficiency
  • Save/Load System: Continue your progress across sessions

Getting Started

Prerequisites

  • Python 3.8x

Installation

  1. Clone the repository:

    git clone https://github.com/Jiahong-Guan/Sundrop-Caves.git
    cd sundrop-caves
  2. Install required dependencies:

    pip install -r requirements.txt
  3. Run the game:

    python S10275126J_Assignment.py

How To Play

Controls

  • Main Menu:

    • (N) New game
    • (L) Load saved game
    • (V) View top scores
    • (Q) Quit
  • Town Menu:

    • (B) Buy upgrades
    • (I) Player information
    • (M) View full map
    • (E) Enter mine
    • (W) Warehouse management
    • (V) Save game
    • (Q) Quit to main menu
  • Mine Controls:

    • WASD: Movement
    • (M) View full map
    • (I) Player information
    • (P) Use portal to return to town
    • (Q) Quit to main menu

Game Objective

Earn 500 GP as quickly as possible by mining and selling ores. Your score is based on:

  • Number of days taken
  • Total steps moved
  • Final GP amount

Tips

  • Upgrade your pickaxe early to access better ores
  • Manage your inventory carefully - full bags can't mine more!
  • The Magic Torch helps you see more of the mine
  • Portal stones let you return to town quickly

License

This project is licensed under the MIT License. See the LICENSE file for details.

About

⛏️ Text-based mining adventure game in Python. Mine, upgrade, and earn 500 GP to win!

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages