In-Game Store

PaperChunk integrates with Tebex to provide a full in-game store for your Minecraft server. All payments go directly to your Tebex account — PaperChunk handles command execution automatically.

How It Works

  1. Players visit your store page (hosted by Tebex)
  2. They browse and purchase items (ranks, kits, cosmetics, etc.)
  3. Tebex processes the payment securely
  4. PaperChunk receives a webhook and 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. Copy your store URL from Webstore → General and paste it as External Shop URL in PaperChunk

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

Linking Minecraft Account

Players must link their Minecraft account to purchase items:

  1. Go to Profile on the website
  2. Enter your Minecraft username
  3. Join the server and type the verification command
  4. Once verified, purchases will be delivered to the correct player

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.