!PlaceholderTebex Banner

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

Place PlaceholderTebex.jar into your /plugins folder.
Start the server once to generate config.yml.
Go to creator.tebex.io → Integrations → API Keys and copy your Private Key.
Paste it in plugins/PlaceholderTebex/config.yml under tebex.secret-key.
Run /ptebex reload and you're done.

⚠ Never share your Private Key publicly. It grants full access to your Tebex store.

❱ Placeholders

Last Donor

%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)

%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)

%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

%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

%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

%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

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

placeholderTebex