PlayTimePulse v1.0.4

` 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.*