MojoRyzen's Grab Materials Mod

Created on January 30 2025.
Version 1.1.0 released on May 5 2026.

Quickly pull materials from nearby chests into your inventory without having to manually click on each chest. The concept is similar to mods that let you craft or build directly from containers, but for things that you're not building in your base. The typical example is workbench and portal when exploring - you're constantly having to grab 10 wood, 20 finewood, 10 greydwarf eyes, and 2 surtling cores. This mod removes that tedium.

New in version 1.1.0

Grab results are now shown in a wood-styled panel at the top center of the screen (instead of a brief HUD message). The panel lists every requested material with a green ✓ for items that are fully available and a red ✗ with "X of Y Item (missing N)" for shortages.

Atomic grab — if any requested material is short, nothing is taken from any container; the panel tells you exactly what's missing so you can go get it.

The panel auto-fades over 3 seconds when you start moving, attacking, blocking, or jumping (after a brief grace period to handle the case where you trigger the grab while already running). After 15 seconds of no input it fades on its own. Click anywhere on the panel to dismiss it instantly.

New "Panel UI" config section to tune the idle timeout, the fade duration, and whether movement dismisses the panel.

You can now grab materials for any build piece by hovering over its icon in the build menu and pressing 'j' — no need to select it first. (Falls back to the selected piece when you're not hovering anything.)

Grab pack "Grab Delta" flag is now supported — when enabled for a pack, only the shortfall between what you already have and what's needed is grabbed. E.g. if the pack needs 10 wood and you have 7, only 3 will be pulled.

Fix in version 1.0.1

Fixed a bug where it would grab 10 stone instead of 10 wood for the Chest build piece

New in version 1.0.0

Hit 'j' when the build menu is open to automatically grab materials for the currently selected build piece

Support for ten different grab packs with configurable keyboard shortcuts

Grab the materials for a build piece by typing '/grab portal' in the chat window

Grab the materials for a grab pack by typing '/grab <n>' or '/grab <pack-name>' in the chat window

Specify build piece names in grab pack configuration

Shorthand console commands, e.g. type '/g' instead of '/grab'

Specify the count before or after the material name, e.g. '/grab 10 wood' or '/grab wood 10'

Match on both the user-friendly name that you see in-game and the internal ID.

Case insensitive matching

'/listpacks' to write the list of grabpacks to the log

Configure how long containers are highlighted when you pull items from them or search for items

'/inventory [search-text]' to count the number of items within range; if search-text specifies, looks for items that match on name or category

Fixes in version 1.0.0

Settings changes are now automatically picked up when you change the config file directly

Destroyed containers not removed from the list causing NullPointerException

Removed unnecessary logging

Join my discord server to ask questions or provide feedback.

View the backlog here.

See wiki for more details.