⭐ What is PlaytimeRewardsLite?
PlaytimeRewardsLite is a clean and efficient plugin that rewards players based on time played on your server.
Just solid playtime tracking, a clear rewards GUI, and fully configurable rewards. Perfect for small and medium servers that want a set-and-forget solution.

✨ Key Features
✔ Playtime-based rewards
✔ /playtime top command Displays a configurable leaderboard of players with the highest total playtime. Supports custom limits from 1 to 50 entries.
✔ Modern GUI with clear reward previews
✔ Multi-language support (EN, ES, FR, DE, IT)
✔ Reward contents preview (players know exactly what they will get)
✔ Optional auto-claim system
✔ Optional global announcements
✔ Reward streak system (Lite-ready)
✔ Highly optimized & lightweight
✔ Clean architecture (future-proof)

Rewards GUI

• Hover over a reward to see:
  • Status (Locked / Available / Claimed)
  • Missing playtime
  • Exact reward contents

⚙ Configuration Highlights

• Fully configurable config.yml
• Multiple rewards with:
  • Required minutes
  • GUI slot & material
  • Commands
  • Custom reward contents text
• Multi-language messages (es, de, fr, it)
• Global placeholders support
• Soft-dependency: PlaceholderAPI (recommended)

Example reward:

silver:
display-name: "<color:#c0c0c0>Silver Explorer</color>"
minutes: 30
material: "IRON_INGOT"
slot: 13
contents:
- "5x Iron Ingots"
- "16x Torches"
- "$200"
commands:
- "give %player% iron_ingot 5"
- "eco give %player% 200"

Commands & Permissions
Commands

Command Description
/playtime Opens the Playtime Rewards GUI
/playtime claim Claims all available rewards
/playtime next Shows information about the next reward
/playtime list Lists all rewards and their status
/playtime streak Displays your current reward streak
/playtime reload Reloads the plugin configuration
/playtime reset <player> Resets a player's playtime and rewards
/playtime give <player> <reward> Forces a reward claim for a player
/playtime top Displays a configurable leaderboard of players with the highest total playtime. Supports custom limits from 1 to 50 entries.

Permissions
Permission Description Default
playtimerewardslite.admin Access to admin commands (reload, reset, give) OP
playtimerewardslite.use Allows players to use /playtime and open the GUI everyone

ℹ️ Note:
All player commands are available by default. Only administrative actions require special permissions.

Aliases

• /pt
• /playt

Console Usage

• Admin commands (reload, reset, give) can be executed from the console.
• Player-only commands will show an informative message if executed from console.

⚠️ Economy commands

PlaytimeRewardsLite does not include a built-in economy system.
If you use commands like eco give, make sure you have a compatible economy plugin installed (e.g. EssentialsX + Vault).

Technical Details

• Session-based playtime calculation
  
• No constant disk writes
  
• Zero console warnings
  
• Clean separation of:
  • GUI
    
  • Rewards logic
    
  • Storage
    
  • Commands

Designed with scalability in mind.

Compatibility

• Paper / Spigot
  
• Minecraft 1.19.4 - 1.21+ / Java 17
  
• Economy plugins supported via commands
  
• Placeholder-ready architecture (future updates)

Why “Lite”?
This plugin focuses on core functionality done right.

‍ Support & Feedback
This plugin is actively maintained. Suggestions and feedback are welcome.