placeholderTebex

Minecraft 版本： 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2 26.2

平台： bukkit paper purpur spigot

标签： decoration economy social

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

⚠️ 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

All-Time Top Donors (replace N with 1–10)

Monthly Top Donors (replace N with 1–10)

General Statistics

Donation Goal

Store Info

❱ 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

❱ 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.