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 puts you in the shoes of a small-town shop owner. Name your store, stock your shelves, serve customers who walk in each day, and try to strike a deal when they push back on the price. Each passing day brings more customers — and higher rent — so every decision counts.

Introduction

Learn what Simple Shop Sim is and what makes it tick.

Quickstart

Get Python installed and start your first run in minutes.

Gameplay Guide

Understand the full game loop — from opening day to closing time.

Reference

Explore the Python classes and data files that power the simulation.

How it works

1

Clone and run

Clone the repository and launch main.py with Python 3.10+. You’ll be asked to name your shop right away.
2

Stock your shelves

Before customers arrive, restock your inventory (Apples, Bread, Potions) using your starting cash.
3

Open for business

Open the shop to let the day’s customers in. Each customer has a budget and a specific item they want.
4

Bargain and sell

Decide whether to bargain with each customer. A successful deal raises the price by 10%; a failed one drops it by 10%.
The number of customers who visit each day equals day × 3 — so profits (and pressure) grow as the days go on. Keep an eye on your cash after rent is deducted at end of day.

Build docs developers (and LLMs) love