AzraelGodKing-SenpaisChest icon

SenpaisChest

Smart Chests with configurable item rules for automatic storage organization in Sun Haven.

Last updated a day ago
Total downloads 94
Total rating 0 
Categories Mods
Dependency string AzraelGodKing-SenpaisChest-2.0.3
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100

README

Senpai's Chest

Version 2.0.1 — Smart chests with configurable item rules for hands-free storage organization in Sun Haven. Chest labels, rules by item/category/type/property/group, per-character saves.

Features

  • Chest Labels — Labels above chests (Chest, Large Wooden Chest, BankChest). Configurable visibility. Excludes Hoppers and Animal Feeders.
  • Smart Chests — Mark any chest as a Smart Chest and define rules for which items it collects
  • Automatic Sorting — Smart Chests periodically scan nearby chests and pull matching items (scan interval configurable)
  • Flexible Rules — Filter items by:
    • By Item — Specific items (search by name)
    • By Category — Equip, Use, Craftable, Monster, Furniture, Quest
    • By Item Type — Normal, Armor, Food, Fish, Crop, Watering Can, Animal, Pet, Tool
    • By Property — Gems, Forageables, Animal Products, Meals, Fruits, Artisanry Items, Potions, Museum (Not Donated)
    • By Group — Your own custom subcategories (e.g. Flowers, Vegetables). Create groups in Manage Groups, add items via search, then attach to chests with one click.
  • Per-Character Saves — Each character's Smart Chest settings are saved separately
  • Multiplayer Safe — Skips chests that other players are using

Usage

  1. Open any chest
  2. Press F9 (or your configured key) to open the Smart Chest configuration
  3. Enable Smart Chest and add rules for items this chest should collect
  4. Close the config and the chest
  5. Matching items will be pulled from nearby chests automatically on each scan

Configuration

Edit BepInEx/config/com.azraelgodking.senpaischest.cfg:

Setting Default Description
EnableChestLabels true Show labels above chests
LabelVisibility Visible Chest labels: Visible, OnHover, or Hidden
IconVisibility Visible Item icons in labels: Visible, OnHover, or Hidden
ScanInterval 60 Seconds between scans (min: 10)
EnableNotifications true Show notifications when items are moved
MaxItemsPerScan 50 Max item stacks moved per scan (reduces lag)
ToggleKey F9 Key to open config UI while chest is open
RequireCtrlModifier false Require Ctrl held with toggle key
CheckForUpdates true Check for mod updates on startup

Notes

  • Smart Chests do not pull from other Smart Chests (prevents loops)
  • Chests in use by another player are skipped
  • Configuration is tied to chest position; moving a chest resets its config

Tips — Fine-Grained Sorting

The game's ItemType "Crop" includes flowers, vegetables, and all crop types. Use By Group for the easiest way to separate them:

  1. Open a chest, press F9, and click Manage Groups
  2. Create a group (e.g. "Flowers"), search for items, and add them
  3. Use By Group when adding rules to attach the group to any chest with one click
  4. Reuse the same group across multiple chests—edit it once to update all of them

Links