FirstJoinRewards

# 🎉 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 ` - Reset player's welcomes - `/fjr admin set ` - Set welcome count - `/fjr admin add ` - Add welcomes - `/fjr admin remove ` - Remove welcomes - `/fjr admin resetall` - Reset ALL statistics

### 🎨 Customization - Full MiniMessage support (gradients, hex colors) - Legacy color codes (`&a`, `�ffcc`) - 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 ` | 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