Tebex RCON Adapter

Tebex RCON Adapter

The “RCON Adapter” is a self-hosted application that connects your Tebex webstore and your server together through RCON.

It is an alternative to Direct RCON that enables more reliable command execution, player online/offline checking, and command success/failure checking.

​

When using the RCON Adapter, it will query Tebex for commands (just like a Tebex game server plugin would) and execute them on your server via an RCON connection.

It may be used in cases where a game server implements the RCON protocol but does not have a Tebex plugin available.

Officially Supported Games

It’s recommended to use the RCON Adapter for these games in order to receive the most reliable integration experience:

• Conan: Exiles
• 7 Days to Die
• Minecraft
• ARK: Survival Evolved
• Rust

Please note that while the RCON Adapter can connect to any game server that implements RCON, we cannot guarantee full support for all games unless they are listed above.

​

How To Setup RCON Adapter

Our one-click Droplet through DigitalOcean allows for easy setup of the RCON Adapter.

1. Log in to your Droplet and run ./configure.sh to prepare the app for starting. You will enter your webstore’s secret key and RCON connection information.
2. Run ./start.sh. This runs a systemd service created for the RCON Adapater.
3. To stop processing commands for your webstore, simply run ./stop.sh
4. To view the most recent logs, use ./logs.sh

If RCON connection is lost, the Adapter will attempt to reconnect every 5 seconds. Each restart of the Adapter will attempt to connect to the same server again unless re-configured. The adapter must successfully connect to your RCON server at least once before it will attempt reconnection.

RCON Passthrough

The RCON adapter will pass any non-Tebex commands to the game server’s RCON, if connected. A Tebex command is always prefixed with tebex.

Software Included

Creating an App using the Control Panel

Click the Deploy to DigitalOcean button to create a Droplet based on this 1-Click App. If you aren’t logged in, this link will prompt you to log in with your DigitalOcean account.

Creating an App using the API

In addition to creating a Droplet from the Tebex RCON Adapter 1-Click App using the control panel, you can also use the DigitalOcean API. As an example, to create a 4GB Tebex RCON Adapter Droplet in the SFO2 region, you can use the following curl command. You need to either save your API access token) to an environment variable or substitute it in the command below.

curl -X POST -H 'Content-Type: application/json' \
         -H 'Authorization: Bearer '$TOKEN'' -d \
        '{"name":"choose_a_name","region":"sfo2","size":"s-2vcpu-4gb","image": "tebex-tebexrconadapter"}' \
        "https://api.digitalocean.com/v2/droplets"

Getting Started After Deploying Tebex RCON Adapter

1. ssh root@your_droplet_public_ipv4
2. Run ./configure.sh. You will be asked for your secret key, which you can get by logging in at https://creator.tebex.io/game-servers and choosing Connect Game Server. Then, enter your RCON server’s connection info (IP, port, and password).
3. Run ./start.sh to start the RCON Adapter service.