Tebex Integration

Overview: This guide will walk you through the complete process of integrating Tebex with your game server, enabling automated product delivery and payment processing.

Prerequisites

Before you start, ensure you have:

• Administrative access to your Tebex account

• Server configuration file access (server.cfg)

• The script you want to integrate installed and working

• Basic understanding of server commands

---

Step 1: Connect Game Server

Navigate to Tebex > Game Servers > Connect Game Server in your Tebex dashboard.

Tebex Integration

Note: Copy the secret key that Tebex provides - you'll need it in the next step.

---

Step 2: Configure Server

Add the Tebex secret code to your server.cfg file. This establishes the connection between your server and Tebex.

# Add this line to your server.cfg
set tebex_secret "YOUR_SECRET_KEY_HERE"

Paste Tebex Secret

Server Connection Complete: Your server is now connected to Tebex. You can proceed to create products and link them to your scripts.

---

Step 3: Create a Package in Tebex

Navigate to Tebex > Package > Create Package to set up your product.

Create Package

Package Configuration Tips:

Recommended Settings:

• Set a clear, descriptive package name

• Add detailed description for customers

• Configure appropriate pricing

• Set purchase limits if needed

• Enable/disable as required

---

Step 4: Configure Script Commands

This is the crucial step where you define what happens when a customer purchases your package.

Script Command

Available Script Commands:

Multicharacter

For UZ-Scripts Multicharacter system:

purchase_multicharacter_newslot {"transid":  "{transaction}"}

This command grants a new character slot to the purchaser.

Daily Reward

Important: Make sure the commands you use are compatible with your server setup and the scripts are properly installed.

---

Step 5: Testing and Activation

Before going live, thoroughly test your integration to ensure everything works correctly.

Testing

Testing Checklist:

• Verify server connection status in Tebex dashboard

• Test purchase with test payment methods

• Confirm commands execute correctly

• Check player receives items/permissions

• Validate transaction logs

Testing Tip: Use Tebex's test payment methods to verify your setup without real money transactions.

---

Final Configuration

Final Step

---

Troubleshooting

Common Issues and Solutions:

Server Not Connecting

• Double-check the secret key in your server.cfg

• Ensure your server is online and accessible

• Verify firewall settings allow Tebex connections

Commands Not Executing

• Verify script is properly installed and running

• Check command syntax matches your script requirements

• Review server console for error messages

• Ensure player is online when purchase is made

Payment Issues

• Check Tebex payment gateway settings

• Verify your store is published and not in draft mode

• Ensure pricing and currency are correctly configured

Getting Help:

• Tebex Support: Contact through their official support channels

• UZ-Scripts Support: Join their Discord server for script-specific help

• Server Logs: Always check your server console and logs for detailed error information

---

Best Practices

Security:

• Keep your Tebex secret key private and secure

• Regularly update your scripts and server software

• Monitor transaction logs for unusual activity

User Experience:

• Provide clear product descriptions

• Set reasonable prices for your community

• Offer good customer support for purchase issues

Maintenance:

• Regularly test your integrations

• Keep backups of your configuration

• Stay updated with Tebex and script updates

---

🎉 Congratulations! Your Tebex integration is now complete and ready to use. Your players can now purchase items directly through your Tebex store, and the integration will automatically handle the delivery.