TebexStats — In-Game Tebex Revenue Analytics

Paper 1.21 | Zero Dependencies | No Browser Required --- ## The Problem You're running a paid Minecraft server on Tebex. Checking revenue means opening a browser, logging into creator.tebex.io, navigating several pages. You're in the middle of managing your server — you just want to know how much you made today, which package is selling, who your top spender is. TebexStats pulls your Tebex payment data into the game. Every stat you care about, accessible from one command. --- ## What You Get Overview dashboard (/ts) — one command, full picture: <br> ──────────────────────────────────── <br> TebexStats — My SkyBlock Server <br> ──────────────────────────────────── <br> Today £23.97 (4 sales) <br> This Week £142.83 (28 sales) <br> This Month £489.20 (94 sales) <br> All-time* £2,841.77 (531 sales) <br> Refunds/CBs 3 (£28.97 lost) <br> Avg. Order £5.35 <br> ──────────────────────────────────── <br> Top Packages (all-time by sales): <br> 1. VIP Rank ×184 sales <br> 2. MVP Rank ×97 sales <br> 3. $5 Coins ×71 sales <br> ──────────────────────────────────── <br> *Last 100 payments fetched · Refreshed 14:32 24/04 UTC <br> Use /ts <today|week|month|packages|spenders|creators|recent> for detail <br> Period detail (/ts today, /ts week, /ts month): - Gross and net revenue (net deducts refunds/chargebacks) - Sale, refund, and chargeback counts - Average order value for the period - Top packages and gateways for that period Top packages (/ts packages) — ranked by both sales count and revenue Top spenders (/ts spenders) — highest lifetime spend per player Top creator codes (/ts creators) — which influencer codes drive the most purchases Recent feed (/ts recent [n]) — last N payments with player, package, amount, timestamp, and status icons (✔ complete, ↩ refund, ⚠ chargeback) Live payment notifications — when a new purchase completes, admins with tebexstats.notify get an instant in-game message and sound alert, customisable in config. Force refresh (/ts refresh) — pull fresh data from Tebex on demand without waiting for the timer. --- ## Setup 1. Drop TebexStats-1.0.0.jar into /plugins 2. Start the server to generate config.yml 3. Find your Tebex secret key: - Go to creator.tebex.io → Game Servers → your server → Plugin Secret Key 4. Paste it into config.yml: yaml <br> tebex-secret: "your-key-here" <br> 5. Restart or run /ts refresh That's it. No webhooks, no open ports, no database. --- ## Commands | Command | Description | |---|---| | /ts | Full overview dashboard | | /ts today | Today's revenue breakdown | | /ts week | This week's revenue breakdown | | /ts month | This month's revenue breakdown | | /ts packages | Top packages by sales and revenue | | /ts spenders | Top spenders by total spend | | /ts creators | Top creator code usage | | /ts recent [n] | Last N payments (default 10, max 25) | | /ts refresh | Force-refresh from Tebex API | | /ts help | Command list | Aliases: /tebexstats, /tstats --- ## Permissions | Permission | Default | Description | |---|---|---| | tebexstats.view | OP | View all dashboard commands | | tebexstats.reload | OP | Use /ts refresh | | tebexstats.notify | OP | Receive live payment notifications | --- ## Configuration yaml <br> tebex-secret: "YOUR_SECRET_KEY_HERE" <br> # How often to sync with Tebex (minimum 5 to respect rate limits) <br> refresh-interval-minutes: 10 <br> # Max payments fetched per sync (Tebex API max: 100) <br> payments-fetch-limit: 100 <br> notifications: <br> enabled: true <br> format: "&8[&6Tebex&8] &a{player} &7purchased &6{package} &7for &a{amount} {currency}!" <br> sound: ENTITY_PLAYER_LEVELUP <br> display: <br> top-limit: 5 # entries in top-N lists <br> currency-symbol: "" # override Tebex currency symbol <br> # Full colour theme customisation <br> colors: <br> header: "&6" <br> label: "&7" <br> value: "&f" <br> positive: "&a" <br> negative: "&c" <br> accent: "&e" <br> dim: "&8" <br> --- ## Important Notes Data scope: The Tebex Plugin API returns up to 100 recent payments per call. "All-time" figures in the dashboard cover only those 100 payments, not your entire store history. For servers with high sales volume, increase refresh-interval-minutes and accept that long-term totals are approximate. Future versions will support paginated history fetching. Rate limits: Tebex imposes API rate limits. The plugin enforces a minimum 5-minute refresh interval. Running /ts refresh too frequently may trigger a temporary 429 response — the plugin will log this and continue normally on the next scheduled refresh. Currency: TebexStats uses the currency set on your Tebex account. All amounts are displayed in that currency with no conversion. --- ## Why Not Just Use the Tebex Dashboard? You can — and you should for detailed accounting. TebexStats is for quick in-game visibility: knowing at a glance while you're online managing your server whether today is tracking well, whether a promotion is working, who just bought something. It removes the context-switch of opening a browser for routine checks. --- ## Frequently Asked Questions Does TebexStats require the official Tebex plugin to be installed? No. TebexStats uses the Tebex Plugin API directly with your secret key. The official Tebex plugin handles command delivery; TebexStats only reads analytics data. Both can run side by side. Is my secret key secure? Your secret key is stored in config.yml on your server — the same place the official Tebex plugin stores it. It's transmitted over HTTPS to plugin.tebex.io. Standard server security practices apply. Can players see revenue data? Only players with tebexstats.view (default: OP) can use any /ts command. Live notifications go only to players with tebexstats.notify (default: OP). Will this work with BungeeCord or Velocity? TebexStats runs on individual Paper backend servers. Install it on the server where your Tebex secret key is configured. --- ## Building from Source bash <br> git clone <your-repo> <br> cd TebexStats <br> mvn clean package <br> # Output: target/TebexStats-1.0.0.jar <br> Requires Java 21 and Maven. --- ## Changelog v1.0.0 — Initial Release - Overview dashboard with today / week / month / all-time revenue - Gross and net revenue (refunds and chargebacks deducted from net) - Top packages ranked by sales count and by revenue - Top spenders by lifetime spend - Top creator codes by usage count - Top payment gateways - Recent payment feed with status icons and timestamps - Live payment notifications with configurable message and sound - New payment detection — alerts only fire for payments not seen before (no startup spam) - Fully configurable colour theme - Configurable refresh interval (minimum 5 minutes) - Force-refresh command for on-demand sync - Zero external dependencies — pure Java HTTP to plugin.tebex.io - Fully async API calls — zero tick impact