✈️Aircraft Purchases

Issuing Aircraft via Tebex

Aircraft can be issued to players automatically, even while they are offline. This requires the customer to enter their CSN during purchase on Tebex.

Alternatively, aircraft can be issued for redemption or collection, allowing players to redeem or collect their aircraft after joining the server.

• If the player is online, the aircraft will be made collectible or redeemable immediately.

• If the player is offline, the aircraft will become collectible or redeemable the next time they join.

---

Automatic Issuing of Aircraft (Offline Supported)

To automatically add aircraft while a player is offline, the customer must enter their CSN when purchasing the Tebex package. This requires the CSN to be configured as a variable in your Tebex store.

I personally don't like this approach as customers often make errors when entering their CSN but this script does have a fallback when a customer enters an invalid CSN (outlined below). I recommend issuing for redemption / collection but I've included this option should you wish to use it.

---

Creating the Tebex Package for Automatic Aircraft Addition

1. Create a new Tebex package.

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

3. Navigate to the Variables tab.

4. Enable the following variable:

   citizenid

---

Configuring the Deliverable (Automatic Aircraft Addition)

1. Click Add Deliverable.

2. Select Game Server Commands.

3. Under Game Servers, select your game server.

Command Configuration

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

tebex_autoaddaircraft {citizenid} aircraftmodel {transaction}

• Replace aircraftmodel with the aircraft spawn name.

Additional Settings

• Game Server to Execute On: Select your server

• Require Player to Be Online:

  Execute the command even if the player is offline

1. Save and publish the package.

Once published, customers will be prompted to enter their CSN during purchase, and the aircraft will be automatically added to the configured auto-added aircraft garage Config.AutoAddedAircraftGarage . If the player is online they'll be notified of this in game.

---

Fallback: Invalid CSN Handling

If a customer enters an invalid CSN during purchase:

• The script will automatically detect the issue.

• The purchase will be added to the tebexfailed table in your database.

Claiming a Failed Purchase

The player can manually claim the aircraft using the /claim command followed by the Tebex transaction ID.

Example:

/claim tbx-90834225a75215-784a42

The aircraft will then be made collectible or redeemable, depending on your configuration.

Important: Aircraft must either:

• Be redeemable via /redeem, or

• Have a configured aircraft collection location set in the script configuration.

---

Issuing Aircraft for Redemption / Collection Only

If you want aircraft to be issued only for redemption via /redeem or collection from a configured location, the CSN variable is not required. Customers will not need to enter their CSN during purchase.

---

Creating the Tebex Package for Aircraft Redemption / Collection

1. Create a new Tebex package.

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

3. Add a Game Server Commands deliverable.

4. Under Game Servers, select your game server.

Command Configuration

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

tebex_addaircraftredeem {hexid} aircraftmodel {transaction}

• Replace aircraftmodel with the aircraft spawn name.

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.

Once published, the aircraft will be available for redemption via /redeem or collection from a configured aircraft collection location, depending on your script configuration. The player will be notified that this is available in game.