## Prerequisites
1. PlaceholderAPI plugin
2. DecentHolograms plugin
3. AzLeaderboard plugin (this plugin)
4. Vault plugin (for economy)

## Step 1: Install Required PlaceholderAPI Expansions
Run these commands in-game:
## Step 2: Create AzLeaderboard Leaderboards
Run these commands to create the leaderboards:
## Step 3: Setup DecentHolograms
Copy the hologram files to your DecentHolograms folder:
- `holograms/balance-alltime.yml` → `plugins/DecentHolograms/holograms/`
- `holograms/kills-alltime.yml` → `plugins/DecentHolograms/holograms/`
- `holograms/deaths-alltime.yml` → `plugins/DecentHolograms/holograms/`
- `holograms/playtime-alltime.yml` → `plugins/DecentHolograms/holograms/`

## Step 4: Configure Locations
Edit the location in each hologram file:
Or use the DecentHolograms command:
## Step 5: Reload Plugins
## Step 6: Fix Permissions (if needed)
If leaderboards aren't updating:
## Features
- ✅ Multi-page holograms with left/right click navigation
- ✅ Icon display (Gold Ingot, Diamond Sword, Skull, Clock)
- ✅ Player position tracking shows your current rank
- ✅ Time period switching (All-time, Monthly, Weekly)
- ✅ Sound effects on page navigation
- ✅ Hex color support with beautiful gradients
- ✅ Real-time updates every 20 seconds

## Available Placeholders
Your AzLeaderboard plugin provides these placeholders for external use:

Balance:
- `%azlb_lb_vault_eco_balance_fixed_1_alltime_name%`
- `%azlb_lb_vault_eco_balance_fixed_1_alltime_value%`

Kills:
- `%azlb_lb_statistic_player_kills_1_alltime_name%`
- `%azlb_lb_statistic_player_kills_1_alltime_value%`

Deaths:
- `%azlb_lb_statistic_deaths_1_alltime_name%`
- `%azlb_lb_statistic_deaths_1_alltime_value%`

Playtime:
- `%azlb_lb_statistic_play_one_minute_1_alltime_name%`
- `%azlb_lb_statistic_play_one_minute_1_alltime_value%`

Replace `1` with positions 1-10, and `alltime` with `monthly`/`weekly` as needed.

## Troubleshooting
1. Holograms not showing: Check DecentHolograms is installed and holograms are enabled
2. No data showing: Ensure PlaceholderAPI expansions are downloaded and AzLeaderboard is tracking data
3. Permission errors: Make sure players have `azleaderboard.use` permission
4. Updates not working: Run `/azlb reload` and `/dh reload`

- Automatic Detection: Supports HolographicDisplays, DecentHolograms, CMI, FancyHolograms, Holograms
- ArmorStand Fallback: Works even without hologram plugins
- No Dependencies: No need to add hologram plugins as soft dependencies

- YAML Storage: Human-readable, local files (default)
- SQLite Storage: Lightweight database for better performance with large datasets
- Configurable: Switch storage types in config.yml

- Universal Placeholder Support: Works with ANY PlaceholderAPI placeholder
- Custom Placeholders: `%azlb_lb_<placeholder>_<position>_<type>_name%` and `%azlb_lb_<placeholder>_<position>_<type>_value%`
- Smart Value Parsing: Handles formatted numbers (K, M, B suffixes)

- alltime: Never resets
- daily: Resets every 24h at configurable time
- weekly: Resets weekly on Sunday at configurable time
- monthly: Resets monthly on 1st day at configurable time

- `/azlb add <id> <placeholder> [type]` - Create leaderboard
- `/azlb remove <id>` - Remove leaderboard
- `/azlb reload` - Reload configuration
- `/azlb teleport <id>` - Teleport to hologram
- `/azlb list` - Show all leaderboards

- `azleaderboard.use` - View leaderboards (default: true)
- `azleaderboard.admin` - Admin commands (default: op)

1. Download the latest AzLeaderboard.jar
2. Install PlaceholderAPI (required dependency)
3. Optional: Install any supported hologram plugin for better visuals
4. Place the plugin in your plugins folder
5. Start your server and configure leaderboards in config.yml
6. Use `/azlb add <id> <placeholder>` to create leaderboards

From PlaceholderAPI Wiki

Player Statistics:
- `%statistic_player_kills%` - Player kills
- `%statistic_deaths%` - Player deaths
- `%statistic_play_one_minute%` - Playtime in minutes

Economy (Vault):
- `%vault_eco_balance_fixed%` - Player balance
- `%vault_eco_balance_commas%` - Balance with commas

Custom Plugin Placeholders:
- `%mcmmo_power_level%` - McMMO power level
- `%jobs_total_points%` - Jobs total points
- Any other numeric placeholder!

Create custom placeholders to access leaderboard data:

Examples:
- `%azlb_lb_vault_eco_balance_fixed_1_alltime_name%` - Richest player name
- `%azlb_lb_vault_eco_balance_fixed_1_alltime_value%` - Richest player balance
- `%azlb_lb_statistic_player_kills_3_weekly_name%` - #3 killer this week

Create economy leaderboard:
Create kills leaderboard that resets daily:
Create McMMO power level leaderboard:

To switch from YAML to SQLite:
1. Change `storage.type` to `SQLITE` in config.yml
2. Run `/azlb reload`
3. Data will be automatically migrated

Plugin won't load:
- Ensure PlaceholderAPI is installed and enabled
- Check server logs for specific error messages

Holograms not showing:
- Plugin will use ArmorStand fallback if no hologram plugins detected
- Install HolographicDisplays or DecentHolograms for better visuals

Placeholder not working:
- Verify the placeholder returns numeric values
- Use `/papi parse --null <placeholder>` to test placeholders