Shelf Picker

Description

Shelf Picker adds a quick way to assign products to shelf rows. Look at a shelf row and press G to open a searchable picker listing every unlocked product with its image, category, and how many fit on the row. Pick one and the row is assigned; your restockers fill it from storage, exactly like a row you assigned by hand. Works in single player and co-op.

Installation instructions

• []Install BepInEx 5 (Mono, x64) for Supermarket Together, or use r2modman / the Thunderstore Mod Manager, which set it up for you.[/]

  []Extract the zip. Inside is a glove-shelfpicker folder with two DLLs.[/]

  []Copy that folder into your BepInEx plugins folder, so the DLLs sit at BepInEx/plugins/glove-shelfpicker/.[/]

  []Start the game (through r2modman if you use it). BepInEx loads plugins at startup, so restart if the game was already running.[/]

  []Face a shelf row and press G.[/]

Main features

• []Searchable picker: press G while looking at a shelf row (key rebindable in the config). Search by product name or brand, case-insensitive. Typing G in the search box does not close the menu.[/]

  []Full product info: sprite, localized name, brand, franchise category in the game's group colors, and exact per-row capacity using the game's own stacking formula.[/]

  []Vanilla-safe assignment: assign, swap, and clear rows through the game's own network commands, so sync, shelf prices, and restocker behavior act exactly like a hand-assigned row.[/]

  []Box-out on swap and clear: assigning a different product to a stocked row, or clearing one, packs the old stock into boxes instead of deleting it, and storage employees carry it back. Disable with BoxOutOnSwap in the config.[/]

  []Co-op ready: assignment runs through the host like any vanilla action, and any player may assign, following the game's own permission rules.[/]

  []Fixes a vanilla bug where a cleared row kept its stale item objects until the row was assigned again.[/]

  []Safe typing: while the menu is open, game shortcuts (P, T, E, F, C, 1-9) are suppressed, and they come back exactly as they were when you close it.[/]

Requirements

BepInEx 5.x (Mono, x64) for Supermarket Together. No other mods required.

Shout outs

Thanks to the BepInEx and HarmonyX teams for the plugin stack, and to the Store Manager Toolkit mod, whose approach to calling the game's private assign command pointed the way.