[1.10 - 1.21.*]PlayTime+ – Playtime Rewards & Interactive GUI

⭐ PlayTime+ - Advanced Playtime Rewards & Statistics
Track playtime. Reward players. Build engagement.

A professional Minecraft plugin featuring real-time tracking, automated rewards, competitive leaderboards, and detailed statistics — all without requiring a database.

Core Features
⏱️ Precise Time Tracking
Track player activity with second-by-second accuracy. Real-time GUI updates show progress without closing menus. All data persists across restarts using lightweight YAML storage.

Automated Reward System
Configure unlimited time-based milestones. Rewards are distributed automatically when players reach each tier. Support for items, commands, economy, and permissions.

Smart Reward Queue (Unique)
Rewards never drop on the ground. Players manage a queue of pending rewards claim what they want, delete the rest. Everything persists through logout.

Competitive Leaderboard (v1.1.0)
Top 10 ranking with player heads and medal system (). Updates automatically every 5 minutes. Access via /playtime top or GUI button.

Advanced Statistics (v1.1.0)

• Daily, weekly, and monthly playtime tracking
• 30-day average calculations
• 14-day activity heatmap (GitHub-style)
• 7-day visual graph with color coding
• Progress bars toward weekly/monthly goals

Anti-AFK Protection
Multi-criteria detection (movement, chat, blocks, clicks). Playtime pauses automatically when inactive. Fully configurable or can be disabled.

️ Interface
Modern GUI with live updates:

• Total Playtime – Real-time second counter
• Statistics – Access detailed analytics
• Next Milestone – Countdown to next reward
• Progress Bar – Dynamic color-coded completion
• Leaderboard – View top 10 players
• Rewards – Manage pending items
• Profile – Coming in v1.2.0

All menus are protected items cannot be taken or moved.

Statistics Breakdown
Today - Time played today (resets at midnight)
This Week - Weekly total with 10-hour goal tracker
This Month - Monthly total with 50-hour goal tracker
Average - Daily average over last 30 days
Calendar - 14-day activity heatmap with color intensity
Graph - 7-day bar chart showing daily trends

Commands
/playtime Open main GUI
/playtime top View leaderboard
/playtime reset Reset player data (admin)
/playtime reload Reload configuration (admin)
Aliases: /pt /ptime

⚙️ Configuration
Fully customizable via config.yml:

yaml
# Tracking precision (1 = every second)
tracking.interval: 1

# AFK detection
anti-afk:
enabled: true
threshold: 300 # 5 minutes

# Example milestone
milestones:
30min:
time: 1800
display-name: "30 Minutes"
rewards:
- "give %player% diamond 5"
- "eco give %player% 500"

# Customize all messages and colors
messages:
milestone-reached: "&6&l★ REWARD UNLOCKED! ★"
```

Add unlimited milestones with any rewards you want.

---

Compatibility
**Minecraft Versions:** 1.8.8 – 1.20+
**Server Software:** Spigot, Paper, Purpur
**Java Version:** 8+
**Dependencies:** None required

**Optional Integrations:**
- Vault (economy)
- LuckPerms (permissions/ranks)
- Crate plugins (any)
- PlaceholderAPI (planned)

One JAR works across all versions thanks to XSeries.

---

Data Storage
```
plugins/PlayTimePlus/
├── config.yml Configuration file
├── playerdata/ Individual player data
│ └── <UUID>.yml Time, stats, milestones
└── rewards/ Pending reward queues
└── <UUID>.yml Unclaimed items
```

Human-readable YAML format. No database setup required.

Security

✅ Protected GUIs – No item theft or duplication
✅ UUID-based – Survives name changes
✅ Permission system – Strict access control
✅ Anti-exploit – Rewards can't be claimed twice
✅ Data validation – All inputs verified

---

Permissions

playtimeplus.use Access main features (default: true)
playtimeplus.admin Admin commands (default: op)
Version 1.1.0 Highlights
✨ Competitive leaderboard with top 10 ranking
✨ Advanced statistics dashboard
✨ GitHub-style 14-day activity calendar
✨ 7-day visual progress graph
✨ Daily, weekly, monthly time tracking
✨ Automatic average calculations
✨ Enhanced GUI with 7 interactive zones
✨ Auto-refreshing leaderboard (every 5 minutes)

Perfect For

• Survival Reward loyal players
• Factions Encourage server activity
• Skyblock Time-based progression
• Minigames Loyalty bonuses
• Roleplay Playtime salary system

Quick Start
bash
1. Download PlayTimePlus-1.1.0.jar
2. Drop into /plugins/ folder
3. Restart server
4. Configure rewards in config.yml
5. Players use /playtime
Setup takes less than 5 minutes.

Support
Discord: https://discord.gg/hbBmvhxcjd

Get help with installation, configuration, and feature requests.
Report bugs and suggest improvements.

What's Included

• Complete source code documentation
• Example configurations (test & production)
• Quickstart guide
• FAQ document
• Build scripts

Why PlayTime+?
Feature PlayTime+ Others
Real-time GUI updates ✅ ❌
Pending reward queue ✅ ❌
Leaderboard system ✅ ❌
Advanced statistics ✅ ❌
Activity calendar ✅ ❌
No database needed ✅ ❌
Multi-version support ✅ ⚠️
Zero lag guarantee ✅ ⚠️