# Player guide

This guide covers how to use the MOH Business System as a player, both as a store owner and as a buyer.

## As a Store Owner

If your character has the required job (configured per store), you can interact with the boss NPC at the store location to order items, manage your stash, and activate auto-sell.

### Placing an Order

1. Walk up to the boss NPC at your store location. The target interaction *Order Items* will appear.
2. The Arsenal shop UI opens, showing all available items for this store.
3. Click an item to open the quantity selection screen. Choose how many you want of that item.
4. Repeat for other items. You can select up to the store's configured item type limit per order.
5. The total price is shown at the bottom of the UI. Make sure you have enough cash.
6. Click **CONFIRM ORDER** to place the order.
7. A supplier NPC will spawn at a random location on the map. A waypoint is set for you automatically.
8. Travel to the supplier NPC and use the *Buy Items* target interaction.
9. Payment is deducted from your cash and the items are added to the store stash.

### Order Rules

* You must wait for the cooldown period (default: 10 minutes) before placing another order.
* You cannot place a new order while a mission is already in progress.
* The maximum number of different item types per order is set per store (default: 5).
* Payment comes from your cash account (or bank, depending on server configuration).

### Managing the Stash

1. In the shop UI, click **OPEN ARSENAL** to open the stash management screen.
2. If this is your first time, you will be prompted to set a stash password. Remember this password — you will need it each time.
3. The left panel shows your personal inventory. The right panel shows the store stash.
4. Click an item in your inventory to add it to the stash.
5. Click an item in the stash to remove it back to your inventory.
6. Use the quantity selector to choose how many to transfer.

### Resetting the Stash Password

1. Open the shop UI and click **OPEN ARSENAL**.
2. On the password prompt, click **RESET PASSWORD**.
3. Confirm the reset. Your password will be deleted from the database.
4. You will be prompted to set a new password immediately.

### Auto Sell

1. In the shop UI, click the **AUTO SELL** tab.
2. The tab shows how many items are in the stash, their total value, and the current auto-sell status.
3. Click **ACTIVATE AUTO SELL** to spawn the auto-sell NPC at the configured location.
4. Other players on the server will now see the NPC and can browse and buy your stock.
5. Click **DEACTIVATE AUTO SELL** to remove the NPC and stop sales.
6. Only one player can have auto-sell active per store at a time.

### Setting Item Prices

When viewing the Auto Sell tab, each item in the stash shows the current sell price. You can adjust prices within the limits set by the server administrator (`Config.AutoSellMarkup.min` to `Config.AutoSellMarkup.max` percent above base price). If you do not set a custom price, the default markup is applied automatically.

## As a Buyer

Any player can purchase items from an active auto-sell NPC — no special job is required.

1. Look for the auto-sell NPC at the store location (visible when the owner has activated auto-sell).
2. Walk up to the NPC. The target interaction *Browse Arsenal* will appear.
3. The store UI opens, showing available items and their current prices.
4. Click an item to buy one unit of it immediately.
5. Payment is deducted from your cash (or bank, depending on server configuration) and the item is added to your inventory.
6. Stock is deducted from the store stash. If an item runs out, it is removed from the store listing.

## UI Reference

| Button               | Location      | Action                                                          |
| -------------------- | ------------- | --------------------------------------------------------------- |
| CONFIRM ORDER        | Shop tab      | Submit the current item selection and start the mission         |
| OPEN ARSENAL         | Shop tab      | Open the stash management screen                                |
| CANCEL               | Shop tab      | Close the UI without placing an order                           |
| ACTIVATE AUTO SELL   | Auto Sell tab | Spawn the auto-sell NPC and make your stock available to buyers |
| DEACTIVATE AUTO SELL | Auto Sell tab | Remove the auto-sell NPC and stop sales                         |
| MANAGE ARSENAL       | Auto Sell tab | Open the stash management screen from the Auto Sell tab         |
| CLOSE                | Auto Sell tab | Close the UI                                                    |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://mohssins.gitbook.io/mohscriptsdocs/moh-businesssystem/player-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
