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	✔
Tebex Plugin	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 Tebex plugin 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%

Last donor sign or chat

%tebex_last_donor_name% — $%tebex_last_donor_amount%
%tebex_last_donor_datetime%

---

❱ 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

tebex:
  secret-key: "YOUR_PRIVATE_KEY_HERE"
  base-url: "https://plugin.tebex.io"

cache:
  refresh-interval: 10         # Minutes between Tebex API fetches
  payment-history-limit: 100   # Number of past payments to load

goal:
  enabled: true
  target-amount: 500.0         # Monthly donation target

placeholders:
  no-data: "N/A"
  loading: "Loading..."
  currency-format: "%.2f"
  date-format: "dd/MM/yyyy"
  datetime-format: "dd/MM/yyyy HH:mm"

---

❱ Coming Soon

• GUI command to view top donors in-game
• Per-player placeholder — check if a specific player has ever donated
• Webhook support — notify Discord when a new donation arrives
• Multi-store support — connect more than one Tebex store
• Top donor rewards — run commands when a player reaches the top
• Custom leaderboard categories by package name

---

❱ Changelog

v1.0.1 — Latest

• 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 — now supports multiple Tebex date formats
• Improved error logging for easier debugging
• Removed verbose debug logs from console

v1.0.0

• Initial release

---

❱ Support

Found a bug or need help? Open an issue on GitHub or contact me on Discord.

• Discord — _onlynea
• GitHub — github.com/YesithTK/PlaceholderTebex

---

❱ License

© 2026 YesithX — All Rights Reserved.

This plugin is provided free of charge for personal and server use. You may not copy, modify, decompile, resell, or redistribute this plugin or any part of its source code without explicit written permission from the author.