Plugins
/Squad Leader Whitelist
Squad Leader Whitelist
The Squad Leader Whitelist plugin tracks players who effectively lead squads and progressively grants them whitelist privileges based on their leadership time, helping to reward and retain skilled squad leaders.
Features
- Tracks squad leadership with minimum member requirements
- Progressive whitelist system based on leadership hours
- Automatic progress decay for inactive players
- Admin group assignment for whitelisted players
- Chat command for players to check progress
- Configurable thresholds and timeframes
Configuration Options
Option | Description | Default | Required |
---|---|---|---|
min_squad_size | Minimum squad members for progress | 5 | No |
hours_to_whitelist | Hours needed for 100% whitelist | 8 | No |
whitelist_duration_days | Days whitelist lasts | 14 | No |
decay_after_hours | Hours before decay starts | 72 | No |
min_players_for_decay | Server players needed for decay | 40 | No |
min_players_for_leadership | Server players needed for progress | 20 | No |
progress_interval_seconds | Progress check frequency | 60 | No |
decay_interval_seconds | Decay application frequency | 3600 | No |
require_unlocked_squad | Only unlocked squads count | true | No |
whitelist_group_name | Admin group name | "squad_leader_whitelist" | No |
wait_on_new_games | Pause after new games | true | No |
wait_time_on_new_game | Delay after new game | 30 | No |
How It Works
- Leadership Tracking: Monitors players leading squads with minimum members
- Progress Accumulation: Awards progress points based on leadership time
- Whitelist Achievement: Grants admin privileges when progress reaches 100%
- Decay System: Reduces progress for inactive players
- Automatic Management: Handles admin group assignments and expirations
Progress System
- Players earn progress when leading squads with 5+ members
- Progress accumulates over time toward the whitelist threshold
- 100% progress grants temporary admin privileges
- Progress decays if players become inactive
- Whitelist status expires after the configured duration
Example Configuration
{ "min_squad_size": 5, "hours_to_whitelist": 10, "whitelist_duration_days": 21, "decay_after_hours": 96, "min_players_for_decay": 50, "min_players_for_leadership": 25, "require_unlocked_squad": true, "whitelist_group_name": "squad_leaders" }
Admin Group Setup
The plugin automatically manages an admin group for whitelisted players. Ensure your server configuration includes:
[Group.squad_leader_whitelist] GroupName=squad_leader_whitelist
Tips
- Adjust
hours_to_whitelist
based on your server's activity level - Use
require_unlocked_squad
to ensure only public squads count - Monitor decay settings to balance rewarding activity vs preventing stagnation
- The chat command
!wl
allows players to check their progress - Consider the whitelist duration to maintain fresh leadership
Built with
Show your support! Star us on GitHub ⭐️