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

⚠️ 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

FirstJoinRewards v1.3 – Bedrock Support Update 🎉

This release adds full support for Bedrock Edition players joining through Geyser + Floodgate!

✨ 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! 💚

🛠️ 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!

🆕 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:

    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!

🎉 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 ❤️