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

1. Drop PlaytimeEconomy.jar into your /plugins folder.
2. Make sure Vault, LuckPerms, and a Vault economy plugin are installed.
3. (Optional) Install EssentialsX if you want AFK detection.
4. Start the server - the default config is generated automatically.
5. Edit plugins/PlaytimeEconomy/config.yml and messages.yml to your liking.
6. 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