Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/mukybaby/Simple-Shop-Sim/llms.txt

Use this file to discover all available pages before exploring further.

Simple Shop Sim has exactly one requirement: Python 3.10 or higher. There are no third-party packages to install, no virtual environments to set up, and no build steps to run. The entire game executes in your terminal using only the Python standard library, making it one of the fastest projects to go from zero to playing.
Python 3.10 or higher is required. Versions below 3.10 do not support the match statement used throughout main.py and will immediately raise a SyntaxError on launch.
1

Check your Python version

Confirm that Python 3.10+ is available on your machine before cloning. Run either of the following commands depending on how Python is installed on your system:
python --version
or
python3 --version
The output should read Python 3.10.x or higher. If it doesn’t, download the latest release from python.org before continuing.
2

Clone the repository

Clone the project from GitHub and navigate into the new directory:
git clone https://github.com/mukybaby/Simple-Shop-Sim.git
cd Simple-Shop-Sim
The repository is self-contained — everything the game needs (main.py, res/shop.py, res/items.json, and res/customer_names.json) is already present after cloning.
3

Run the game

Start the game by running main.py directly:
python main.py
The game prints a welcome message and immediately prompts you to name your shop. No loading screens, no configuration — you’re in.
4

Name your shop

The very first prompt asks for a shop name. Whatever you type is stored as shop.name and displayed throughout the session:
Welcome to the shop!
What do you want to name your shop?: Merlin's Emporium
Pick anything you like — the name is purely cosmetic and can be changed by simply restarting the game.
5

Make your first move

After naming your shop you land on the main menu. The options change depending on whether the shop is currently open or closed:When the shop is closed:
1. Restock items
2. Open for the day
3. Quit
When the shop is open:
1. Restock items
2. Serve a customer
3. Close the shop for the day
4. Quit
On day 1, the best first move is usually to open for the day (option 2) and start serving customers right away. You begin with $100 cash and 5 units of each item already stocked, so you have enough inventory to trade before spending any money on restocking.
The game starts you off with **100cash∗∗and∗∗5unitsofeachitem∗∗(Apple,Bread,andPotionbydefault).Youcanrestockbeforeopeningifyouwantdeepershelves—justkeepacloseeyeonyourremainingcash,sincerentonday1isalready100 cash** and **5 units of each item** (Apple, Bread, and Potion by default). You can restock before opening if you want deeper shelves — just keep a close eye on your remaining cash, since rent on day 1 is already 10 and climbs by $10 every subsequent day.

Build docs developers (and LLMs) love

Get started for freeTalk to us