How to Set Up a Tebex Store for Your Minecraft Server
Create a Tebex webstore to sell ranks, items, and perks on your Minecraft Java server, and link it to your XGamingServer instance with the Tebex plugin.
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
Create a Tebex account
Go to 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.
Install the Tebex plugin
Download the Tebex plugin from Tebex's plugin page. In the XGamingServer Panel, click Files in the sidebar and upload the JAR to plugins/.
Restart the server
Open Console and restart so the plugin loads.
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>Create a Rank Package
In the Tebex dashboard:
- Go to Packages → Create Package
- Set a name (e.g., "VIP Rank") and a price
- Under Commands, add the command(s) to run on purchase:
lp user {username} parent set vipThis uses LuckPerms to assign the VIP group on purchase.
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
| Placeholder | Description |
|---|---|
{username} | Player's username |
{uuid} | Player's UUID |
{price} | Package price |
{currency} | Store currency |
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
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
How is this guide?
How to Install and Use Spark Profiler on Your Minecraft Server
Install Spark to diagnose lag, monitor TPS, generate flame graphs, and identify the exact plugin or mod causing performance issues on your Minecraft Java server.
How to Install Vault on Your Minecraft Server
Install Vault on your Minecraft Java server — the API bridge that connects economy, permissions, and chat plugins together (EssentialsX, LuckPerms, shop plugins).