placeholderTebex

# 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 — 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 | Required | |---|---|:---:| | Paper / Spigot | 1.20.x — 1.21.x | ✔ | | PlaceholderAPI | 2.11.x or higher | ✔ | | (https://www.spigotmc.org/resources/tebex-formerly-buycraft.336/) | Latest | ✔ | | Java | 17 or higher | ✔ | > ⚠️ **PlaceholderTebex** uses the same secret key as the **Tebex plugin**. Make sure the Tebex plugin is installed and configured first, then copy its secret key into `PlaceholderTebex/config.yml`. --- ## ❱ Installation 1. Make sure the (https://www.spigotmc.org/resources/tebex-formerly-buycraft.336/) is already installed and working on your server. 2. Place `PlaceholderTebex.jar` into your `/plugins` folder. 3. Start the server once to generate `config.yml`. 4. Open `plugins/Tebex/config.yml` and copy the value of `secret`. 5. Paste it into `plugins/PlaceholderTebex/config.yml` under `secret-key`. 6. Run `/ptebex reload` and you're done. > ⚠️ Never share your secret key publicly. It grants full access to your Tebex store. --- ## ❱ Placeholders ### Last Donor | Placeholder | Description | |---|---| | `%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)* | Placeholder | Description | |---|---| | `%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)* | Placeholder | Description | |---|---| | `%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 | Placeholder | Description | |---|---| | `%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 | Placeholder | Description | |---|---| | `%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 — e.g. `73.50%` | | `%tebex_goal_progress_raw%` | Raw number — e.g. `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 | Placeholder | Description | |---|---| | `%tebex_store_name%` | Store name | | `%tebex_store_currency%` | Default store currency | | `%tebex_store_domain%` | Store domain | --- ## ❱ Usage Examples **Top donors hologram** ``` &6&l TOP DONORS &e#1 &f%tebex_top_name_1% &7— &a$%tebex_top_amount_1% &e#2 &f%tebex_top_name_2% &7— &a$%tebex_top_amount_2% &e#3 &f%tebex_top_name_3% &7— &a$%tebex_top_amount_3% ``` **Monthly goal scoreboard line** ``` Goal: %tebex_goal_bar_10% %tebex_goal_progress