# RCON Adapter

The **Tebex RCON Adapter** is a **self-hosted application** that connects your Tebex webstore to your game server using the **RCON protocol**. It offers a more **robust, reliable, and flexible** alternative to legacy RCON integration methods.

> Use this adapter if:
>
> * Your game supports RCON
> * No Tebex plugin exists for your game
> * You need improved **command tracking**, **player validation**, and **execution feedback**

***

### Key Features

* Reliable **command delivery** via RCON
* Real-time **player online/offline** validation
* Command **success/failure detection**
* Lightweight and **self-hosted**
* Works with or without official Tebex game plugins

The adapter **queries Tebex for pending package commands**, just like an official plugin, then executes those commands via RCON to your game server.

***

### Officially Supported Games

The RCON Adapter is recommended for the following titles to ensure full support:

* **Conan Exiles**
* **Minecraft: Java Edition**
* **Minecraft: Bedrock Edition**
* **Minecraft (Offline/Geyser)**
* **Rust**
* **ARK: Survival Evolved**
* **7 Days To Die**

> You may use the adapter with any game server that supports **RCON**, but functionality is **only guaranteed** for the titles listed above.

***

### Where to Download the RCON Adapter

#### Tebex Control Panel

If RCON Adapter support is enabled for your game, the download option will appear in your [Tebex Control Panel](https://creator.tebex.io/game-servers).

#### 🐙 GitHub Repository

Download the latest releases directly from GitHub: [Tebex-RCONAdapter GitHub Releases](https://github.com/tebexio/Tebex-RconAdapter/releases)

***

### One-Click Deployment via DigitalOcean

Tebex provides a **one-click installer** on DigitalOcean to simplify setup:

 [Tebex RCON Adapter on DigitalOcean Marketplace](https://docs.digitalocean.com/products/marketplace/catalog/tebex-rcon-adapter/)

#### Minimum Requirements:

* 512MB RAM
* 1 CPU core
* Shell access (for setup & restarts)

***

### How to Set Up the RCON Adapter

The adapter can be run from any always-online:

* Virtual Machine (VPS)
* Dedicated Server
* Game server host (same machine)

#### 1. **Download & Run**

* Download the latest `.zip` or `.tar.gz` release.
* Unzip the archive and run the executable:

```bash
bashCopyEdit# Windows
Tebex-RCON.exe

# Linux/macOS
./Tebex-RCON
```

***

#### 2. **Guided Setup Prompts**

The adapter will prompt you for:

* Your **Tebex store secret key**
* Your **RCON host**, **port**, and **password**

> 💡 If you're running the adapter on the same machine as your game server, use `127.0.0.1` as the RCON IP.

#### 3. **Configuration File**

All settings are saved to:

```plaintext
tebex-config.json
```

You can manually edit this file to update credentials or connection settings.

***

#### 4. **Connection Behavior**

* If RCON connection is successful, you’ll enter the live adapter console.
* If connection fails:
  * Run `tebex.setup` in the console to retry configuration.
  * The adapter will attempt automatic reconnection every **60 seconds**.

Each restart reuses saved configuration unless manually modified.

***

### RCON Passthrough Mode

The adapter also functions as an **RCON client**.

#### 🔹 Tebex Commands

All Tebex commands start with:

```plaintext
tebex:
```

These are used internally by the adapter to process store packages.

#### 🔹 Non-Tebex Commands

Any non-prefixed commands entered into the adapter console are forwarded directly to your game server’s RCON connection.

> Use this feature to test commands manually or administer your server through the adapter interface.