ST Smart Shopping List

A lightweight automation mod for Supermarket Together that adds two powerful restocking buttons to the Manager Blackboard UI:

• Smart Add — tops up only the items currently visible on the product page.
• Full reorder — runs the same logic for every unlocked product in the store.

The goal is simple: keep about two boxes of every product in storage, without over-ordering or duplicating items already in the shopping list.

---

📦 How It Works

The mod calculates box counts exactly like the in-game Ordering Tablet:

• Counts all units in storage
• Counts units inside boxes
• Counts units NPCs are carrying
• Counts units players are carrying → converts them into “effective boxes” using each product’s maxItemsPerBox.

Default restock logic

(fully customizable through the config file)

Effective Boxes	Action
0 boxes	Add 2 boxes
0–1 boxes	Add 1 box
1+ boxes	Add 0 boxes

The mod also checks how many boxes of each item are already in your shopping list and only adds what’s missing — safe to press multiple times.

---

⚙️ Configuration

When the game launches with BepInEx, a config file is automatically created:

BepInEx/config/com.samle.STSmartList.cfg

Inside it, you can change values such as:

• DesiredBoxesWhenEmpty (default 2)
• DesiredBoxesWhenLow (default 1)

More settings will be added in future updates.

---

🧰 Installation

1. Install BepInEx 5 for Supermarket Together

2. Install this mod via Thunderstore or place the DLL manually:

   BepInEx/plugins/STSmartList.dll
   

3. Launch the game — the buttons appear automatically in the Manager Blackboard top bar.

---

🕹️ Usage

Smart Add

• Runs the logic only on the products visible on the current page.
• Great for maintaining individual aisles.

Full reorder

• Applies Smart logic to all unlocked products at once.
• Ideal for daily restocks or automated store resets.

Both buttons avoid duplicates and only top up to your configured levels.

---

⚠️ Known Issue (Temporary)

Candy Bucket: Pumpkin (product ID 322) This product has an odd behavior in the game’s inventory data, causing it to always appear understocked. Until fully fixed, the Smart logic skips it automatically, but:

• You can still order it manually with the regular + button.

---

✔️ Requirements

• BepInEx 5.x
• Supermarket Together (latest build)

---

📜 Changelog

v1.0.0

• Added Smart Add button
• Added Full reorder button
• Implemented storage-aware restock logic
• Auto-tops up order to desired box counts
• Config file support
• Temporary skip for product 322
• Compatible with all existing stores and save files

---

🖼️ Icon

Make sure your mod folder includes a 256×256 icon.png.