> For the complete documentation index, see [llms.txt](https://wiki.osro.gg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.osro.gg/beginners-guide/restock-system.md).

# Restock System

{% hint style="info" %}
**What is Restock?**

Restock is a **VIP-only feature** that automatically refills consumables (potions, seeds, fly wings) into your inventory whenever you run low!
{% endhint %}

## 🧠 How It Works 

* **VIP Requirement:** You must have active **VIP status** to use restock commands.
* **Invisible Vault:** Each character has their own **separate Restock Vault**.
* **Not Standard Storage:** It cannot be opened like `@storage`. You use commands to put items in or take items out.
* **Automatic Refill:** When an item in your inventory drops below your set limit, the system automatically pulls supplies from your vault.

## 🛠️ Step-by-Step Example

Let's say you want to keep **20 Yggdrasil Seeds** ![](/files/FbLMH2gT3oNj7BsrAn46) in your inventory, and refill whenever you **drop below 10**:

{% hint style="warning" %}
🚨 **CRITICAL RULE:** You **MUST** set the config (`@restock ...`) **BEFORE** depositing items into your vault!
{% endhint %}

{% stepper %}
{% step %}

## Set the Config Rule

```
@restock 608 10 20 0
```

* **`608`** = Item ID (Yggdrasil Seed ![](/files/FbLMH2gT3oNj7BsrAn46) )
* **`10`** = Trigger amount (refill when inventory has lower than 10)
* **`20`** = Target amount (refill back up to 20)
* **`0`** = Mode (`0` = Add to inventory, `1` = Remove from inventory)
  {% endstep %}

{% step %}

## Deposit Supplies into Vault

```
@restockdeposit 608 100
```

* Moves **100 Yggdrasil Seeds** ![](/files/FbLMH2gT3oNj7BsrAn46)  from your inventory into your character's Restock Vault.
  {% endstep %}

{% step %}

## Turn Restock ON

```
@restockon
```

* Turns the system on! Now whenever your seeds drop below 10, it auto-refills up to 20 from your vault. Restock will remain on as long as you have VIP Status
  {% endstep %}
  {% endstepper %}

## 📋 Command Cheat Sheet

| Command                              | What It Does                            |
| ------------------------------------ | --------------------------------------- |
| **`@restockon`**                     | Turn restock **ON**                     |
| **`@restockoff`**                    | Turn restock **OFF**                    |
| **`@restockstatus`**                 | Check if restock is ON or OFF           |
| **`@restocklist`**                   | View all your active restock rules      |
| **`@restockvault`**                  | View what items are inside your vault   |
| **`@restock <ID> <min> <max> 0`**    | Set a restock rule for an item          |
| **`@restockdeposit <ID> <amount>`**  | Put items from inventory into vault     |
| **`@restockwithdraw <ID> <amount>`** | Take items from vault back to inventory |
| **`@restock`**                       | Show command help list                  |

## ❓ Troubleshooting & FAQs

<details>

<summary><strong>Q: Why is my item not restocking?</strong></summary>

1. Did you turn it on using `@restockon`?
2. Is your account currently **VIP**?
3. Did you set the config (`@restock`) **before** depositing items?
4. Do you have items remaining inside your `@restockvault`?

</details>

<details>

<summary><strong>Q: Can my other characters use items in my vault?</strong></summary>

No. Each character has their own **separate vault**. You must deposit items for each character individually.

</details>