# Minecraft: Java Edition

Tebex supports seamless integration with the most popular Minecraft server platforms via dedicated plugins. These integrations allow automated command execution, player-specific package fulfillment, and robust monetization for server operators.

***

### Supported Platforms

Official plugins are provided for the following server platforms:

1. [Bukkit](https://bukkit.org/)
2. [Spigot](https://www.spigotmc.org/)
3. [PaperSpigot](https://papermc.io/)
4. [Sponge](https://www.spongepowered.org/)
5. [Bungeecord](https://www.spigotmc.org/wiki/bungeecord/)
6. [Velocity](https://papermc.io/software/velocity)
7. [Fabric](https://fabricmc.net/)

> ⚠️ **Note**: Plugins previously branded as "Buycraft" are deprecated and not supported. Use only the official Tebex plugins.

We recommend using the **Tebex Plugin** for the most feature-rich integration experience.

***

### Prerequisites

Before proceeding:

* You must have a Minecraft: Java Edition server running.
* Your Tebex store must be configured for **Minecraft: Java Edition**.
* Access to your server console and file system (via FTP or file manager).

Find your Tebex secret key from: [**Control Panel > Integrations > Game Servers > Edit**](https://creator.tebex.io/game-servers).

***

### Installation Instructions by Platform

#### ▶ Bukkit / Spigot / PaperSpigot

1. Download the plugin from [**Tebex > Plugins > Bukkit**.](https://creator.tebex.io/game-servers)
2. Place the `.jar` file into `/plugins` in your server directory.
3. Start or restart your server.
4. In console, run:

   ```
   /tebex secret YOUR_SECRET_KEY
   ```
5. In-game, run:

   ```
   /tebex info
   ```

   Confirm your store details are displayed.

***

#### ▶ Fabric

1. Download the plugin from [**Tebex > Plugins > Fabric**](https://creator.tebex.io/game-servers).
2. Place the `.jar` file into `/mods` in your server directory.
3. Restart your server.
4. Run in console:

   ```
   /tebex secret YOUR_SECRET_KEY
   ```
5. Run in-game:

   ```
   /tebex info
   ```

***

#### ▶ Sponge *(Legacy Plugin)*

1. Download the Sponge plugin from [**Tebex > Plugins > Sponge**](https://creator.tebex.io/game-servers).
2. Place the `.jar` file in `/plugins`.
3. Restart your server.
4. Run:

   ```
   /tebex secret YOUR_SECRET_KEY
   ```
5. Verify with:

   ```
   /tebex info
   ```

***

#### ▶ BungeeCord

1. Download the plugin from [**Tebex > Plugins > BungeeCord**](https://creator.tebex.io/game-servers).
2. Place the `.jar` into `/plugins` on your BungeeCord proxy.
3. In `/plugins/Tebex/config.yml`, set:

   ```
   server:
     proxy: true
   ```
4. Restart your proxy.
5. Run:

   ```
   /tebex secret YOUR_SECRET_KEY
   ```
6. Confirm setup:

   ```
   /tebex info
   ```

***

#### ▶ Velocity

1. Download the plugin from [**Tebex > Plugins > Velocity**](https://creator.tebex.io/game-servers).
2. Place the `.jar` into `/plugins`.
3. In `/plugins/Tebex/config.yml`, set:

   ```
   server:
     proxy: true
   ```
4. Restart your proxy server.
5. Run:

   ```
   /tebex secret YOUR_SECRET_KEY
   ```
6. Confirm with:

   ```
   /tebex info
   ```

***

### Offline Servers & Geyser Support

#### Minecraft Offline Mode

* Supported. Choose **Minecraft: Offline** when creating your Tebex store.
* Tebex will not verify usernames.

#### Geyser Support (Bedrock → Java Bridge)

* Set your store to **Minecraft: Offline**.
* In `/plugins/Tebex/config.yml`, set:

  ```
  server:
    proxy: true
  ```
* This disables username verification to accommodate Bedrock usernames.

***

### Alternative Integration Methods

If you're using a custom platform or want deeper control:

* **MySQL**: Push Tebex transactions to your database.
* **RCON**: Execute commands remotely without plugins.
* **Webhooks**: Trigger events on purchase, refund, or chargeback.

> 🔗 Refer to our Plugin API Docs for implementation details.

***

### Verification & Troubleshooting

* Use `/tebex info` in-game or console to verify integration.
* Check server logs for `[Tebex] Plugin enabled` confirmation.
* Ensure secret keys are correctly entered with no extra spaces.
* If errors occur, confirm your plugin version matches the server platform.

***

### Compliance Reminder

Be aware of [Minecraft's **EULA**](https://www.minecraft.net/en-us/eula) and monetization guidelines. Tebex is designed to help you stay compliant, but always review Mojang's policies.

***

**You're all set!** Your Minecraft: Java Edition server is now fully integrated with Tebex. Ready to start earning? Create packages and publish your store today!