How to Set Up a Tebex (Buycraft) Store

Tebex, still sometimes called Buycraft after the brand it acquired, is the payment platform that powers the majority of Minecraft server stores. It handles everything from checkout pages to automatic command execution, so when a player buys a rank at 3 AM, LuckPerms grants it without you lifting a finger. This guide walks through the entire setup process from account creation to your first sale.

What Tebex actually does

At its core, Tebex is a bridge between a webstore and your Minecraft server. Players visit your store URL, pick a package (a rank, a crate key, a cosmetic), pay through PayPal, Stripe or another gateway, and Tebex pushes a command to your server plugin. The plugin executes the command, typically a LuckPerms permission grant or an item give, and the player receives their purchase in-game within seconds.

Tebex takes a percentage of each transaction (the rate depends on your plan) and handles payment disputes, invoices, and EU VAT collection. Compared to building your own checkout system, the convenience is well worth the fee.

Creating your Tebex account

Head to tebex.io and register. You will need a valid email address and your server details. During onboarding, Tebex asks for your server name, game (select Minecraft Java or Bedrock), and your expected monthly revenue range. This information determines your initial plan tier, but you can upgrade later as your server grows.

After registration you land on the Tebex dashboard. The left sidebar is your control center, Packages, Webstore, Payments, and Settings are the sections you will use most.

Installing the Tebex plugin on your server

Tebex distributes a server plugin that connects your Minecraft server to their platform. Download it from the Tebex website or find it on SpigotMC under the name "Tebex" (the old "BuycraftX" jar still works but the rebranded version receives updates). Drop the jar into your plugins/ folder and restart the server.

On first boot, the plugin generates a config file and asks for a secret key. Find your secret key in the Tebex dashboard under Settings → Servers. Copy it, then run:

/tebex secret <your-secret-key>

The plugin confirms the link with a success message. From this point on, any purchase on your webstore triggers the associated commands on this server. If you run multiple servers behind a Velocity or BungeeCord proxy, install the plugin on each backend server and link each one with a separate server entry in Tebex.

Creating your first package

Packages are the items players buy. Navigate to Packages in the dashboard and click "Create Package." Fill in:

• Name, what the player sees, e.g., "VIP Rank"
• Price, in your base currency (EUR, USD, GBP, etc.)
• Description, a detailed list of what the player receives. Be specific: "Purple [VIP] prefix, /nick access, 3 extra homes, particle trail selector"
• Type, single purchase (one-time) or subscription (recurring)
• Image, a square icon that displays on the store page

Below the basic details you configure commands. These are the server commands Tebex executes when a purchase completes. For a rank package, you typically need one command:

lp user {username} parent set vip

The {username} placeholder is replaced with the buyer's Minecraft username at execution time. Tebex supports multiple placeholders including {uuid}, {price} and {transaction_id}. You can stack multiple commands per package, useful if a rank also gives a crate key or a cosmetic kit.

You can also configure expiry commands for subscription packages. When a subscription lapses, Tebex runs the expiry command to remove the rank:

lp user {username} parent set default

Organizing your store with categories

A cluttered store page loses sales. Create categories that group related packages together. A standard layout looks like this:

• Ranks, your tier system, cheapest to most expensive
• Crate Keys, single keys, bundles of 5, bundles of 10
• Cosmetics, individual particle trails, chat tags, pets
• Bundles, rank + key combos at a discount

In the dashboard, go to Packages → Categories and create each one. Drag to reorder them. Each category can have its own description and display image.

Payment methods, PayPal, Stripe and more

Tebex supports PayPal, Stripe (credit/debit cards), iDEAL, paysafecard, and cryptocurrency through third-party integrations. At minimum, enable PayPal and Stripe, together they cover the vast majority of players. Set these up under Settings → Payment Gateways. You will need a verified PayPal Business account and a Stripe account. Tebex walks through the OAuth connection for each.

For European servers, iDEAL and Bancontact are popular. For younger players without cards, paysafecard is a prepaid option available at many retail stores. Offering multiple gateways increases your conversion rate because players can pay with whatever method they already have.

Customizing your store theme

The default Tebex store is functional but generic. You can customize the theme under Webstore → Theme. Tebex offers several built-in templates, and you can upload a custom CSS file or build a fully custom storefront using their API. At minimum, upload your server logo, set your brand colors, and write a welcome message for the homepage.

If you own a domain, point a subdomain like store.yourserver.com to your Tebex store. Under Webstore → Custom Domain, add the domain and create a CNAME DNS record pointing to checkout.tebex.io. SSL is handled automatically.

Coupons and gift cards

Coupons drive sales during events. In the dashboard, go to Coupons and create one. You control the discount percentage, the number of uses, the expiry date, and minimum basket value. Run a 20% coupon during holidays or when you hit a player milestone (1,000 unique joins, etc.). Share the code on Discord and in-game announcements.

Gift cards let players buy store credit for friends. Tebex supports this natively, enable it in your store settings. Gift cards are popular around the December holidays and drive revenue from players who want to give something but do not know which rank their friend wants.

Recurring subscriptions

Subscriptions charge players monthly (or at your chosen interval) and provide steady, predictable revenue. Common subscription packages include monthly crate key deliveries, a recurring cosmetic rotation, or a "supporter" status that renews. Configure the billing interval and expiry commands so that when a subscription lapses, the perks are removed cleanly. Players can manage their subscriptions through their Tebex account page.

Analytics and revenue tracking

The Tebex dashboard includes analytics for total revenue, average order value, top-selling packages, and payment method breakdown. Check these monthly to understand what sells and what does not. If a package has zero sales after a month, reconsider its price point or perks. If crate keys outsell ranks, consider adding more crate tiers.

Export your transaction history regularly for your own records and tax reporting. Tebex provides CSV exports under Payments → Transactions.

Common mistakes to avoid

• Forgetting the secret key rotation. If your secret key leaks, anyone can push commands to your server. Rotate it in the dashboard and update the plugin immediately.
• Not testing purchases. Tebex has a sandbox mode. Use it to test every package before going live. A broken command means a paying player does not receive their rank, and that creates a support ticket at best, a chargeback at worst.
• Ignoring mobile layout. A surprising number of players browse your store from their phone. Make sure your theme is responsive and the checkout flow works on small screens.
• No refund policy. State your refund terms clearly on your store page. A visible policy reduces disputes and chargebacks.

For the complete monetization strategy, including what you can legally sell, pricing psychology and chargeback handling, read the server monetization guide. To configure the ranks that Tebex delivers, follow the LuckPerms permissions guide.

Ready to launch? Astroworld Hosting offers NVMe SSD, Pterodactyl panel, and DDoS protection on every plan. See features , plans from €6.39/mo.