## What's Fixed - Fixed player name field — now correctly reads `player.name` from Tebex API response - Fixed JSON parsing — now handles both array and wrapped `data` response formats - Fixed date parsing — supports multiple Tebex date formats - Improved error logging for easier debugging - Removed verbose debug logs from console --- ## How to Update 1. Stop your server 2. Replace the old JAR with `PlaceholderTebex-1.0.1.jar` 3. Start the server 4. Run `/ptebex reload` --- > ⚠️ Make sure you are using the secret key from `plugins/Tebex/config.yml` and **not** the Private Key from creator.tebex.io. >

 # PlaceholderTebex ### Real-time Tebex store data as PlaceholderAPI variables --- ## ❱ What is PlaceholderTebex? PlaceholderTebex connects your **Tebex store** directly to **PlaceholderAPI**, exposing live donation data as ready-to-use placeholders. Use them in holograms, scoreboards, chat, menus, signs, and anywhere PlaceholderAPI is supported. Data is fetched asynchronously and cached in memory, so every placeholder resolves instantly with **zero per-request API calls**. --- ## ❱ Features - Top 10 all-time donors — name, total amount, currency, date and package - Top 10 monthly donors — same data filtered to the current month - Last donor — name, amount, date, time, package and transaction ID - Donation goal system — progress bar, percentage, remaining amount, reached flag - General stats — total donated, transactions and unique donors (all-time, monthly, daily) - Store info — store name, currency and domain - Smart async cache — configurable refresh interval, no lag on placeholder requests - Fully configurable — number formats, date formats, fallback text, goal target - Compatible with Paper and Spigot 1.20.x — 1.21.x --- ## ❱ Requirements | Dependency | Version | |------------|---------| | Paper / Spigot | 1.20.x — 1.21.x | | PlaceholderAPI | 2.11.x or higher | | Java | 17 or higher | | Tebex Store | Private API Key required | --- ## ❱ Installation 1. Place `PlaceholderTebex.jar` into your `/plugins` folder. 2. Start the server once to generate `config.yml`. 3. Go to `creator.tebex.io` → **Integrations** → **API Keys** and copy your **Private Key**. 4. Paste it in `plugins/PlaceholderTebex/config.yml` under `tebex.secret-key`. 5. Run `/ptebex reload` and you're done. > ⚠ Never share your Private Key publicly. It grants full access to your Tebex store. --- ## ❱ Placeholders ### Last Donor ```text %tebex_last_donor_name% Username of the last donor %tebex_last_donor_amount% Amount they paid %tebex_last_donor_currency% Currency used %tebex_last_donor_date% Date of the donation %tebex_last_donor_datetime% Date and time of the donation %tebex_last_donor_package% Package they purchased %tebex_last_donor_transaction% Transaction ID ``` ### All-Time Top Donors (replace N with 1–10) ```text %tebex_top_name_N% Username of top donor #N %tebex_top_amount_N% Total amount donated by #N %tebex_top_currency_N% Currency %tebex_top_date_N% Date of last payment %tebex_top_package_N% Package purchased ``` ### Monthly Top Donors (replace N with 1–10) ```text %tebex_monthly_top_name_N% Username of monthly top #N %tebex_monthly_top_amount_N% Amount donated this month %tebex_monthly_top_currency_N% Currency %tebex_monthly_top_date_N% Date of donation %tebex_monthly_top_package_N% Package purchased %tebex_monthly_total% Total donated this month %tebex_monthly_transactions% Transaction count this month ``` ### General Statistics ```text %tebex_total_donated% All-time total donated %tebex_total_donated_month% Total donated this month %tebex_total_donated_today% Total donated today %tebex_total_transactions% All-time transaction count %tebex_total_transactions_month% Transactions this month %tebex_total_transactions_today% Transactions today %tebex_unique_donors% Number of unique donors ``` ### Donation Goal ```text %tebex_goal_target% Target amount set in config %tebex_goal_current% Amount raised this month %tebex_goal_remaining% Amount left to reach the goal %tebex_goal_progress% Percentage with symbol (73.50%) %tebex_goal_progress_raw% Raw number (73.50) %tebex_goal_bar% Visual progress bar, 20 characters %tebex_goal_bar_10% Visual progress bar, 10 characters %tebex_goal_reached% true or false ``` ### Store Info ```text %tebex_store_name% Store name %tebex_store_currency% Default store currency %tebex_store_domain% Store domain ``` --- ## ❱ Commands | Command | Description | Permission | |----------|-------------|------------| | `/ptebex reload` | Reload config and restart cache task | `placeholdertebex.admin` | | `/ptebex refresh` | Force fetch fresh data from Tebex | `placeholdertebex.admin` | | `/ptebex clearcache` | Wipe all cached data | `placeholdertebex.admin` | | `/ptebex info` | Show plugin status and live stats | `placeholdertebex.admin` | --- ## ❱ Configuration ```yaml tebex: secret-key: "YOUR_PRIVATE_KEY_HERE" base-url: "https://plugin.tebex.io" cache: refresh-interval: 10 payment-history-limit: 100 goal: enabled: true target-amount: 500.0 placeholders: no-data: "N/A" loading: "Loading..." currency-format: "%.2f" date-format: "dd/MM/yyyy" datetime-format: "dd/MM/yyyy HH:mm" ``` --- ## ❱ Support Found a bug or need help? Open an issue on GitHub or contact me directly on Discord. **Discord:** `_onlynea` **GitHub:** https://github.com/YesithTK/PlaceholderTebex --- *PlaceholderTebex — by YesithX · Free & Open Source*