Tebex Implementation

This guide explains how to connect your Battle Pass V3 with Tebex to handle premium purchases via Tebex.

Add Tebex Secret Key to Your server.cfg

  1. Log in to your Tebex control panel.
  2. On the left-hand navigation menu, click Integrations and Game Servers.
  3. Click Instructions next to the Game Server you want to use.
  4. Copy the command provided and paste it into your server.cfg. It should look something like this:
server.cfg
sv_tebexSecret <YourSecretKey>

Make sure to replace <YourSecretKey> with the actual secret key provided by Tebex.

Create a Tebex Package

  1. In your Tebex control panel, navigate to Packages.
  2. Create a new package, for example, "Premium Battle Pass".
  3. At the bottom of the package creation screen, select Game Server Commands as the deliverable type.

  1. Select your game server and click Add Command.
  2. Use the following command to deliver premium:
    bpsaveredeemcode {transaction}
  3. Click on the settings icon on the right
  4. Select your game server again here and make sure that the command is executed even if the player is offline (if you require the player to be online and the player is online, it may not work)

  1. Save your package.

Test the Integration

  1. In the Tebex control panel, click Payments on the left-hand menu.
  2. Click on Create Payment.
  3. Enter your username under Customer and select the package you created earlier.
  4. After creating the payment, you should be able to claim premium in-game by using your payment ID.

Possible Problems

If players are unable to claim premium after a Tebex purchase, try the following solutions:

Wait for Processing

Problem: Sometimes there's a short delay before premium become available after a successful purchase.

Fix: Inform players that it can take up to 5 minutes for premium to be claimable in-game after completing the purchase.

Check Tebex Secret Key Usage

Problem: Payments may not be linked to the correct server if multiple servers are using the same tebexSecretKey.

Fix:

  • Open the server.cfg file on all running servers.
  • Make sure only your live (production) server contains the tebexSecretKey.
  • Remove the key from all other environments (e.g., development or test servers).

Custom Quests

The Battle Pass V3 allows you to define your own quests and track player progress through them. This guide will walk you through creating a custom quest using the configurator and updating quest progress in your script.

Daily Rewards V3