ExtraGreetings

# 🎉 ExtraGreetings A feature-rich greeting plugin for Minecraft servers with **Folia support**, **Adventure API**, **MiniMessage**, and optimized for **Minecraft 1.20.1+**. ## ✨ Features - **🎭 Customizable Join Greetings** - Welcome players with titles, subtitles, action bars, boss bars, particles, sounds, and chat messages - **🎪 First-Time Join Detection** - Different greetings for new players vs returning players - **👑 VIP Support** - Special greetings for VIP players with permissions (now includes quit messages!) - **🚪 Permission-Based Quit Messages** - VIP and regular quit messages with different effects - **⚡ Folia Compatibility** - Full support for Folia's scheduler - **🎨 MiniMessage Support** - Rich text formatting with gradients, colors, and effects - **🔧 PlaceholderAPI Integration** - Support for custom placeholders - **⏰ Cooldown System** - Prevent spam with configurable cooldowns - **🎯 Command Execution** - Run commands on join/quit events - **📊 Built-in Statistics** - Track player joins and active features - **🔄 Live Reload** - Reload configuration without restarting - **🛠️ Config Updater** - Automatic configuration updates with backup system - **🧪 Enhanced Test Command** - Actually test greetings instead of just logging ## 📋 Requirements - **Minecraft 1.20.1+** - **Folia** or **Paper** server - **Java 17+** - **Optional**: PlaceholderAPI for additional placeholders ## ⚙️ Configuration The plugin generates a default configuration file at `plugins/ExtraGreetings/config.yml`. Here's an example: ```yaml # ExtraGreetings Configuration settings: enableJoin: true enableQuit: true cooldownSeconds: 60 debug: false joinDelay: 1 join: firstTime: title: "<gradient:#FF55FF:#55FFFF>Welcome</gradient>" subtitle: "<italic>%player% has joined for the first time!</italic>" actionbar: "<rainbow>Enjoy your stay!</rainbow>" bossbar: enable: true text: "Welcome, %player%!" color: BLUE style: SOLID duration: 10 particles: enable: true effect: "HEART" count: 50 offset: {x: 0.5, y: 1.0, z: 0.5} speed: 0.1 sound: enable: true effect: "ENTITY_PLAYER_LEVELUP" volume: 1.0 pitch: 1.0 message: "<bold><gold></bold> <white>%player%</white> joined for the first time!" commands: - "give %player% diamond 1" - "broadcast &aWelcome new player %player%!" recurring: title: "<yellow>Welcome back!</yellow>" subtitle: "<gray>Enjoy your stay!</gray>" message: "<gray></gray> <white>%player%</white> returned!" vip: enable: true title: "<gradient:#FFD700:#FFA500>VIP</gradient> <gold>Welcome!</gold>" subtitle: "<yellow>%player% the VIP has joined!</yellow>" # ... more VIP settings quit: # VIP quit greeting (for players with extragreetings.vip permission) vip: message: "<bold><gold></gold></bold> <yellow>%player%</yellow> has left the server!" particles: enable: true effect: "DRAGON_BREATH" count: 30 offset: {x: 0.5, y: 1.0, z: 0.5} speed: 0.15 sound: enable: true effect: "ENTITY_ENDER_DRAGON_FLAP" volume: 1.0 pitch: 1.2 commands: - "say VIP %player% has left the server!" # Regular quit greeting regular: message: "<gray></gray> <white>%player%</white> left the server." particles: enable: true effect: "SMOKE_NORMAL" count: 20 offset: {x: 0.0, y: 0.5, z: 0.0} speed: 0.1 sound: enable: true effect: "ENTITY_HORSE_SADDLE" volume: 0.8 pitch: 1.0 commands: ``` ## 🎮 Commands | Command | Description | Permission | |---------|-------------|------------| | `/extragreetings` | Show help menu | `extragreetings.admin` | | `/extragreetings reload` | Reload configuration | `extragreetings.admin` | | `/extragreetings info` | Show plugin information | `extragreetings.admin` | | `/extragreetings stats` | Show plugin statistics | `extragreetings.admin` | | `/extragreetings debug ` | Toggle debug mode | `extragreetings.admin` | | `/extragreetings reset ` | Reset plugin data | `extragreetings.admin` | | `/extragreetings test ` | Test greetings (actually triggers them!) | `extragreetings.admin` | | `/extragreetings update` | Update configuration to latest version | `extragreetings.admin` | **Aliases**: `/eg` ## 🔐 Permissions | Permission | Description | Default | |------------|-------------|---------| | `extragreetings.admin` | Access to admin commands | `op` | | `extragreetings.vip` | Receive VIP greetings (join AND quit) | `false` | | `extragreetings.bypass.cooldown` | Bypass greeting cooldown | `op` | ## 🛠️ Configuration Updater ### ✨ Features: - **Automatic Updates**: Updates configuration on plugin startup - **Comment Preservation**: Maintains all your configuration comments - **Backup System**: Creates timestamped backups before changes - **Manual Upd