Order & Organize

A BepInEx 5 mod for Supermarket Together that automates inventory restocking and lets you organize your storage shelves by product category.

Version: 0.6.1 Author: ddqminik Requires: BepInEx 5

What Does This Mod Do?

Order & Organize adds three major features to Supermarket Together:

1. Smart Restock Button -- A one-click button that scans your entire inventory and adds low-stock products to your shopping list.
2. Automatic Ordering -- An optional system that periodically checks stock levels and purchases products for you, completely hands-free.
3. Category Storage Shelves -- Tag your storage shelves with product categories (Dairy, Drinks, Snacks, etc.) so only matching products can be placed there, and employees prioritize the right shelf when putting items away.

All features work through the game's native systems -- the mod never edits your save file or manipulates your money directly.

Features in Detail

Smart Restock Button

When you open the ordering computer in your store, you'll see an "Add Low Stock" button. Clicking it:

• Scans every product in your store
• Finds products where your total stock (shelves + storage + boxes) is below a configurable threshold (default: 40 units)
• Adds one box of each low-stock product to your shopping list
• Skips products that are already on your shopping list
• Skips locked or unorderable products
• Prioritizes the most understocked products first
• Shows a notification telling you how many products were added and how many were skipped

This is purely manual -- it only adds items to your shopping list. You still review and confirm the purchase yourself.

Automatic Ordering

For a fully hands-free experience, you can enable automatic ordering. This is disabled by default and must be turned on intentionally.

How to use it:

1. Press F8 (default hotkey) to toggle automatic ordering on or off
2. When enabled, the mod scans your inventory every 10 seconds (configurable)
3. If it finds products below the threshold, it purchases them automatically
4. A notification appears showing how many boxes were ordered and the total cost

Safety features of automatic ordering:

• Cash reserve: Set a minimum balance (e.g. $5,000) that the mod will never spend below. You'll always have money for rent, licenses, and other expenses.
• No interference with manual orders: If you have items on your shopping list, automation pauses entirely until the list is clear. Your manual orders are never touched.
• Duplicate protection: The mod tracks what it has already ordered and won't re-order the same product until the previous delivery arrives or a timeout expires.
• Host-only: In multiplayer, automatic ordering only works for the host. This prevents conflicts when multiple players have the mod installed.

Category Storage Shelves

Tired of employees dumping products on random storage shelves? This feature lets you designate shelves for specific product categories.

How to use it:

1. Look directly at a storage shelf in your backroom
2. Press G (default hotkey) to open the category picker
3. Use the scroll wheel or arrow keys to browse available categories (these match the tabs in the ordering interface -- Dairy, Drinks, Fruits & Vegetables, etc.)
4. Press Enter to assign the selected category
5. Press Backspace to remove an existing category assignment
6. Press G again to cancel without making changes

What happens after you assign a category:

• A color-coded floating label appears above the shelf showing its assigned category
• Player placement is restricted: If you try to place a product from a different category on a tagged shelf, it will be blocked
• Employee AI is category-aware: When employees put away leftover products, they'll look for a shelf tagged with the matching category first
• Assignments are saved automatically and persist when you close and reopen the game

Floating labels:

• Colored labels float above every tagged shelf so you can see your organization at a glance
• Press H (default hotkey) to toggle labels on or off
• You can also toggle labels from the in-game config window
• Hiding labels can help with performance if you have many tagged shelves

In-Game Configuration

Press F7 (default hotkey) to open a scrollable settings window where you can adjust every mod setting in real-time without closing the game or editing files.

Installation

Step 1: Install BepInEx 5

If you don't already have BepInEx installed:

1. Download BepInEx 5 (x64) -- get the latest 5.x release, not 6.x
2. Extract the contents into your Supermarket Together game folder (where Supermarket Together.exe is located)
3. Run the game once and close it -- BepInEx will create its folder structure

Your game folder should now have a BepInEx folder with plugins, config, and core subfolders.

Step 2: Install Order & Organize

1. Download OrderAndOrganize.dll
2. Create a folder: <GameDir>\BepInEx\plugins\OrderAndOrganize\
3. Place OrderAndOrganize.dll inside that folder
4. Launch the game

On first launch, the mod creates its config file automatically.

Controls & Hotkeys

All hotkeys are configurable in the settings window (F7) or the config file.

Understanding Stock Values

The ordering interface shows three colored stock values for each product:

Total Stock = Red + Green + Yellow

The mod considers a product "low stock" when its total stock is below the threshold (default: 40 units). You can change this threshold in the settings.

Settings Reference

All settings can be changed in-game by pressing F7, or by editing the config file at: <GameDir>\BepInEx\config\com.ddqminik.supermarkettogether.orderandorganize.cfg

General

Automatic Ordering

Category Shelves

Multiplayer

Order & Organize is designed primarily for singleplayer and host use.

Important notes for multiplayer:

• Only the host needs the mod for automatic ordering to work
• Category shelf assignments are not shared between players -- each player has their own local assignments
• There is no conflict if some players have the mod and others don't
• The mod does not affect other players' gameplay or UI

Compatibility

• Game version: Tested with Supermarket Together (latest Steam version as of August 2026)
• BepInEx version: Requires BepInEx 5.x (not compatible with BepInEx 6.x)
• Other mods: Order & Organize should work alongside most other BepInEx mods. It patches a small number of game methods (employee restocking and shelf placement) and avoids conflicts by checking for existing patches. If you experience issues with another mod, try disabling one at a time to isolate the conflict.
• Game updates: Major game updates may break the mod if the developers change internal code. The mod logs clear error messages if it can't find expected game APIs, so check the BepInEx log if something stops working after a game update.

Troubleshooting

The mod isn't loading

• Make sure you have BepInEx 5 installed (not 6.x)
• Check that OrderAndOrganize.dll is in BepInEx\plugins\OrderAndOrganize\
• Look at BepInEx\LogOutput.log for error messages

The "Add Low Stock" button doesn't appear

• Open the ordering computer and wait a moment -- the button appears once the ordering UI is fully loaded
• Check that the mod is enabled (press F7 and verify "Enabled" is checked)

Category picker doesn't open

• Make sure you're looking directly at a storage shelf (not a display shelf)
• The shelf must be within interaction range
• Check that Category Shelves are enabled in settings (F7)

My category assignments disappeared

• The mod creates automatic backups. If assignments are lost, they should be restored automatically on next load
• Your backup file is at: BepInEx\config\OrderAndOrganize_CategoryShelves.json.backup

Automatic ordering isn't working

• Press F8 to make sure it's enabled (a notification will confirm)
• Check that your shopping list is empty -- automation pauses if there are manual items on the list
• In multiplayer, automatic ordering only works for the host
• Make sure you have enough money (above your cash reserve setting)

Performance issues

• If you have many tagged shelves, try hiding floating labels (press H)
• Increase the scan interval in settings to reduce how often inventory is checked

Uninstallation

1. Delete the folder: <GameDir>\BepInEx\plugins\OrderAndOrganize\
2. Optionally delete the config file: <GameDir>\BepInEx\config\com.ddqminik.supermarkettogether.orderandorganize.cfg
3. Optionally delete shelf data: <GameDir>\BepInEx\config\OrderAndOrganize_CategoryShelves.json (and .backup)

Removing the mod has no effect on your save file. Your store will continue to work normally.

Changelog

See CHANGELOG.md for a full history of changes.

Credits

Created by ddqminik.

Built with BepInEx and HarmonyX.

Changelog

All notable changes to Order & Organize are documented in this file.

[0.6.1] - 2026-08-13

Fixed

• Storage category fallback: Employees no longer idle when matching and untagged shelves are full but wrong-category shelves still have space. Wrong-category shelves are now used as a last-resort 4th priority tier, ensuring all storage is filled before employees give up.

Added

• Fallback To Any Shelf config option (CategoryShelves section, default: enabled). When enabled, employees fall back to wrong-category shelves if all matching/untagged storage is full. Disable for strict category enforcement (employees will skip wrong-category shelves entirely). Configurable in-game via F7.

[0.6.0] - 2026-08-13

Fixed

• Critical: Storage employees freezing in the employee room when all storage shelves have categories assigned. The GetFreeStorageContainer patch was intercepting the game's magic "any free storage?" check (boxIDProduct = 10000), causing it to return "no storage available" when all shelves were categorized. Employees would cycle idle indefinitely, producing thousands of physics warnings and massive lag.
• Shelf deletion cleanup: Category assignments now auto-clear immediately when a categorized shelf is deleted during gameplay, instead of lingering until game restart. A ShelfCategoryTracker component is attached to each categorized shelf and fires on destruction.

Changed

• Stale assignment purge interval reduced from 60 seconds to 30 seconds for faster cleanup as a safety net.

[0.5.0] - 2026-08-03

Fixed

• Critical: PurgeStaleAssignments() wiped all category shelf data during scene transitions (exit to menu / store switch). The purge ran while shelves were unloaded from memory, falsely detecting every assignment as stale.

Added

• Scene guard for purge: Stale assignment cleanup now requires GameData.Instance to exist and a 120-second grace period after scene load, ensuring all props have spawned before any purge runs.
• 50% safety threshold: If more than half of all assignments would be purged in a single pass, the purge aborts entirely and logs a warning. Prevents mass-wipe regardless of cause.
• Backup before purge: A backup file (OrderAndOrganize_CategoryShelves.json.backup) is created before any assignments are removed.
• Auto-restore on load: If the main file has 0 assignments but a backup exists, assignments are automatically restored from the backup.
• Purge timer reset on scene unload: The purge timer and scene-loaded timestamp reset when any scene unloads, preventing stale timers from carrying over.
• Removed broken Data_Container.OnDestroy Harmony patch that prevented all category storage patches from applying (method does not exist on Data_Container).

[0.4.0] - 2026-08-03

Added

• In-game configuration window (F7 hotkey): Scrollable IMGUI panel for real-time config changes without editing files.
• Category storage shelves: Tag storage shelves with product categories to restrict placement and direct employee restocking behavior.
  • G key opens scroll-wheel category picker while looking at a storage shelf.
  • Mouse wheel / arrow keys browse categories; Enter applies; Backspace clears; G cancels.
  • Floating color-coded labels above tagged shelves (toggleable via H key or config window).
  • Harmony patches enforce category restrictions on player placement and employee AI.
  • Assignments persist to OrderAndOrganize_CategoryShelves.json using grid-snapped position keys.
• Category label toggle: Configurable hotkey (default H) and config checkbox to show/hide floating labels.
• Improved category picker readability: Dark category colors are boosted to minimum luminance; selected items use white-on-color.
• Prominent auto-purchase notifications: Automation cycle notifications include box count and total spend amount.
• Corrupt data purging: Malformed position keys are detected and removed on load.

Fixed

• Invisible "Add Low Stock" button (now clones native button style).
• Camera/movement not freezing during category picker (uses FindFirstObjectByType to locate FirstPersonController).
• Category assignments not persisting (fixed JSON parser for comma-containing keys).
• ESC key conflict with game menu when closing category picker (changed to G key).
• Config window clipping (added scroll view, widened to 420px).
• Input processing duplication causing scroll-by-2 and G-key not closing picker (consolidated to single UpdateInput() path).

[0.3.0] - 2026-08-03

Added

• Manual smart-list mode: "Add Low Stock" button on ordering interface.
• Automatic ordering mode with F8 toggle hotkey.
• Configurable stock threshold, scan interval, cash reserve.
• Pending order tracking with timeout-based deduplication.
• Money protection (cash reserve, fund verification before purchase).
• Shopping list safety (automation halts if manual items present).
• Host-only enforcement via NetworkServer.active.
• Localization bypass for custom notification text.
• Game API diagnostics logging on first store load.
• 45 unit tests covering core business logic.
• PowerShell scripts for build, deploy, save backup, and log collection.