🎁Item Purchases

Issuing Items via Tebex

Items can be issued to players as redeemable items or collectible from a configured location, depending on your script configuration.

Note: Items do not require the customer to enter their CSN during purchase. The player must be online for the deliverable command to execute.

---

Creating the Tebex Package for Item Issuing

1. Create a new Tebex package.

2. Add an appropriate title, description, and image.

3. Click Add Deliverable.

4. Select Game Server Commands.

5. Under Game Servers, select your game server.

---

Command Configuration

Under When the package is purchased, enter a variation of the following command:

tebex_additemredeem {hexid} itemname quantity {transaction}

Command Parameters

• itemname — The internal item name (as defined in Shared.Items)

• quantity — The number of items to issue

• {hexid} — Automatically populated by Tebex

• {transaction} — Automatically populated by Tebex

---

Additional Settings

• Game Server to Execute On: Select your server

• Require Player to Be Online:

  Only execute the command when the player is online

1. Save and publish the package.

---

Item Redemption & Collection

Once purchased:

• The item will be available via /redeem, or

• Collectible from a configured collection location

(depending on your script configuration).

The player will receive an in-game notification when the item is available for redemption or collection.

---

Package Items

Package items allow you to give players a pre-configured set of items when the package item is used. These are ideal for starter packs, bundles, kits, or promotional rewards.

Package contents are fully configurable via the script’s config.lua.

---

Package Item Configuration

Package items must first be defined as usable items in your shared items file.

In core > shared.gta5.lua, configure a package item similar to the example below:

["starterpack"] = {
    ["label"] = "Starter Pack",
    ["weight"] = 1,
    ["type"] = "item",
    ["image"] = "box.webp",
    ["unique"] = true,
    ["stackable"] = false,
    ["useable"] = true,
    ["shouldClose"] = true,
    ["description"] = "A pack containing starter items.."
},

• Replace starterpack with your package item’s internal name.

• Ensure useable is set to true.

---

Configuring Package Contents

Once the package item is defined, configure the items it awards in the script’s config.lua file.

Under Config.Packages, define the items and quantities the player should receive when the package is used.

Example Configuration

Config.Packages = {
    ['starterpack'] = {
        { item = 'water_bottle', quantity = 1 },
        { item = 'apple', quantity = 3 },
        { item = 'banana', quantity = 2 },
    }
}

---

How Package Items Work

• You can define as many package items as you want.

• When a player uses a package item from their inventory:

  • The item is consumed.

  • The configured contents are granted to the player.

Example Outcome

Using the configuration above, when a player uses the starterpack item, they will receive:

• 1× Water Bottle

• 3× Apples

• 2× Bananas