ModsJava
PlaceholderTebex
Java mod listed for Minecraft 1.20–26.x. Downloads from the MC Java Mods app on Android.
⬇ Download on SpigotPlaceholderTebex
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 Tebex 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
Code (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
Code (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
Code (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
Code (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
Code (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 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
Code (Text):
%tebex_store_name% Store name
%tebex_store_currency% Default store currency
%tebex_store_domain% Store domain
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
❱ Usage Examples
Top donors hologram
Code (Text):
&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%
Code (Text):
Goal: %tebex_goal_bar_10% %tebex_goal_progress%
Code (Text):
%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
Code (Text):
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 directly 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.
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬
PlaceholderTebex — by YesithX · Free to use · All Rights Reserved
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.20.6, 1.21
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
PlaceholderTebex is a free Minecraft Java mod. Compatible with Minecraft 1.20, 1.20.6, 1.21, 26.1 and newer. Downloaded 44 times (via Spigot). Download it and open it directly in the game.