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.

Welcome to Simple Shop Sim, a Python terminal game where you run a small shop day by day. Each day you decide what to stock, open your doors to a queue of customers, negotiate sales, then close up and pay rent — all while keeping your cash from hitting zero.

​
The game loop

Every session follows the same repeating cycle:
1

Start the day (closed)

The shop begins closed. Use this window to check your inventory and restock items before customers arrive.
2

Restock items

Choose option 1 from the main menu to view the inventory table and top up any items you need. Each unit costs cash upfront.
3

Open for the day

Choose option 2 (when closed) to open the shop. The game generates a queue of day × 3 customers and lists their names.
4

Serve all customers

With the shop open, choose option 2 repeatedly to serve each customer one at a time. Optionally bargain with each customer before the sale.
5

Close the shop

Choose option 3 when the shop is open to end the day. Rent (day × $10) is deducted from your cash and the day counter increments.
6

Repeat

The shop is now closed again. Head back to step 1 — but with higher rent and more customers waiting tomorrow.

​
Starting conditions

Every new game begins with the same baseline:
  • Shop name — chosen by you at startup via a text prompt.
  • Starting cash — $100.
  • Inventory — three items pre-loaded from items.json, each with 5 units of starting stock:
    • Apple — $5
    • Bread — $10
    • Potion — $25
  • Day — 1.
  • Shop status — closed.

​
The main menu

The options displayed change depending on whether your shop is 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
Option 4 (Quit) is only available while the shop is open. Choosing option 3 while closed exits the game immediately.

​
Winning and losing

Simple Shop Sim has no explicit win or lose screen — the goal is to stay solvent for as long as possible.
  • Rent increases every day: day × $10 is charged when you close the shop.
  • If your cash drops too low, you will be unable to afford restocks.
  • Customers will not buy items that are out of stock, so running out of inventory also kills your revenue.
  • There is no save system — progress resets when you quit.
Ready to dive deeper? Explore the rest of the gameplay guides:

Managing Inventory

Learn how to restock items, read the inventory table, and manage your limited starting cash.

Serving Customers

Understand the daily customer queue, how customers are generated, and when a sale can fail.

Bargaining

Master the risk/reward bargaining mechanic and know when to push for a higher price.

Day Cycle

See how rent scales, how customer counts grow, and how to plan for long-term survival.

Build docs developers (and LLMs) love

Get started for freeTalk to us