FirstGreeter - Reward Players for Welcoming New Members! 🎉

Automatically reward the first player to welcome new joiners to your server.

FirstGreeter creates a welcoming community by rewarding players who greet newcomers first. With persistent leaderboards, customizable rewards, and flexible cooldowns, this plugin encourages positive first impressions.

🎯 Features

✅ First-to-Welcome System - Fastest greeter gets the reward
✅ Customizable Rewards - Execute any command (economy, items, XP, permissions)
✅ Persistent Leaderboards - Track top welcomers across restarts
✅ Smart Detection - Multiple welcome phrases supported
✅ Cooldown System - Per-player and global cooldown options
✅ Admin Tools - Stats, reset, and management commands
✅ Hot Reload - Update config without restart
✅ Multi-Version - Minecraft 1.8 - 1.21+
✅ Lightweight - JSON storage, no database needed

💡 How It Works

1. New player joins server
2. First person to type "welcome [name]" gets rewarded
3. Leaderboard tracks top welcomers
4. Cooldowns prevent spam

Example:
Player joins → "welcome Steve!" → Reward given! 💎

🚀 Quick Start

1. Drop JAR into plugins/ folder
2. Restart server
3. Customize plugins/FirstGreeter/config.yml
4. Use /fg reload to apply changes

🎮 Commands

• /fg leaderboard [page] - View top welcomers
• /fg stats [player] - View statistics
• /fg reload - Reload config
• /fg reset <player/all> - Reset data (admin)

Aliases: /fg, /firstgreeter, /greeter

🔐 Permissions

• firstgreeter.use - Basic commands (default: true)
• firstgreeter.admin - Admin access (default: OP)

🏆 Leaderboard Rankings

🥇 Gold - #1 welcomer
🥈 Silver - #2 welcomer
🥉 Bronze - #3 welcomer
⭐ Yellow - Top 10
💬 White - Everyone else

🔗 Compatibility

Server: PaperMC, Spigot, Purpur
Versions: 1.8 - 1.21+
Java: 8, 11, 16, 17, 21

Works with Vault, LuckPerms, EssentialsX, and all economy plugins!

⚙️ Simple Config

welcome-detection:
  phrases: ["welcome", "wb", "hello", "hi"]
  timeout-seconds: 60

rewards:
  commands:
    - "give %player% diamond 1"
    - "eco give %player% 100"

cooldown:
  per-player-enabled: true
  per-player-seconds: 300

Build a welcoming community today! 🌟