ryuka_labs-GridWise icon

GridWise

A grid-based inventory sorter for SULFUR with custom zones, locked cells, container support, and 14-language localization.

Last updated 4 hours ago
Total downloads 5
Total rating 0 
Categories Mods Tools
Dependency string ryuka_labs-GridWise-1.15.6
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2305 icon
BepInEx-BepInExPack

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

Preferred version: 5.4.2305

README

GridWise

A grid-based inventory sorter for SULFUR.

GridWise adds real inventory sorting, editable custom zones, locked cells, container support, and native-style in-game UI for inventory organization.

GridWise edit mode

Features

  • Real inventory sorting.
  • Player backpack support.
  • Stash / container support, including chests and fridge-style storage.
  • Sort hotkey.
  • In-game Sort button.
  • Edit Mode for custom layout editing.
  • Custom Zones:
    • New / delete / rename zones.
    • Enable or disable zones.
    • Allowed item categories.
    • Exclusive zones.
    • Priority.
    • Anchor direction.
    • Zone color.
  • Per-grid zone layouts:
    • Zone rules are shared globally.
    • Player backpack and containers save their own zone cell layouts.
  • Locked cells:
    • Right-click cells in Edit Mode to lock them.
    • Locked cells are saved separately for the player backpack and containers.
  • Hover tooltip in Edit Mode:
    • Shows cell coordinates.
    • Shows locked state.
    • Shows zones on the cell.
    • Shows zone colors and allowed categories.
  • 14-language localization:
    • ar, de, en, es, fr, it, ja, ko, pl, pt, ru, sv, tr, zh-CN.
    • Follows the game's language setting.
  • Native-style dark and gold UI.

Default Controls

Action Default
Sort inventory R
Enter / exit Edit Mode T
Lock / unlock cell in Edit Mode Right-click
Paint zone cells in Edit Mode Left-click
Save and exit Edit Mode Esc or F

When a container is open:

  • Pressing the sort hotkey sorts the side under the mouse.
  • Clicking the Sort button sorts both the player backpack and the opened container.
  • In Edit Mode, Sort affects all currently open grids.

GridWise edit mode 2

Installation

Thunderstore / r2modman

Install the mod through Thunderstore Mod Manager or r2modman.

Make sure the required BepInExPack dependency is installed.

Manual Installation

  1. Install BepInExPack for SULFUR.
  2. Start the game once so BepInEx creates its folders.
  3. Place GridWise.dll into:
BepInEx/plugins/
  1. Start the game.

Configuration

The config file is generated after the first launch:

BepInEx/config/Ryuka.Sulfur.GridWise.cfg

Important defaults:

[Safety]
EnableRealSort = true

[Output]
ExportRealSortDebugFiles = false
ShowRealSortResultAlert = false

Generated user data files are stored under GridWise's config data location, for example:

GridWise.CustomZones.json
GridWise.ZoneLayout.json
GridWise.ZoneLayout.stash-*.json
GridWise.LockedCells.json
GridWise.LockedCells.stash-*.json

Notes

GridWise does not edit original game files.

This mod was built for the current SULFUR BepInEx modding environment. If a game update changes inventory or container internals, some features may need an update.

Source Code

The source code for this mod is available in my GitHub repository.

It is shared for learning, reference, and transparency.
The repository only contains my original mod source code and packaging text. It does not include SULFUR game files, Unity assemblies, BepInEx binaries, paid assets, or decompiled game source.

If you are another modder, feel free to study how the mod works or use it as a reference for your own implementation.

GridWise

Changelog

1.15.5

Initial public release.

Added

  • Real inventory sorting.
  • Custom zone editing.
  • Zone rename support.
  • Shared zone definitions with per-grid layouts.
  • Locked cells.
  • Player backpack support.
  • Container / stash support.
  • Mouse-side sorting when a container is open.
  • Sort button sorting both backpack and container.
  • Edit Mode support for backpack and container grids.
  • Edit Mode hover tooltip.
  • 14-language localization.
  • Native-style dark and gold UI.

Defaults

  • EnableRealSort = true
  • ExportRealSortDebugFiles = false
  • ShowRealSortResultAlert = false