Minecraft plugin Tebex

🔌 About the plugin Tebex

Tebex — is a plugin for Minecraft servers that allows you to connect your server to a Tebex webstore, automatically fulfil purchases and execute server commands defined in your store.

🎯 Purpose

Tebex connects an in‑game server to a Tebex webstore so purchases made on the webstore are delivered in‑game automatically. Tebex solves the manual fulfilment problem for server owners: instead of running commands by hand, Tebex executes configured commands on purchase.

Tebex is built for servers that want a managed monetization solution and integrates with common server platforms (Spigot, Paper, Bungee, Velocity). The plugin is open‑source and maintained by Tebex.

⚙ Main capabilities

• Connects your Minecraft server to a Tebex webstore and authenticates with a secret key.
• Automatic fulfilment: Tebex checks and fulfills purchases on a regular schedule (official README: every two minutes).
• Executes server commands (e.g. give items, add groups) as configured in the Tebex control panel.
• Supports multiple server platforms: Bukkit/Spigot/Paper, BungeeCord and Velocity (commands available may vary by platform).
• Administrative commands for sending links, lookup, banning users from the store, and reporting to Tebex.

🧩 Who it suits

Tebex fits server owners and administrators who:

• run public or private servers and want automated delivery of store purchases;
• use Spigot/Paper or proxy setups (Bungee/Velocity) and need a supported integration;
• prefer managed payment processing and chargeback/fraud protection provided by Tebex's platform.

🏗 Usage examples

• Connect your server by placing the Tebex .jar into plugins/ and run tebex.secret <your-key> to link the store.
• Configure store packages on the Tebex dashboard to run server commands that grant items or ranks. Tebex will execute these commands when the player next appears or on the next fulfilment cycle.
• Use tebex.checkout <packId> <username> to create a payment link from the server (where supported).

⌨️ Commands

Note: The README states "Not all commands are available on all platforms. Proxy servers may have a reduced set of commands." Use tebex.help on your platform to confirm the available commands.

🔐 Permissions

All commands expose a permission node that matches the exact command name (per official README). Example: tebex.help is required to view commands.

(Official README: "All commands have a permission node which matches with the exact command name." The README does not list default permission values.)

⚙ Installation

📥 Installation

• Download the Tebex .jar from the official Releases (GitHub releases or your Tebex control panel).
• Place the .jar into your server's plugins/ folder.
• Restart the server (do not rely on /reload).
• As a server admin run: tebex.secret <your-key> to connect the server to your Tebex store (your secret key is available from the Tebex control panel).

📦 Dependencies

• Official sources (repository README and docs) do not list required third‑party plugin dependencies. The plugin implements Tebex's Plugin API and runs on supported server platforms (Spigot/Paper/Bungee/Velocity).
• If you require additional integrations (chat placeholders, economy plugins), configure those separately — official README does not mandate Vault/PlaceholderAPI/etc.

🧾 Configuration

• The README documents using tebex.secret to provide your store secret key.
• The README and docs describe linking the plugin to your Tebex store; explicit details about generated config filenames or MySQL/SQLite usage are not specified in the plugin README.
• If you need persistent configuration details, check the plugin folder after first run or consult the Tebex control panel for store settings.

🧠 Additional information

• Supported platforms: Bukkit/Spigot/Paper, BungeeCord, Velocity (README).
• Fulfilment frequency: official README states purchases are fulfilled every two minutes.
• Open‑source: repository and releases available on GitHub (GPL‑3.0).
• Environment/build requirements (for building from source): JDK 17 and Gradle 8.2 (README).

⚠ Known limitations / notes

• "Not all commands are available on all platforms. Proxy servers may have a reduced set of commands." — check tebex.help for platform specifics.
• The plugin coordinates with the Tebex cloud service; merchant/payment features are handled by Tebex (web dashboard) rather than local DBs — official docs do not describe local SQL usage.

❓ FAQ

Q1 — How do I connect my server to my Tebex store?
A1 — Put the .jar in plugins/, restart the server, then run tebex.secret <your-key> as an admin (README).

Q2 — How often does Tebex fulfil purchases?
A2 — The official README states purchases are fulfilled every two minutes.

Q3 — Does Tebex require Vault or PlaceholderAPI?
A3 — Official README does not list Vault or PlaceholderAPI as required dependencies. If your store packages use commands needing those systems, configure them separately.

Q4 — Is the plugin compatible with proxy setups (Bungee/Velocity)?
A4 — Yes; README lists Bungee and Velocity support but warns some commands may be reduced on proxy platforms.

🤝 When this plugin is useful

Use Tebex when you want a proven, managed webstore integration that automatically delivers purchases to players and runs server commands via a supported Spigot/Paper/Bungee/Velocity plugin. Tebex centralizes payments and fulfilment without manual command execution.

Sources: official Tebex GitHub repository (tebexio/Tebex-Minecraft) and Tebex Plugin API documentation.