PlayTimePulse v1.0.4

## Version 1.0.5-SNAPSHOT – Customization & Bug Fixes

### ✨ Major New Feature
- **Config:** `disable-default-reward-information: false` — set to `true` to completely hide default status text and fully customize rewards via lore.

### 🛠️ Important Bug Fix
- Fixed navigation bug that prevented access to rewards on pages beyond the first.
- Corrected *"More Rewards Coming Soon"* display logic.

### 🎮 Gameplay Improvements
- Redesigned levels **20–23** with standard Minecraft rewards:
  - 🍏 Golden Apples
  - 🛡️ Totems of Undying
  - 📖 Mending Books
- No external plugins required for top-tier rewards!

### 🧹 Configuration Cleanup
- Removed redundant `clear-default-rewards` parameter.
- Fixed formatting issues in the default config file.

**Summary:**  
Perfect for server owners who want **complete control** over their reward system!

# 🌟 [color=#ffd700][b]New Features[/b][/color]

## ⏱️ [color=#ffcc66][b]Real-time Tracking[/b][/color]
- **Second-by-Second Updates** – Playtime now updates every second instead of every minute for ultra-precise tracking  
- **Enhanced Accuracy** – More accurate playtime measurement for fair reward distribution  

## 🏆 [color=#ffcc66][b]Leaderboard Support[/b][/color]
- **Top Player Placeholders** – Added placeholders for top 10 players (`%playtime_top_1%` through `%playtime_top_10%`)  
- **Player Position Placeholder** – Added `%playtime_leaderboard_position%` to show a player's rank  
- **Real-time Updates** – Leaderboard updates every second with playtime tracking  

## 🔧 [color=#ffcc66][b]Admin Tools[/b][/color]
- **Reload Command** – Added `/playtime reload` command for administrators to reload configuration without restarting the server  
- **Debug Mode** – Added debug mode with detailed logging for troubleshooting  
  - Enable with `debug: true` in `config.yml`  
  - Toggle with `/playtime debug [true/false]` command  
  - Shows detailed information about reward processing and configuration loading  

## 🌍 [color=#ffcc66][b]Multi-Language Support[/b][/color]
- **8 Languages Supported**:  
  - 🇬🇧 English (`en`) – Default language  
  - 🇨🇳 Chinese (`zh`)  
  - 🇧🇷 Brazilian Portuguese (`pt_BR`)  
  - 🇷🇺 Russian (`ru`)  
  - 🇵🇭 Filipino (`fil`)  
  - 🇩🇪 German (`de`)  
  - 🇫🇷 French (`fr`)  
  - 🇫🇮 Finnish (`fi`)  
- **Language Configuration**:  
  - Set language with `language: [code]` in `config.yml`  
  - Language files automatically copied to plugin directory for customization  
  - Fallback system: Language files → config translations → default English  

---

# 🛠️ [color=#66ccff][b]Improvements[/b][/color]

## ⏱️ Playtime Tracking
- **Second Precision** – All time displays now include seconds for more precise information  
- **Command Enhancements** – `/playtime add` command now supports seconds parameter (`/playtime add <player> <hours>h [<minutes>m] [<seconds>s]`)  

## 📝 Configuration
- **Reduced Console Spam** – Most INFO logs now only appear in debug mode  
- **Better Error Handling** – Improved error messages and warnings for configuration issues  
- **Language Settings** – Added `language` option in `config.yml`  
- **Lore Placeholder Support** – Added support for PlaceholderAPI placeholders in reward item lore  

## 📋 Commands
- **Tab Completion** – Added tab completion support for all commands  
- **Permission Checks** – Enhanced permission validation for admin commands  
- **Seconds Support** – Added seconds parameter support to `/playtime add` command  

## 🎯 Logging
- **Conditional Logging** – Most verbose logs now only appear when debug mode is enabled  
- **Cleaner Console** – Reduced unnecessary INFO messages in normal operation  
- **Debug Mode** – Detailed logging available for troubleshooting configuration issues  

## 🧩 Placeholders
- **Comprehensive Documentation** – Added detailed section in README for all PlaceholderAPI placeholders  
- **Advanced Reward Placeholders** – Documented placeholders for reward status tracking  
- **Leaderboard Placeholders** – Added new leaderboard placeholders for top players and player positions  
- **Usage Examples** – Added practical examples for using placeholders in various contexts  

---

# 🐛 [color=#ff6666][b]Bug Fixes[/b][/color]
- **Configuration Validation** – Fixed potential NullPointerExceptions in configuration loading  
- **Reward Processing** – Improved error handling when loading rewards  
- **Language Loading** – Fixed issues with loading translation files  
- **Placeholder Logic** – Improved logic for determining next reward in progression  

---

# 📖 [color=#99cc99][b]Documentation[/b][/color]
- **README Updates** – Comprehensive documentation of new features  
- **Command List** – Added new admin commands to command table  
- **Configuration Guide** – Updated configuration documentation with language settings  
- **Installation Guide** – Improved installation instructions  
- **PlaceholderAPI Support** – Added comprehensive section with all placeholders and usage examples  
- **Leaderboard Documentation** – Added documentation for new leaderboard placeholders  

---

# 📦 [color=#cc99ff][b]For Server Owners[/b][/color]

## ✨ New Commands
```
/playtime reload              - Reload plugin configuration
/playtime debug [true/false]  - Toggle debug mode
```

## ⚙️ Configuration Changes
```yaml
# New debug setting
debug: false

# New language setting
language: en  # Supports: en, zh, pt_BR, ru, fil, de, fr, fi
```

## 🌍 Language Customization
1. After first run, language files are copied to `plugins/PlayTimePulse/lang/`  
2. Edit the file for your selected language  
3. Use `/playtime reload` to apply changes without restarting  

## 🐛 Debug Mode
Enable detailed logging for troubleshooting:  
```yaml
debug: true
```
Or use the command:  
```
/playtime debug true    # Enable debug mode
/playtime debug false   # Disable debug mode
/playtime debug         # Check current debug mode status
```

## 🧩 PlaceholderAPI Placeholders

**Basic Placeholders**:  
- `%playtime_overall_formatted%` – Total formatted playtime  
- `%playtime_days%`, `%playtime_hours%`, etc. – Time components  

**Advanced Reward Placeholders**:  
- `%playtime_required%` – Time for next unclaimed reward  
- `%playtime_required_{rewardId}%` – Status of specific reward  
- `%playtime_time_left_{rewardId}%` – Time left for specific reward  
- `%playtime_claimable_rewards%` – Number of claimable rewards  

**Leaderboard Placeholders**:  
- `%playtime_top_1%` through `%playtime_top_10%` – Top players in playtime  
- `%playtime_leaderboard_position%` – Player's position in leaderboard  

See README for complete list and usage examples.  

---

# 📈 [color=#999999][b]Previous Versions[/b][/color]
*For changelog of previous versions, see GitHub releases.*

📖 Page Logic Just Got Smarter!

✨ What’s New:
• Detects bad indentation in rewards config 🛠️
• “More Rewards Coming Soon” on last page 🎁
• Clearer, friendlier error messages 😊

💡 Why It’s Cool:
No more mystery bugs! Get helpful console hints to fix issues fast. Setup is smoother than ever! 🚀

🔄 To Update:
Just replace your current .jar with this one and restart your server! 🔧