SmartPlaytimeRewards | Configurable Play v1.1.0

Features

• Live playtime tracking
• Persistent playtime storage
• Persistent claimed reward data
• Automatic data saving(NEW!)
• Fully configurable reward milestones
• Command-based reward system
• Manual claim rewards
• Auto-claim rewards
• Configurable rewards GUI(NEW!)
• Configurable GUI title, size, materials, names, lore, buttons, and reward slots(NEW!)
• Paginated rewards menu
• Locked, claimable, and claimed reward states
• Claim All button
• Reward unlock notifications(NEW!)
• Configurable notification sounds
• Permission-based reward visibility(NEW!)
• Permission-based reward claiming(NEW!)
• Playtime leaderboard(NEW!)
• View another player’s playtime(NEW!)
• Admin playtime management commands(NEW!)
• Supports time formats such as 30s, 5m, 1h, and 2d(NEW!)
• Safer config validation
• Lightweight YAML storage
• No database required
• No dependencies required

Commands

Player Commands:

/playtime
Shows your current playtime, claimed rewards, and next reward progress.

/pt
Alias for /playtime.

/playtime rewards
Opens the playtime rewards GUI.

/rewards
Opens the playtime rewards GUI.

/playtimerewards
Opens the playtime rewards GUI.

/playtime claimall
Claims all available manual rewards at once.

/playtime top
Shows the top playtime leaderboard.

/playtime view <player>
View another player’s saved playtime and claimed rewards.

/playtime reload
Reloads the plugin configuration.


Admin Commands:

/playtimeadmin
Shows the admin command help menu.

/playtimeadmin reload
Reloads the plugin configuration.

/playtimeadmin set <player> <time>
Sets a player’s playtime.

/playtimeadmin add <player> <time>
Adds playtime to a player.

/playtimeadmin remove <player> <time>
Removes playtime from a player.

/playtimeadmin reset <player>
Resets a player’s playtime.

/playtimeadmin resetclaims <player>
Resets a player’s claimed rewards.


Admin Time Examples:

30s = 30 seconds
5m = 5 minutes
1h = 1 hour
2d = 2 days
3600 = 3600 seconds


Permissions

smartplaytimerewards.use
Allows players to use the main /playtime command.
Default: true

smartplaytimerewards.rewards
Allows players to open the rewards GUI.
Default: true

smartplaytimerewards.claimall
Allows players to use /playtime claimall and the Claim All GUI button.
Default: true

smartplaytimerewards.top
Allows players to view the playtime leaderboard.
Default: true

smartplaytimerewards.viewothers
Allows viewing another player’s playtime.
Default: op

smartplaytimerewards.admin
Gives access to all SmartPlaytimeRewards commands.
Default: op

smartplaytimerewards.reload
Allows reloading the plugin.
Default: op

smartplaytimerewards.modify
Allows modifying player playtime and claimed rewards.
Default: op


Installation

1. Download the SmartPlaytimeRewards JAR.
2. Place it into your server’s /plugins folder.
3. Start your server.
4. Edit plugins/SmartPlaytimeRewards/config.yml.
5. Run /playtime reload to apply config changes without restarting.
6. Use /playtime or /rewards in-game.

-----------------------------------------------------------------------------------------------------------
Updating from v1.0.0 to v1.1.0

Your existing player progress is compatible with v1.1.0.

To keep all player playtime and claimed rewards:

1. Stop your server.
2. Back up your plugins/SmartPlaytimeRewards folder.
3. Replace the old SmartPlaytimeRewards JAR with the new v1.1.0 JAR.
4. Keep your existing playtime.yml file.
5. Start your server.

Your existing playtime.yml will continue to work and your players will not lose their saved playtime or claimed rewards.

Important:
v1.1.0 includes a much larger config.yml with new GUI, notification, storage, and command options.

If you are updating from v1.0.0, it is recommended to back up your old config.yml, delete it, restart the server to generate the new v1.1.0 config.yml, and then copy your old rewards into the new rewards section.
-----------------------------------------------------------------------------------------------------------

Configuration

Rewards are fully command-driven, so you can use almost any command as a reward.

Example reward:

rewards: 1800: display-name: "&a30 Minutes" auto-claim: false permission: "" hide-if-no-permission: false commands: - "give %player% diamond 1" - "say %player% has claimed the 30 minute playtime reward!"

Auto-claim reward example:

rewards: 3600: display-name: "&b1 Hour Auto Reward" auto-claim: true permission: "" hide-if-no-permission: false commands: - "eco give %player% 500"

Permission-based reward example:

rewards: 7200: display-name: "&dVIP 2 Hour Reward" auto-claim: false permission: "smartplaytimerewards.reward.vip" hide-if-no-permission: true commands: - "give %player% emerald 5"


GUI Configuration

The rewards GUI is configurable through config.yml.

You can customize:

• GUI title
• GUI size
• Reward slots
• Filler item
• Locked reward item
• Claimable reward item
• Claimed reward item
• Info button
• Claim All button
• Close button
• Previous page button
• Next page button
• Item materials
• Item names
• Item lore

Example GUI item:

gui: reward-items: locked: material: RED_STAINED_GLASS_PANE name: "%reward%" lore: - "&c🔒 Locked" - "&7Required: &f%required%" - "&7Remaining: &f%remaining%"


Available Placeholders

%player%
%uuid%
%reward%
%playtime%
%playtime_short%
%playtime_seconds%
%required%
%required_short%
%required_seconds%
%remaining%
%remaining_short%
%remaining_seconds%
%claimed%
%claimed_rewards%
%total_rewards%
%page%
%max_page%


Why choose SmartPlaytimeRewards?

• Lightweight and simple to run
• No database required
• No external dependencies required
• Easy YAML configuration
• Works with any command-based reward setup
• Great for progression-based servers
• Perfect for SMP, Survival, Prison, Economy, RPG, and Skyblock servers
• Clean GUI experience for players
• Useful admin tools for staff
• Persistent data storage
• Safe auto-saving system

Supported Software:

Paper


Supported Versions:

1.21.x