placeholderTebex

插件

· 作者 YesithTK

实时Tebex商店数据作为PlaceholderAPI变量

0 本站下载 0 关注 更新于 4 个月前

最新 1.0.1 · 26.2 · Bukkit / Paper

一键开服(送7天)

PlaceholderTebex

将实时 Tebex 商店数据作为 PlaceholderAPI 变量


❱ 什么是 PlaceholderTebex?

PlaceholderTebex 将你的 Tebex 商店 直接连接到 PlaceholderAPI,以即插即用的占位符形式暴露实时的捐赠数据。

它们可用于全息图、计分板、聊天、菜单、告示牌——任何支持 PlaceholderAPI 的地方。数据通过异步方式获取并缓存在内存中,因此每个占位符都能瞬间解析,且无需每次请求都调用 API。


❱ 功能特性

  • 历史总榜前 10 名捐赠者 — 姓名、总金额、货币、日期和套餐
  • 月度捐赠榜前 10 名 — 按当前月份筛选的相同数据
  • 最近一位捐赠者 — 姓名、金额、日期、时间、套餐和交易 ID
  • 捐赠目标系统 — 进度条、百分比、剩余金额、达成标志
  • 通用统计 — 总捐赠额、交易次数和唯一捐赠者数量(历史总计、月度、每日)
  • 商店信息 — 商店名称、货币和域名
  • 智能异步缓存 — 可配置的刷新间隔,占位符请求无延迟
  • 完全可配置 — 数字格式、日期格式、备用文本、目标金额
  • 兼容 Paper 和 Spigot 1.20.x — 1.21.x

❱ 依赖要求

依赖项 版本 必需
Paper / Spigot 1.20.x — 1.21.x ✔
PlaceholderAPI 2.11.x 或更高 ✔
Tebex Plugin 最新版 ✔
Java 17 或更高 ✔

⚠️ PlaceholderTebex 使用与 Tebex 插件 相同的密钥。请确保已安装并配置好 Tebex 插件,然后将其密钥复制到 PlaceholderTebex/config.yml 中。


❱ 安装步骤

  1. 确保 Tebex 插件 已安装在服务器上并正常运行。
  2. 将 PlaceholderTebex.jar 放入 /plugins 文件夹。
  3. 启动服务器一次以生成 config.yml。
  4. 打开 plugins/Tebex/config.yml 并复制 secret 的值。
  5. 将其粘贴到 plugins/PlaceholderTebex/config.yml 中的 secret-key 下。
  6. 运行 /ptebex reload 即可完成设置。

⚠️ 切勿公开分享你的密钥。它允许完全访问你的 Tebex 商店。


❱ 占位符

最近一位捐赠者

占位符 描述
%tebex_last_donor_name% 最近一位捐赠者的用户名
%tebex_last_donor_amount% 他们支付的金额
%tebex_last_donor_currency% 使用的货币
%tebex_last_donor_date% 捐赠日期
%tebex_last_donor_datetime% 捐赠日期和时间
%tebex_last_donor_package% 购买的套餐
%tebex_last_donor_transaction% 交易 ID

历史总榜捐赠者 (将 N 替换为 1–10)

占位符 描述
%tebex_top_name_N% 第 N 名捐赠者的用户名
%tebex_top_amount_N% 第 N 名捐赠者的累计捐赠总额
%tebex_top_currency_N% 货币
%tebex_top_date_N% 最近一次付款日期
%tebex_top_package_N% 购买的套餐

月度捐赠榜 (将 N 替换为 1–10)

占位符 描述
%tebex_monthly_top_name_N% 月度榜单第 N 名的用户名
%tebex_monthly_top_amount_N% 本月捐赠金额
%tebex_monthly_top_currency_N% 货币
%tebex_monthly_top_date_N% 捐赠日期
%tebex_monthly_top_package_N% 购买的套餐
%tebex_monthly_total% 本月捐赠总额
%tebex_monthly_transactions% 本月交易次数

通用统计

占位符 描述
%tebex_total_donated% 历史累计捐赠总额
%tebex_total_donated_month% 本月捐赠总额
%tebex_total_donated_today% 今日捐赠总额
%tebex_total_transactions% 历史累计交易次数
%tebex_total_transactions_month% 本月交易次数
%tebex_total_transactions_today% 今日交易次数
%tebex_unique_donors% 唯一捐赠者数量

捐赠目标

占位符 描述
%tebex_goal_target% 配置文件中设定的目标金额
%tebex_goal_current% 本月已筹集的金额
%tebex_goal_remaining% 距离达成目标剩余的金额
%tebex_goal_progress% 带符号的百分比 — 例如 73.50%
%tebex_goal_progress_raw% 原始数值 — 例如 73.50
%tebex_goal_bar% 视觉进度条,20 个字符长
%tebex_goal_bar_10% 视觉进度条,10 个字符长
%tebex_goal_reached% true 或 false

商店信息

占位符 描述
%tebex_store_name% 商店名称
%tebex_store_currency% 商店默认货币
%tebex_store_domain% 商店域名

❱ 使用示例

捐赠者排行榜全息图

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

月度目标计分板行

Goal: %tebex_goal_bar_10% %tebex_goal_progress%

最近一位捐赠者告示牌或聊天消息

%tebex_last_donor_name% — $%tebex_last_donor_amount%
%tebex_last_donor_datetime%

❱ 命令

命令 描述 权限
/ptebex reload 重载配置并重启缓存任务 placeholdertebex.admin
/ptebex refresh 强制从 Tebex 获取最新数据 placeholdertebex.admin
/ptebex clearcache 清除所有缓存数据 placeholdertebex.admin
/ptebex info 显示插件状态和实时统计 placeholdertebex.admin

❱ 配置文件

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

cache:
  refresh-interval: 10         # 两次 Tebex API 拉取之间的间隔(分钟)
  payment-history-limit: 100   # 加载的历史支付记录数量

goal:
  enabled: true
  target-amount: 500.0         # 月度捐赠目标金额

占位符:
  无数据:“N/A”
  加载中:“Loading...”
  货币格式:“%.2f”
  日期格式:“dd/MM/yyyy”
  日期时间格式:“dd/MM/yyyy HH:mm”


❱ 即将推出

  • 游戏内查看排名靠前捐赠者的 GUI 命令
  • 按玩家划分的占位符 — 检查特定玩家是否曾进行过捐赠
  • Webhook 支持 — 当有新捐赠时通知 Discord
  • 多商店支持 — 连接多个 Tebex 商店
  • 顶级捐赠者奖励 — 当玩家登上榜首时执行命令
  • 根据包名称自定义排行榜分类

❱ 更新日志

v1.0.1 — 最新版本

  • 修复了玩家名字段 — 现在能从 Tebex API 响应中正确读取 player.name
  • 修复了 JSON 解析 — 现在能处理数组和包裹在 data 中的响应格式
  • 修复了日期解析 — 现在支持多种 Tebex 日期格式
  • 改进了错误日志记录,便于调试
  • 移除了控制台中冗长的调试日志

v1.0.0

  • 初始版本发布

❱ 支持

发现 Bug 或需要帮助?请在 GitHub 上提交 Issue 或在 Discord 上联系我。


❱ 许可证

© 2026 YesithX — 保留所有权利。

本插件免费提供用于个人及服务器用途。未经作者明确书面许可,您不得复制、修改、反编译、转售或重新分发本插件或其源代码的任何部分。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源