MegaStash

# MegaStash

Increase the storage capacity of player stashes with a fully configurable upgrade system.

MegaStash allows players to permanently upgrade the number of inventory slots in their own stashes by simply hitting them with a hammer. Upgrades can be completely free or paid for using resources, ServerRewards points, or Economics currency.

The starting stash size is fully configurable, and players can expand their stash all the way up to 48 slots while keeping the normal Rust stash behaviour.

---

Features

• Upgrade stash capacity from 1 to 48 slots

• Configurable starting slot amount (1-48)

• Upgrade using:

- Resources - ServerRewards - Economics - Free upgrades

• Fully configurable upgrade costs

• Supports custom resource requirements

• Supports skinned items as upgrade costs

• Optional upgrade sound effects

• Custom chat messages and icons

• Existing stashes retain their upgraded size

• Works exactly like a normal stash with additional storage

• Lightweight and wipe friendly

---

Permission

| Permission | Description |
|------------|-------------|
| MegaStash.Upgrade | Allows players to upgrade stashes by hitting them with a hammer. |

---

Console Command

| Command | Description |
|---------|-------------|
| megastash.clear | Clears all saved stash upgrade data, resetting every stash back to the configured starting slot amount. Recommended after map wipes. |

---

Usage

1. Place a stash.
2. Hit the stash with a hammer.
3. Each successful hammer hit purchases one additional inventory slot.
4. The configured upgrade cost is charged.
5. Continue upgrading until the stash reaches the maximum of 48 slots.

---

Configuration

Chat Message Name

Changes the name displayed in chat messages.

Chat Message Icon (SteamID)

Steam ID used for the chat icon.

Upgrade Sound Effect

Sound played whenever a stash is upgraded.

Leave empty ("") to disable sounds.

Start Slot Amount

Sets how many slots a newly placed stash starts with.

Range: 1 - 48

Upgrade Cost Type

Choose how players pay for upgrades.

Available options:

• resources

• serverrewards

• economics

• free

Upgrade Cost For

Amount charged when using:

• ServerRewards

• Economics

Upgrade Cost When Using Resources

Define one or more resources required for each upgrade.

Example:

{
  "Shortname": "scrap",
  "Amount": 5,
  "SkinID": 0,
  "Name": ""
}

You can require multiple resources by adding additional entries.

---

Resource Cost Template

[
  {
    "Shortname": "scrap",
    "Amount": 5,
    "SkinID": 0,
    "Name": ""
  }
]

Field Description

| Field | Description |
|-------|-------------|
| Shortname | Rust item shortname. |
| Amount | Amount required. |
| SkinID | Optional skin ID. Use 0 for normal items. |
| Name | Optional display name used for custom skinned items. |

---

Video

Notes

• Maximum stash capacity is 48 slots.

• Starting capacity can be set anywhere between 1 and 48 slots.

• Upgraded stash sizes are saved automatically.

• Running megastash.clear removes all saved upgrade data and returns every stash to the configured starting size. Recommended after server wipes to keep the data file small.

---