> For the complete documentation index, see [llms.txt](https://jixelpatterns.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://jixelpatterns.gitbook.io/docs/dependency/jim_bridge/stash-control.md).

# Stash Control

## stashcontrol.lua

This module handles logic for interacting with stashes—shared inventories for crafting, jobs, or storage systems.

###

### **checkStashItem(stashes, itemTable)**

Retrieves (or updates) a local stash cache entry with a timeout.

**Example:**

```lua
local found, foundinStash = checkStashItem({"crafting_stash"}, { item = "steel", amount = 2 })
if found then print("Found item in "..foundInStash) end
```

***

### **openStash(data)**

Opens a stash using the active inventory system.

Checks for job or gang restrictions before opening the stash.

**Example:**

```lua
openStash({
    stash = "playerStash",
    label = "Player Stash",
    coords = vector3(100, 200, 30)
})
```

***

### **getStash(stashName)**

Retrieves the stash data by name (usually used for querying contents).

**Example:**

```lua
local items = getStash("playerStash")
for k, v in pairs(items) do
    print(k)
end
```

***

### **stashRemoveItem(stashItems, stashName, items)**

Removes specified items from a stash. Used during crafting or transfers.

**Example:**

```lua
stashRemoveItem(currentItems, "playerStash", { iron = 2, wood = 5 })
```

***