FirstGreeter

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! 🌟