In-Game Store

PaperChunk integrates with Tebex to provide a full in-game store for your Minecraft server. Your store is embedded directly on your server's public page — no need for players to leave PaperChunk. All payments go to your Tebex account, and PaperChunk handles command execution automatically.

How It Works

  1. Players visit your store at paperchunk.com/servers/YOUR_SERVER/store
  2. They browse categories, add items to their cart, and enter their Minecraft username
  3. At checkout they are redirected to Tebex for secure payment
  4. After payment, Tebex sends a webhook and PaperChunk executes commands on your server via RCON

Setting Up Tebex (Step-by-Step)

Step 1: Create a Tebex Project

  1. Go to creator.tebex.io and create an account
  2. Enter your Project Name (e.g. your server name)
  3. Choose your Currency
  4. Select "I operate a game server"

Step 2: Select Game

  1. From the game grid, choose Minecraft

Step 3: Select Server Platform

  1. Select Minecraft: Java Edition as server type
  2. In the Geyser Profile section, set prefix to Dot (example: .Notch)

Geyser prefix tells Tebex how Bedrock player names look with Floodgate — they start with a dot.

Step 4: Configure Product Delivery

  1. On the dashboard, find "Configure product delivery"
  2. Click Configure
  3. Choose "Integrate with Webhooks" (not plugin)

PaperChunk handles command execution automatically — no Tebex plugin needed on your server.

Step 5: Setup Webhooks

  1. On the Webhooks page, click Setup Webhooks

Step 6: Copy the Secret Key

  1. At the bottom of the Webhook Endpoints page you'll see a Secret Key
  2. Copy this key
  3. Go to your server's Store settings in PaperChunk and paste it into "Webhook Secret Key", then click Save

Important: Save the webhook secret in PaperChunk BEFORE adding the webhook endpoint in Tebex. Tebex will validate the endpoint when you add it, and the secret must already be configured for validation to pass.

Step 7: Add Webhook Endpoint

  1. Back in Tebex, click Add Endpoint
  2. Paste the webhook URL from your server's Store settings page in PaperChunk (it looks like https://paperchunk.com/api/servers/YOUR_SERVER_ID/tebex/webhook)
  3. Check "Payment Completed" webhook type
  4. Save — Tebex will send a validation request

Step 8: Get API Keys

  1. In the Tebex left menu, go to Integrations → API Keys
  2. Copy the Public Token — paste it in your server's Store settings
  3. If you need a Private Key, click Generate — paste it in Store settings too

Step 9: Create Packages & Go Live

  1. Go to Packages and create items to sell
  2. Add commands to execute (see RCON Command Placeholders below)
  3. Complete the remaining Tebex dashboard steps (store description, contact info, wallet setup, ID verification)
  4. Your store is automatically available at paperchunk.com/servers/YOUR_SERVER/store — a link will appear on your server's public page

RCON Command Placeholders

Commands use these placeholders, which PaperChunk resolves automatically:

Placeholder Description
{username} Player's Minecraft username
{uuid} Player's Minecraft UUID
{quantity} Number purchased

Example commands:

lp user {username} parent set vip
give {username} diamond 64

Player Checkout

Players don't need an account on PaperChunk to make purchases:

  1. Browse the store at your server's public page
  2. Add items to the cart
  3. Enter their Minecraft username and click Checkout
  4. Complete payment on the Tebex checkout page
  5. Commands are executed on your server automatically

Offline Delivery

If a player is offline when a purchase is made, the commands are queued and executed the next time they join the server.