> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexdev.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Player usage

> What your players will actually do in-game.

What your players will actually do in-game.

## Opening the shop

Press **F9** (default keybind) or type `/donatorshop`. Both can be renamed in `configs/config.lua` (`Config.Key` and `Config.Command`). Each player can rebind the key under **F1 → Settings → Key Bindings → FiveM**.

## Home

The Home tab is the catalogue. Players can:

* Filter by category using the tabs at the top
* Search by name, tag, or description
* Open any card to see the full description and the payment modal
* See active **Special Deals** in the Trending banner

## Buying something

Click a card → review the payment modal → **Confirm**.

* **Vehicles** spawn `Config.TestDriveSpawnDistance` metres in front of the player (default 5m) and are registered with the framework's owned-vehicles table plus any vehicle-keys script that's running.
* **Items / weapons / tools** are pushed straight into the configured inventory (`ox_inventory` by default, or the framework's native inventory).

## Test drive

Open a vehicle's payment modal → click **Test Drive**.

* You're moved into a private routing bucket so traffic, other players, and other test drivers can't collide with you.
* The vehicle spawns at `Config.TestDriveLocation`.
* A countdown HUD shows the remaining time (default 120 seconds).
* When the timer ends, the vehicle is deleted and you're teleported back to where you were standing when the drive started.

## Redeeming a Tebex order

After buying a currency package on your Tebex store, the player gets a confirmation email containing a `tbx-xxxxx-xxxxx` order ID. To redeem it:

1. Open the shop → **Redeem** tab.
2. Paste the order ID into the field.
3. Click **Confirm**.

The currency lands in their wallet immediately. Each order can only be redeemed once. Refunded or charged-back orders are rejected automatically.

## Gifting

In the **Redeem** tab, switch to **Gift Someone**:

1. Paste a valid `tbx-xxxxx-xxxxx` order ID you purchased.
2. Enter the recipient's server ID.
3. Click **Confirm**.

The target player gets the currency instead of you. The recipient must be online. The same order still can't be redeemed twice.

## Special deals

A red **Trending** banner at the top of Home shows the currently active deal bundles with a live countdown. Click a deal → review the bundle contents → **Confirm**. The full bundle is delivered at once.

Deals are wiped daily at `Config.DealResetHour` (default midnight server time). Watch the countdown if you want to grab one before it expires.