🎉 FirstJoinRewards – Reward Players for Welcoming Newcomers!

FirstJoinRewards is a lightweight, fully configurable Minecraft plugin that rewards players for welcoming newcomers. Now with Top Welcomers GUI, PlaceholderAPI support, and admin controls!

Supports both Java and Bedrock players thanks to Geyser + Floodgate integration!

✨ Features

👋 Welcome System

• Detects when a player joins for the first time
• The first player to say the correct welcome message (e.g. hej Steve) receives a reward
• Works with Bedrock player names like *Steve_, ._Alex, etc.
• Configurable timeout (default: 30 seconds)

🎁 Rewards

• Command rewards (e.g. give money, permissions)
• Item rewards (e.g. diamonds, XP bottles)
• Combo rewards for milestones (50, 100, 150, 200+ welcomes)

🏆 Top Welcomers System (NEW!)

• Beautiful GUI with player heads podium
• Top 3 welcomers displayed with gold/silver/bronze styling
• Your personal stats button
• Fully configurable in gui.yml

🔌 PlaceholderAPI Integration (NEW!)

Use these placeholders in other plugins:

• %fjr_welcomes% - Player's total welcomes
• %fjr_rank% - Player's rank
• %fjr_top_1_name% / %fjr_top_1_count% - Top 1 player
• %fjr_top_2_name% / %fjr_top_2_count% - Top 2 player
• %fjr_top_3_name% / %fjr_top_3_count% - Top 3 player
• ... up to %fjr_top_10%
• %fjr_total_welcomes% - Total server welcomes
• %fjr_total_players% - Total welcomed players

Bonus: Use placeholders from OTHER plugins in FJR messages!

🛠️ Admin Commands (NEW!)

• /fjr admin reset <player> - Reset player's welcomes
• /fjr admin set <player> <count> - Set welcome count
• /fjr admin add <player> <count> - Add welcomes
• /fjr admin remove <player> <count> - Remove welcomes
• /fjr admin resetall - Reset ALL statistics

🎨 Customization

• Full MiniMessage support (gradients, hex colors)
• Legacy color codes (&a, &#00ffcc)
• Separate language files (messages_en.yml, messages_pl.yml)
• Configurable GUI (gui.yml)
• Sound effects and title notifications

⚡ Technical

• Paper/Purpur 1.21+ optimized
• Adventure API for modern text handling
• Lightweight SQLite database
• Async database operations
• No external dependencies required

📋 Commands

| Command | Description | Permission |
|---------|-------------|------------|
| /fjr | Show plugin version | fjr.version |
| /fjr help | Show help | - |
| /fjr reload | Reload configuration | fjr.admin |
| /fjr top | Open Top Welcomers GUI | fjr.top |
| /fjr stats [player] | View welcome statistics | fjr.stats |
| /fjr admin | Admin commands | fjr.admin |

🔌 Soft Dependencies

• PlaceholderAPI - For placeholder support
• Floodgate - For Bedrock player detection

💡 Why Use This Plugin?

• Builds a warm and welcoming player community
• Encourages kindness and fun interaction
• Adds a social layer to your server experience
• Easy to configure, powerful in effect

🧑‍💻 Developed with ❤️ by NullaretH