# TebexStats
Pulls your Tebex payment data into the game. One command for revenue, top packages, top spenders, creator codes, and a live payment feed — without opening a browser.
---
## What it does
`/ts` — overview dashboard: today / week / month revenue, refund count, average order, top packages
`/ts today` `/ts week` `/ts month` — period breakdown with gross/net, sale counts, top gateways
`/ts packages` — ranked by sales count and by revenue
`/ts spenders` — top spenders by lifetime total
`/ts creators` — creator code usage
`/ts recent [n]` — last N payments with player, package, amount, timestamp, status
Live notifications — players with `tebexstats.notify` get an in-game message + sound when a new payment comes in. New payment detection is deduped so you don't get spammed on restart.
`/ts refresh` — force-pull from Tebex on demand
---
## Setup
1. Drop the jar in `/plugins`
2. Start the server
3. Add your Tebex secret key to `config.yml` (`creator.tebex.io → Game Servers → Plugin Secret Key`)
4. Restart or run `/ts refresh`
No webhooks, no database, no open ports. Just HTTPS to plugin.tebex.io.
---
## Notes
Tebex's Plugin API returns up to 100 payments per call. "All-time" figures in the dashboard cover that window, not your full store history. For high-volume stores, this is approximate. The config has a `fetch-limit` option if you need to reduce it.
Minimum refresh interval is 5 minutes to stay within Tebex rate limits. The plugin enforces this — setting it lower has no effect.
---
## Requirements
- Paper 1.21+
- Java 21
- A Tebex store with a secret key
No other plugins needed.