0 of 0
About this mod
With this mod, you can have your restockers only refill display shelves if the filling rate is lower than a certain percentage (configurable). So no more wasting time on almost full displays going back and forth from the store to the storage.
- Requirements
- Permissions and credits
- Changelogs
With this mod, you can have your restockers only refill display shelves if the filling rate is lower than a certain percentage (configurable). So no more wasting time on almost full displays going back and forth from the store to the storage.
Installation
When to use both AllDisplays and IndividualDisplay refill rates? If for example you wish your restockers would only restock products that are low in all your store (for example only 25% of your stock remains), but at the same time, if there is a display slot that is almost full (like 90% full), they should not restock that one.
Detailed Explanation for Restocking Refill Rate Options
1. Individual Display Slot Refill Options
UseIndividualDisplaySlotRefillRate
What It Does: When enabled, the restocker evaluates each individual display slot separately to decide whether it needs to be refilled.
IndividualDisplayRefillRate
What It Does: This value (ranging from 0 to 1) sets the threshold for a single display slot to be considered “in need” of a refill.
Value = 1: Restockers will refill any display slot that isn’t completely full (i.e., even if only one item is missing).
Value = 0: Restockers will only refill display slots that are completely empty.
Default (e.g., 0.75): Only display slots that are 75% full or less will trigger a refill.
Use Case: If you want to prevent refilling nearly full display slots, enable this option and set a threshold that matches your needs. For example, setting it to 0.75 means that only display slots missing at least 25% of their stock will be refilled.
2. All Displays (Overall Product) Refill Options
UseAllDisplaySlotsRefillRate
What It Does: When enabled, the mod checks the average fill level across all display slots for the same product before refilling any one of them.
AllDisplaysRefillRate
What It Does: This value (also between 0 and 1) defines the threshold for the overall average fill level of all display slots carrying the same product.
For example, setting this to 0.25 means that the restockers will only refill a display slot if the overall average for that product is 25% full or less.
Use Case: Use this option to manage overall inventory levels. It prevents refilling a display slot unnecessarily when only a section of your store is low on stock, ensuring that refills occur only when the product is in low supply across all displays.
3. Combining Both Refill Rate Options
Behavior: When both UseIndividualDisplaySlotRefillRate and UseAllDisplaySlotsRefillRate are enabled, a display slot will be refilled only if both its individual fill level and the overall average fill level (across all slots for that product) are below their respective thresholds.
Use Case: This combined approach is ideal if you want to refill a product only when the overall stock is low (e.g., only 25% remains), while avoiding refills for individual display slots that are nearly full (e.g., 90% full).
4. Handling Already Carried Boxes
IgnoreRefillRatesForAlreadyCarriedBoxes
What It Does: By default, if a restocker is already carrying a box (after refilling or picking one up from the ground), they will look for any other display slot that is missing that product—ignoring the refill rate thresholds.
Use Case: This option maximizes efficiency by allowing restockers to use an extra box immediately, rather than returning it to storage. It is recommended to keep this enabled to avoid redundant trips.
5. Outside Work Hours Behavior
RefillAllOutsideWorkHours
What It Does: When enabled, this option overrides all refill rate checks outside designated work hours. During off-hours, any display slot that isn’t completely full will be refilled regardless of the set thresholds.
Use Case: Ideal for ensuring your store is fully stocked before opening or during downtime, this option prevents delays during peak operational hours by handling all refills when the store is not in active use.
Summary of Use Cases
Feel free to adjust the threshold values to best match the intended gameplay experience. These options give you full control over how and when your store’s display slots are refilled.
Notes:
Buy me a coffee
Installation
- Install Tobey's BepInEx x MelonLoader Pack for Supermarket Simulator
- Download "Restocking Refill Rate" from the Files tab
- Unpack RestockingRefillRate dll file into bepInEx/plugins
- Alternatively, download using vortex to automatically install in the right folder.
- IndividualDisplayRefillRate: If UseIndividualDisplaySlotRefillRate toggle is enabled, the restockers will only try to restock a display slot if the product filling rate of this display slot is less or equal to this value, a value of 1 will make restockers always try to restock shelves (at least 1 product is missing), and a value of 0 will make them only restock empty shelves (possible value between 0 and 1, game default value: 0.75).
- AllDisplaysRefillRate: If UseAllDisplaySlotsRefillRate is enabled, The restockers will only try to restock a display slot if the product average filling rate in all display slots is less or equal to this value.
- UseIndividualDisplaySlotRefillRate: If enabled, the refill rate of a display slot will be taken into account to decide whether to restock it (using IndividualDisplayRefillRate value).
- UseAllDisplaySlotsRefillRate: If enabled, restocking a display will depend on the average refill rate of all display slots with the same product (using AllDisplaysRefillRate value)
- IgnoreRefillRatesForAlreadyCarriedBoxes: By default, if the restockers are carrying a box (after refilling a display or picked up from ground), instead of returning it to the storage, they will check if any other display is missing some of the same product they are carrying no matter the fill rate. If this toggle is turned off, this behavior will be disabled. (recommended keeping this enabled).
- RefillAllOutsideWorkHours: Ignore refill rates and refill any display that's not full when outside work hours (When the time freeze up)
When to use both AllDisplays and IndividualDisplay refill rates? If for example you wish your restockers would only restock products that are low in all your store (for example only 25% of your stock remains), but at the same time, if there is a display slot that is almost full (like 90% full), they should not restock that one.
Detailed Explanation for Restocking Refill Rate Options
1. Individual Display Slot Refill Options
UseIndividualDisplaySlotRefillRate
What It Does: When enabled, the restocker evaluates each individual display slot separately to decide whether it needs to be refilled.
IndividualDisplayRefillRate
What It Does: This value (ranging from 0 to 1) sets the threshold for a single display slot to be considered “in need” of a refill.
Value = 1: Restockers will refill any display slot that isn’t completely full (i.e., even if only one item is missing).
Value = 0: Restockers will only refill display slots that are completely empty.
Default (e.g., 0.75): Only display slots that are 75% full or less will trigger a refill.
Use Case: If you want to prevent refilling nearly full display slots, enable this option and set a threshold that matches your needs. For example, setting it to 0.75 means that only display slots missing at least 25% of their stock will be refilled.
2. All Displays (Overall Product) Refill Options
UseAllDisplaySlotsRefillRate
What It Does: When enabled, the mod checks the average fill level across all display slots for the same product before refilling any one of them.
AllDisplaysRefillRate
What It Does: This value (also between 0 and 1) defines the threshold for the overall average fill level of all display slots carrying the same product.
For example, setting this to 0.25 means that the restockers will only refill a display slot if the overall average for that product is 25% full or less.
Use Case: Use this option to manage overall inventory levels. It prevents refilling a display slot unnecessarily when only a section of your store is low on stock, ensuring that refills occur only when the product is in low supply across all displays.
3. Combining Both Refill Rate Options
Behavior: When both UseIndividualDisplaySlotRefillRate and UseAllDisplaySlotsRefillRate are enabled, a display slot will be refilled only if both its individual fill level and the overall average fill level (across all slots for that product) are below their respective thresholds.
Use Case: This combined approach is ideal if you want to refill a product only when the overall stock is low (e.g., only 25% remains), while avoiding refills for individual display slots that are nearly full (e.g., 90% full).
4. Handling Already Carried Boxes
IgnoreRefillRatesForAlreadyCarriedBoxes
What It Does: By default, if a restocker is already carrying a box (after refilling or picking one up from the ground), they will look for any other display slot that is missing that product—ignoring the refill rate thresholds.
Use Case: This option maximizes efficiency by allowing restockers to use an extra box immediately, rather than returning it to storage. It is recommended to keep this enabled to avoid redundant trips.
5. Outside Work Hours Behavior
RefillAllOutsideWorkHours
What It Does: When enabled, this option overrides all refill rate checks outside designated work hours. During off-hours, any display slot that isn’t completely full will be refilled regardless of the set thresholds.
Use Case: Ideal for ensuring your store is fully stocked before opening or during downtime, this option prevents delays during peak operational hours by handling all refills when the store is not in active use.
Summary of Use Cases
- Maximizing Efficiency:
Individual Options: Prevent refilling nearly full display slots by targeting only those below your chosen percentage. Overall Options: Refill only when the overall display stock for a product is low. - Combined Strategy: Use both individual and overall checks to ensure refills occur only when a specific display slot is understocked and the product is generally in short supply across the store.
- Operational Tweaks:
Ignore Carried Boxes: Allows restockers to use already carried products efficiently. Off-Hours Refill: Guarantees fully stocked display slots outside work hours.
Feel free to adjust the threshold values to best match the intended gameplay experience. These options give you full control over how and when your store’s display slots are refilled.
Notes:
- You can change the settings as you see fit in the config file located in \Supermarket Simulator\bepInEx\config\RestockingRefillRate.cfg (will be generated after you run the game)
- Alternatively, you can use Bepinex Configuration Manager to change the mod settings in-game (F1 to open the manager)
Buy me a coffee