# How to Set Up a Tebex Store for Your Minecraft Server (/docs/minecraft/setup-tebex)



import { Step, Steps } from 'fumadocs-ui/components/steps';

Tebex (formerly Buycraft) is a webstore platform for Minecraft servers. It lets you sell ranks, items, kits, and other perks that are automatically delivered in-game when a player completes a purchase.

Set Up Tebex [#set-up-tebex]

<Steps>
  <Step>
    Create a Tebex account [#create-a-tebex-account]

    Go to [tebex.io](https://www.tebex.io) and create an account. Select **Minecraft Java** as your game and follow the setup wizard to configure your store name, currency, and theme.
  </Step>

  <Step>
    Install the Tebex plugin [#install-the-tebex-plugin]

    Download the Tebex plugin from [Tebex's plugin page](https://docs.tebex.io/plugin/downloads). In the [XGamingServer Panel](https://panel.xgamingserver.com), click **Files** in the sidebar and upload the JAR to `plugins/`.
  </Step>

  <Step>
    Restart the server [#restart-the-server]

    Open **Console** and restart so the plugin loads.
  </Step>

  <Step>
    Link your server with the secret key [#link-your-server-with-the-secret-key]

    Find your secret key in the Tebex dashboard under **Game Servers**. In **Console** or in-game:

    ```
    /tebex secret <your-secret-key>
    ```
  </Step>

  <Step>
    Verify the connection [#verify-the-connection]

    ```
    /tebex info
    ```

    Confirms the server is linked to your Tebex store.
  </Step>
</Steps>

Create a Rank Package [#create-a-rank-package]

In the Tebex dashboard:

1. Go to **Packages → Create Package**
2. Set a name (e.g., "VIP Rank") and a price
3. Under **Commands**, add the command(s) to run on purchase:

```
lp user {username} parent set vip
```

This uses [LuckPerms](/docs/minecraft/setup-luckperms) to assign the VIP group on purchase.

Common Delivery Commands [#common-delivery-commands]

| Product type          | Example command                         |
| --------------------- | --------------------------------------- |
| Rank (LuckPerms)      | `lp user {username} parent set <group>` |
| Items                 | `give {username} diamond 64`            |
| Money (Vault economy) | `eco give {username} 10000`             |
| Kit                   | `essentials:kit <kitname> {username}`   |

Available Placeholders [#available-placeholders]

| Placeholder  | Description       |
| ------------ | ----------------- |
| `{username}` | Player's username |
| `{uuid}`     | Player's UUID     |
| `{price}`    | Package price     |
| `{currency}` | Store currency    |

Store Customization Options [#store-customization-options]

Tebex offers:

* **Custom domain** — Use your own domain for the store
* **Theme customization** — Match your server's branding
* **Discount codes** — Run sales and promotions
* **Subscription packages** — Recurring monthly ranks
* **Gift cards** — Let players gift purchases

Mojang EULA Note [#mojang-eula-note]

> Follow Mojang's EULA when selling items. You cannot sell gameplay advantages that affect PvP fairness. Cosmetic ranks, pets, and particles are safe. Pay-to-win items risk your server being blacklisted.

Related Guides [#related-guides]

* [Setup LuckPerms](/docs/minecraft/setup-luckperms)
* [Setup EssentialsX](/docs/minecraft/setup-essentialsx)
* [Monetize Your Server](/docs/minecraft/monetize-your-server)
* [Plugin Setup](/docs/minecraft/plugin-setup)