# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.tebex.io/creators/tebex-control-panel/game-servers/rcon-adapter.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.