PlaytimeEconomy
通过智能加成、挂机检测和精美的游戏内 GUI,仅因玩家在线游玩就给予金钱奖励。
PlaytimeEconomy 与 LuckPerms 和 Vault 无缝集成,根据玩家的权限组、在线时长以及获得的任何加成,为每位玩家提供稳定的收入。空闲玩家会通过 EssentialsX 的 AFK(挂机)检测被自动跳过——只奖励真正的活跃参与。
功能
- 基于权限组的奖励 - 每个 LuckPerms 组都有各自可配置的基础奖励金额。
- 权限组乘数 - 更高级别的权限组会在其基础之上获得额外的奖励乘数。
- 星期几加成 - 设置周末或工作日的乘数以在特定日期提升活跃度。
- 权限加成 - 通过简单的权限节点授予玩家自定义乘数(非常适合捐赠者特权或投票奖励)。
- 在线时长连击加成 - 玩家在不挂机的情况下在线越久,其乘数越高——奖励忠诚度和真实参与度。
- AFK 检测 - 与 EssentialsX 集成,在玩家挂机时暂停奖励。提供可配置的绕过权限。
- 游戏内 GUI - 一个简洁、高品质的 GUI 让玩家查看自己的统计数据、当前激活的加成、连击进度和下一次奖励——无需使用命令。
- 管理面板 - 管理员可以直接在游戏中重新加载配置、强制触发奖励周期、发放金钱以及重置玩家数据。
- 完全可配置的消息 - 所有消息均支持 MiniMessage 格式——包括渐变、悬停事件等。
- 按玩家存储的数据 - 玩家统计数据本地保存,并在重启后持久化。
依赖项
| 依赖项 |
类型 |
备注 |
| Paper |
必需 |
1.21 或更高版本 |
| Vault |
必需 |
任何兼容 Vault 的经济插件(例如 EssentialsX Economy、CMI) |
| LuckPerms |
必需 |
用于权限组检测 |
| EssentialsX |
可选 |
用于 AFK 检测 — 如果未安装请在配置中禁用 |
安装
- 将
PlaytimeEconomy.jar 放入 /plugins 文件夹。
- 确保已安装 Vault、LuckPerms 和一个兼容 Vault 的经济插件。
- (可选) 安装 EssentialsX 以启用 AFK 检测。
- 启动服务器——默认配置会自动生成。
- 编辑
plugins/PlaytimeEconomy/config.yml 和 messages.yml 以满足您的需求。
- 运行
/pteadmin reload 即可应用更改而无需重启服务器。
命令
| 命令 |
权限 |
描述 |
/pte gui |
playtimeeconomy.use |
打开主 GUI |
/pte stats |
playtimeeconomy.use |
在聊天中查看你的统计数据 |
/pte boosts |
playtimeeconomy.use |
查看你当前激活的加成 |
/pte help |
playtimeeconomy.use |
显示帮助菜单 |
/pteadmin reload |
playtimeeconomy.admin |
重新加载配置和消息 |
/pteadmin give <player> <amount> |
playtimeeconomy.admin |
向玩家发放金钱 |
/pteadmin reset <player> |
playtimeeconomy.admin |
重置玩家的收益数据 |
/pteadmin forcereward |
playtimeeconomy.admin |
立即触发奖励周期 |
/pteadmin gui |
playtimeeconomy.admin |
打开管理员面板 GUI |
权限
| 权限 |
默认值 |
描述 |
playtimeeconomy.use |
所有人 |
使用 /pte 命令 |
playtimeeconomy.admin |
OP |
使用 /pteadmin 命令 |
playtimeeconomy.bypass.afk |
无 |
在挂机状态下仍获得奖励 |
playtimeeconomy.boost.small |
无 |
授予 ×1.25 的权限加成 |
playtimeeconomy.boost.medium |
无 |
授予 ×1.50 的权限加成 |
playtimeeconomy.boost.large |
无 |
授予 ×2.00 的权限加成 |
您可以在 config.yml 的 permission-boosts 部分添加任何自定义权限。
配置概览
settings:
reward-interval: 300 # 每次奖励发放之间的间隔秒数
afk-check: true # 跳过挂机玩家(需要 EssentialsX)
min-online-seconds: 60 # 本次会话中获得首次奖励前需在线的秒数
currency-symbol: "$" # 在消息和 GUI 中显示的货币符号
broadcast-reward: false # 在全局聊天中广播奖励
groups:
default:
display-name: "Default"
base-reward: 10.0
vip:
display-name: "VIP"
base-reward: 25.0
# 根据需要添加任意数量的组...
rank-boosts:
enabled: true
groups:
vip: 1.10 # VIP 玩家在基础之上额外获得 10%
day-boosts:
enabled: true
days:
SATURDAY: 2.00 # 周六奖励翻倍
SUNDAY: 1.75
permission-boosts:
enabled: true
boosts:
playtimeeconomy.boost.small: 1.25
playtimeeconomy.boost.large: 2.00
my.custom.permission: 1.60 # 任何权限均可在此处使用
streak-boosts:
enabled: true
milestones:
30: 1.10 # 在线 30 分钟 → +10%
60: 1.25
120: 1.50
240: 2.00 # 在线 4 小时 → 乘数翻倍
乘数叠加方式
所有激活的加成均采用 加法加成 系统组合:
Total = 1.0 + (rank_bonus) + (day_bonus) + (perm_bonus) + (streak_bonus)
示例: 周六在线 90 分钟的 VIP 玩家:
- 权限组加成:×1.10 -> +0.10
- 星期加成:×2.00 -> +1.00
- 连击加成(60 分钟档):×1.25 -> +0.25
- 总计:×2.35
PlaytimeEconomy
Reward your players with money just for playing with smart boosts, AFK detection, and a gorgeous in-game GUI.
PlaytimeEconomy integrates seamlessly with LuckPerms and Vault to give every player a steady income based on their rank, how long they've been online, and any boosts they've earned. Idle players are automatically skipped via EssentialsX AFK detection — rewarding genuine engagement.
Features
- Rank-based rewards - Each LuckPerms group gets its own configurable base reward amount.
- Rank multipliers - Higher ranks receive an additional reward multiplier on top of their base.
- Day-of-week boosts - Set weekend or weekday multipliers to spike activity on specific days.
- Permission boosts - Grant players custom multipliers through simple permission nodes (great for donor perks or vote rewards).
- Playtime streak boosts - The longer a player stays online without going AFK, the higher their multiplier climbs - rewarding loyalty and real engagement.
- AFK detection - Integrates with EssentialsX to pause rewards while a player is AFK. Configurable bypass permission available.
- In-game GUI - A clean, premium-quality GUI lets players view their stats, active boosts, streak progress, and next reward - no commands needed.
- Admin panel - Admins can reload the config, force a reward cycle, give money, and reset player data all from within the game.
- Fully configurable messages - Every message supports MiniMessage formatting - gradients, hover events, and more.
- Per-player data storage - Player statistics are saved locally and persist across restarts.
Requirements
| Dependency |
Type |
Notes |
| Paper |
Required |
1.21 or later |
| Vault |
Required |
Any Vault-compatible economy plugin (e.g. EssentialsX Economy, CMI) |
| LuckPerms |
Required |
Group detection |
| EssentialsX |
Optional |
AFK detection — disable in config if not installed |
Installation
- Drop
PlaytimeEconomy.jar into your /plugins folder.
- Make sure Vault, LuckPerms, and a Vault economy plugin are installed.
- (Optional) Install EssentialsX if you want AFK detection.
- Start the server - the default config is generated automatically.
- Edit
plugins/PlaytimeEconomy/config.yml and messages.yml to your liking.
- Run
/pteadmin reload to apply changes without a restart.
Commands
| Command |
Permission |
Description |
/pte gui |
playtimeeconomy.use |
Open the main GUI |
/pte stats |
playtimeeconomy.use |
View your stats in chat |
/pte boosts |
playtimeeconomy.use |
View your active boosts |
/pte help |
playtimeeconomy.use |
Show the help menu |
/pteadmin reload |
playtimeeconomy.admin |
Reload config & messages |
/pteadmin give <player> <amount> |
playtimeeconomy.admin |
Give money to a player |
/pteadmin reset <player> |
playtimeeconomy.admin |
Reset a player's earnings data |
/pteadmin forcereward |
playtimeeconomy.admin |
Immediately trigger a reward cycle |
/pteadmin gui |
playtimeeconomy.admin |
Open the admin panel GUI |
Permissions
| Permission |
Default |
Description |
playtimeeconomy.use |
Everyone |
Use the /pte command |
playtimeeconomy.admin |
OP |
Use the /pteadmin command |
playtimeeconomy.bypass.afk |
Nobody |
Receive rewards while AFK |
playtimeeconomy.boost.small |
Nobody |
Grant a ×1.25 permission boost |
playtimeeconomy.boost.medium |
Nobody |
Grant a ×1.50 permission boost |
playtimeeconomy.boost.large |
Nobody |
Grant a ×2.00 permission boost |
You can add any custom permission to the permission-boosts section in config.yml.
Configuration Overview
settings:
reward-interval: 300 # Seconds between each reward payout
afk-check: true # Skip AFK players (requires EssentialsX)
min-online-seconds: 60 # Seconds online before first reward this session
currency-symbol: "$" # Display symbol in messages and GUI
broadcast-reward: false # Announce rewards in global chat
groups:
default:
display-name: "Default"
base-reward: 10.0
vip:
display-name: "VIP"
base-reward: 25.0
# Add as many groups as you need...
rank-boosts:
enabled: true
groups:
vip: 1.10 # VIP players earn an extra 10% on top of their base
day-boosts:
enabled: true
days:
SATURDAY: 2.00 # Double rewards on Saturday
SUNDAY: 1.75
permission-boosts:
enabled: true
boosts:
playtimeeconomy.boost.small: 1.25
playtimeeconomy.boost.large: 2.00
my.custom.permission: 1.60 # Any permission works here
streak-boosts:
enabled: true
milestones:
30: 1.10 # 30 minutes online → +10%
60: 1.25
120: 1.50
240: 2.00 # 4 hours online → double multiplier
How Multipliers Stack
All active boosts are combined using an additive bonus system:
Total = 1.0 + (rank_bonus) + (day_bonus) + (perm_bonus) + (streak_bonus)
Example: A VIP player on Saturday with a streak of 90 minutes:
- Rank boost: ×1.10 -> +0.10
- Day boost: ×2.00 -> +1.00
- Streak boost (60m tier): ×1.25 -> +0.25
- Total: ×2.35
评论 0
登录后参与评分
还没有评论,来抢沙发吧