# PlaytimeEconomy<\/p>\n
**Reward your players with money just for playing with smart boosts, AFK detection, and a gorgeous in-game GUI.**<\/p>\n
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 \u2014 rewarding genuine engagement.<\/p>\n
—<\/p>\n
## Features<\/p>\n
– **Rank-based rewards** – Each LuckPerms group gets its own configurable base reward amount.
\n– **Rank multipliers** – Higher ranks receive an additional reward multiplier on top of their base.
\n– **Day-of-week boosts** – Set weekend or weekday multipliers to spike activity on specific days.
\n– **Permission boosts** – Grant players custom multipliers through simple permission nodes (great for donor perks or vote rewards).
\n– **Playtime streak boosts** – The longer a player stays online without going AFK, the higher their multiplier climbs – rewarding loyalty and real engagement.
\n– **AFK detection** – Integrates with EssentialsX to pause rewards while a player is AFK. Configurable bypass permission available.
\n– **In-game GUI** – A clean, premium-quality GUI lets players view their stats, active boosts, streak progress, and next reward – no commands needed.
\n– **Admin panel** – Admins can reload the config, force a reward cycle, give money, and reset player data all from within the game.
\n– **Fully configurable messages** – Every message supports MiniMessage formatting – gradients, hover events, and more.
\n– **Per-player data storage** – Player statistics are saved locally and persist across restarts.<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
| Dependency | Type | Notes |
\n|————–|———-|————————————|
\n| Paper | Required | 1.21 or later |
\n| Vault | Required | Any Vault-compatible economy plugin (e.g. EssentialsX Economy, CMI) |
\n| LuckPerms | Required | Group detection |
\n| EssentialsX | Optional | AFK detection \u2014 disable in config if not installed |<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Drop `PlaytimeEconomy.jar` into your `\/plugins` folder.
\n2. Make sure **Vault**, **LuckPerms**, and a Vault economy plugin are installed.
\n3. *(Optional)* Install **EssentialsX** if you want AFK detection.
\n4. Start the server – the default config is generated automatically.
\n5. Edit `plugins\/PlaytimeEconomy\/config.yml` and `messages.yml` to your liking.
\n6. Run `\/pteadmin reload` to apply changes without a restart.<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Permission | Description | —<\/p>\n ## Permissions<\/p>\n | Permission | Default | Description | > You can add any custom permission to the `permission-boosts` section in `config.yml`.<\/p>\n —<\/p>\n ## Configuration Overview<\/p>\n “`yaml groups: rank-boosts: day-boosts: permission-boosts: streak-boosts: ### How Multipliers Stack<\/p>\n All active boosts are combined using an **additive bonus** system:<\/p>\n “` **Example:** A VIP player on Saturday with a streak of 90 minutes: —<\/p>\n","protected":false},"excerpt":{"rendered":" Reward your players with money just for playing.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"playtimeeconomy","_minecraft_project_id":"Jv9bM9RF","_minecraft_author":"F02K","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":32,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"playtimeeconomy.zip","_minecraft_size_bytes":64748,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:57:43.837156Z","_minecraft_date_created":"2026-03-26T20:59:02.929572Z","_minecraft_date_modified":"2026-03-26T02:58:58.975735Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/playtimeeconomy","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-07T05:33:15+00:00","_minecraft_import_hash":"45750a43deb6019c1b2a4a19f3d7c189","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,89,127,128],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-122949","mod","type-mod","status-publish","hentry","mod_category-economy","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|—|—|—|
\n| `\/pte gui` | `playtimeeconomy.use` | Open the main GUI |
\n| `\/pte stats` | `playtimeeconomy.use` | View your stats in chat |
\n| `\/pte boosts` | `playtimeeconomy.use` | View your active boosts |
\n| `\/pte help` | `playtimeeconomy.use` | Show the help menu |
\n| `\/pteadmin reload` | `playtimeeconomy.admin` | Reload config & messages |
\n| `\/pteadmin give
\n| `\/pteadmin reset
\n| `\/pteadmin forcereward` | `playtimeeconomy.admin` | Immediately trigger a reward cycle |
\n| `\/pteadmin gui` | `playtimeeconomy.admin` | Open the admin panel GUI |<\/p>\n
\n|—|—|—|
\n| `playtimeeconomy.use` | Everyone | Use the `\/pte` command |
\n| `playtimeeconomy.admin` | OP | Use the `\/pteadmin` command |
\n| `playtimeeconomy.bypass.afk` | Nobody | Receive rewards while AFK |
\n| `playtimeeconomy.boost.small` | Nobody | Grant a \u00d71.25 permission boost |
\n| `playtimeeconomy.boost.medium` | Nobody | Grant a \u00d71.50 permission boost |
\n| `playtimeeconomy.boost.large` | Nobody | Grant a \u00d72.00 permission boost |<\/p>\n
\nsettings:
\n reward-interval: 300 # Seconds between each reward payout
\n afk-check: true # Skip AFK players (requires EssentialsX)
\n min-online-seconds: 60 # Seconds online before first reward this session
\n currency-symbol: “$” # Display symbol in messages and GUI
\n broadcast-reward: false # Announce rewards in global chat<\/p>\n
\n default:
\n display-name: “Default”
\n base-reward: 10.0
\n vip:
\n display-name: “VIP”
\n base-reward: 25.0
\n # Add as many groups as you need…<\/p>\n
\n enabled: true
\n groups:
\n vip: 1.10 # VIP players earn an extra 10% on top of their base<\/p>\n
\n enabled: true
\n days:
\n SATURDAY: 2.00 # Double rewards on Saturday
\n SUNDAY: 1.75<\/p>\n
\n enabled: true
\n boosts:
\n playtimeeconomy.boost.small: 1.25
\n playtimeeconomy.boost.large: 2.00
\n my.custom.permission: 1.60 # Any permission works here<\/p>\n
\n enabled: true
\n milestones:
\n 30: 1.10 # 30 minutes online \u2192 +10%
\n 60: 1.25
\n 120: 1.50
\n 240: 2.00 # 4 hours online \u2192 double multiplier
\n“`<\/p>\n
\nTotal = 1.0 + (rank_bonus) + (day_bonus) + (perm_bonus) + (streak_bonus)
\n“`<\/p>\n
\n– Rank boost: \u00d71.10 -> +0.10
\n– Day boost: \u00d72.00 -> +1.00
\n– Streak boost (60m tier): \u00d71.25 -> +0.25
\n– **Total: \u00d72.35**<\/p>\n