FirstJoinRewards

Reward the first player who welcomes a newcomer with customizable commands or items. Perfect for community engagement!

Автор: NullaretH5642обновлён 21 дек. 2025 г.

ЭкономикаОбщениеУтилиты

Описание

🎉 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

Галерея

Последние версии

Все версии →

release

Top GUI, PlaceholderAPI & Admin Commands [Internal Refactor]

2.0-refactor

21 дек. 2025 г.270Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot

Скачать

Что нового

# FirstJoinRewards v2.0 – Major Update! 🚀 ## ✨ New Features ### 🏆 Top Welcomers GUI - Beautiful inventory GUI with player heads podium - Top 3 players displayed with gold/silver/bronze styling - Personal statistics button - Fully configurable in `gui.yml` - Command: `/fjr top` ### 🔌 PlaceholderAPI Integration - Full PlaceholderAPI support with 10+ placeholders - `%fjr_welcomes%`, `%fjr_rank%`, `%fjr_top_X_name%`, `%fjr_top_X_count%` - `%fjr_total_welcomes%`, `%fjr_total_players%` - Use external placeholders IN your FJR messages! ### 🛠️ Admin Commands - `/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 (dangerous!) ### 🎨 Enhanced Notifications - Title announcements for new players - Configurable sound effects - Full MiniMessage support (gradients, hex colors) ### 📁 Separate Language Files - `messages_en.yml` - English - `messages_pl.yml` - Polish - Easy to add custom languages ## 🔧 Technical Changes - **Migrated to Paper API 1.21.4** (from Spigot) - **Adventure API** for modern text components - **Async database operations** for better performance - **ConcurrentHashMap** for thread-safe session management - Improved SQLite schema with indexes - Tab completion for all commands ## 📋 New Commands | Command | Description | |---------|-------------| | `/fjr help` | Show all commands | | `/fjr top` | Open Top Welcomers GUI | | `/fjr stats [player]` | View statistics | | `/fjr admin ...` | Admin controls | ## ⚠️ Breaking Changes - Config structure changed (backup your old config!) - Messages now in separate files (`messages_en.yml`, `messages_pl.yml`) - Requires **Paper/Purpur 1.21+** (no longer supports Spigot) - Requires **Java 21** ## 🐛 Bug Fixes - Fixed prefix not updating on reload - Fixed session cleanup on plugin disable - Improved Bedrock player name handling --- **Full Changelog:** v1.3 → v2.0

release

FirstJoinRewards v1.3 - Geyser Support!

1.3

5 апр. 2025 г.149Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5paper, spigot

Скачать

Что нового

### FirstJoinRewards v1.3 – Bedrock Support Update 🎉 This release adds full support for Bedrock Edition players joining through Geyser + Floodgate! ![Working with Java and Bedrock players!](https://i.imgur.com/xfb70t9.png) #### ✨ Highlights - Works with Bedrock usernames like `*Steve_` or `._Alex_` - Auto-detects Bedrock players and matches welcome messages - Safer and more flexible welcome logic - Fully backwards compatible with Java-only servers #### ✅ What's New - `PlayerUtil` class with Floodgate integration - Improved regex for matching welcome messages - Proper handling of special characters in names - Plugin shuts down all sessions on disable #### 🔧 Internal Changes - `softdepend: [Floodgate]` added - Uses reflection to support or ignore Floodgate if not installed This update keeps things smooth, reliable, and Bedrock-friendly! 💚

release

V1.2 QuickUpdate for Commands and Bug Fixes

1.2

2 апр. 2025 г.56Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5paper, purpur, spigot

Скачать

Что нового

# 🛠️ FirstJoinRewards v1.2 – Reload Fixes, Prefix Improvements & Permissions ## ✅ What's Fixed & Improved - 🔁 `/fjr reload` now fully reloads: - `config.yml` - `messages.yml` - The `prefix` (previously ignored!) - Active welcome sessions are now properly terminated on reload - 🎨 **Prefix now supports:** - `&` color codes like `&6&l` - HEX colors like `&#00ff00` - You can combine both in one line - 🔐 **Permissions implemented properly:** - `fjr.version` → `/fjr` (shows plugin version) - `fjr.admin` → `/fjr reload` - Commands now validate permissions before execution - 🐛 Bug Fixes: - Missing `endAllSessions()` method – now added - Prefix not updating on reload – fixed - Invalid plugin.yml structure – now includes `name`, `main`, `api-version`, etc. --- ## 🧪 Compatibility - ✅ Works on Minecraft versions **1.21.1 → 1.21.5** - ☕ Requires **Java 17+** --- ## 📦 Plugin Summary - Detects first join - First player to welcome gets a reward - Supports command & item rewards - Combo milestones (50, 100, 150...) - HEX + `&` color support - YAML configuration (PL & EN) - Lightweight: SQLite database - Includes `/fjr` and `/fjr reload` commands --- ❤️ **Plugin by Deveusz** Found a bug? Got an idea? Open an issue or drop feedback!

release

Version 1.1 (Stable Release) #LITTLEchanges

1.1

2 апр. 2025 г.43Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5paper, purpur, spigot

Скачать

Что нового

## 🆕 FirstJoinRewards v1.1 – Multi-message Support 📅 **Release date**: April 2, 2025 👨‍💻 **Author**: Deveusz 💾 **Status**: Stable 📦 **Supports**: Spigot / Paper / Purpur 🎯 **Minecraft**: 1.16 – 1.20+ --- ### 🔄 What's New - ✅ **Support for multiple welcome messages!** - You can now define multiple message formats in `config.yml`: ```yaml message_formats: - "hej %player%" #en: "hey %player%" - "witaj %player%" #en: "welcome %player%" - "siema %player%" #en: "yo %player%" - "miło cię widzieć, %player%" #en: "nice to see you, %player%" - "yo %player%" #en: "yo %player%" - "dobrze, że jesteś %player%" #en: "glad you're here %player%" ``` - 🧠 **Only the first player to welcome gets rewarded** (same as before) - 🙅‍♂️ **Self-welcome detection** (still blocks and notifies) - 🧼 **Improved pattern matching** (safe handling of special characters) - 🧾 Backward-compatible: `message_format` (singular) still works as fallback --- ### 🧩 Plugin Features - 🔔 Detects when a new player joins - 💬 Configurable messages with `%player%` support - 🎁 Rewards via: - Console commands (`eco give %sender% 100`) - In-game items (e.g. DIAMOND x3) - 🧠 Combo rewards (e.g. 50, 100, 150 welcomes) - 🎨 Supports HEX color codes (`&#FF00FF`) - 💾 Uses lightweight SQLite — no MySQL needed - 📂 Easy YAML configuration (PL & EN) - 🔄 Reload with `/fjr reload` --- ❤️ Plugin by **Deveusz** 💬 Found a bug or want to suggest something? Open an issue on discord server or leave a comment!

release

Version 1.0 - SNAPSHOT (Stable Release)

1.0

31 мар. 2025 г.45Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5paper, purpur, spigot

Скачать

Что нового

🎉 Initial stable release of FirstJoinRewards! - 🔔 New player detection with configurable welcome message - 🏆 Only the **first player** to welcome a newcomer gets the reward - 🎁 Rewards support: - Custom console commands - In-game items - 🧠 Combo rewards (50, 100, 150, etc. welcomes) - 💬 Customizable message format (e.g. `hej %player%`) - 📂 YAML files: `config.yml` & `messages.yml` (PL + EN) - 🎨 Full support for HEX colors and color codes - 🧱 SQLite-based storage (no need for MySQL) - ⚙️ Admin command: `/fjr reload` - 🧼 High performance — only runs when needed Plugin by **Deveusz** ❤️