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
Create a new Tebex package.
Add an appropriate title, description, and image.
Navigate to the Variables tab.
Configuring the Deliverable (Automatic Boat Addition)
Select Game Server Commands.
Under Game Servers, select your game server.
Command Configuration
Under When the package is purchased, enter a variation of the following command:
Replace boatmodel with the boat spawn name.
Additional Settings
Game Server to Execute On:
Select your server
Require Player to Be Online:
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:
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
Create a new Tebex package.
Add an appropriate title, description, and image.
Add a Game Server Commands deliverable.
Under Game Servers, select your game server.
Command Configuration
Under When the package is purchased, enter a variation of the following command:
Replace boatmodel with the boat spawn name.
Additional Settings
Game Server to Execute On:
Select your server
Require Player to Be Online:
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.
