🛳️Boat Purchases

Issuing Boats via Tebex

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

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

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

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

---

Automatic Issuing of Boats (Offline Supported)

To automatically add boats 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 Boat 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 Boat 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_autoaddboat {citizenid} boatmodel {transaction}

• Replace boatmodel with the boat 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 boat will be automatically added to the configured auto-added boat garage Config.AutoAddedBoatGarage. 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 boat using the /claim command followed by the Tebex transaction ID.

Example:

/claim tbx-90834225a75215-784a42

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

Important: Boats must either:

• Be redeemable via /redeem, or

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

---

Issuing Boats for Redemption / Collection Only

If you want boats 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 Boat 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_addboatredeem {hexid} boatmodel {transaction}

• Replace boatmodel with the boat 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 boat will be available for redemption via /redeem or collection from a configured boat collection location, depending on your script configuration. The player will be notified in game that this is available for redemption / collection.