# \ud83c\udf89 ExtraGreetings<\/p>\n
A feature-rich greeting plugin for Minecraft servers with **Folia support**, **Adventure API**, **MiniMessage**, and optimized for **Minecraft 1.20.1+**.<\/p>\n
## \u2728 Features<\/p>\n
– **\ud83c\udfad Customizable Join Greetings** – Welcome players with titles, subtitles, action bars, boss bars, particles, sounds, and chat messages
\n– **\ud83c\udfaa First-Time Join Detection** – Different greetings for new players vs returning players
\n– **\ud83d\udc51 VIP Support** – Special greetings for VIP players with permissions (now includes quit messages!)
\n– **\ud83d\udeaa Permission-Based Quit Messages** – VIP and regular quit messages with different effects
\n– **\u26a1 Folia Compatibility** – Full support for Folia’s scheduler
\n– **\ud83c\udfa8 MiniMessage Support** – Rich text formatting with gradients, colors, and effects
\n– **\ud83d\udd27 PlaceholderAPI Integration** – Support for custom placeholders
\n– **\u23f0 Cooldown System** – Prevent spam with configurable cooldowns
\n– **\ud83c\udfaf Command Execution** – Run commands on join\/quit events
\n– **\ud83d\udcca Built-in Statistics** – Track player joins and active features
\n– **\ud83d\udd04 Live Reload** – Reload configuration without restarting
\n– **\ud83d\udee0\ufe0f Config Updater** – Automatic configuration updates with backup system
\n– **\ud83e\uddea Enhanced Test Command** – Actually test greetings instead of just logging<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
– **Minecraft 1.20.1+**
\n– **Folia** or **Paper** server
\n– **Java 17+**
\n– **Optional**: PlaceholderAPI for additional placeholders<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
The plugin generates a default configuration file at `plugins\/ExtraGreetings\/config.yml`. Here’s an example:<\/p>\n
“`yaml
\n# ExtraGreetings Configuration
\nsettings:
\n enableJoin: true
\n enableQuit: true
\n cooldownSeconds: 60
\n debug: false
\n joinDelay: 1<\/p>\n
join: recurring: vip: quit: # Regular quit greeting ## \ud83c\udfae Commands<\/p>\n | Command | Description | Permission | **Aliases**: `\/eg`<\/p>\n ## \ud83d\udd10 Permissions<\/p>\n | Permission | Description | Default | ## \ud83d\udee0\ufe0f Configuration Updater<\/p>\n ### \u2728 Features: ### \ud83d\udcc1 Backup Location: ### \ud83d\udd04 How It Works: ### \ud83d\udcdd Console Messages: ## \ud83c\udfa8 MiniMessage Formatting<\/p>\n ExtraGreetings supports full MiniMessage formatting:<\/p>\n “`yaml **Available Tags:** ## \ud83c\udff7\ufe0f Placeholders<\/p>\n ### Built-in Placeholders ### PlaceholderAPI Support ## \ud83c\udf86 Particle Effects<\/p>\n Supported particle effects include: ## \ud83d\udd0a Sound Effects<\/p>\n Supported sound effects include: ## \ud83c\udfaf Boss Bar Configuration<\/p>\n “`yaml ## \ud83d\udd27 Advanced Configuration<\/p>\n ### Custom Commands ### VIP Configuration ### Permission-Based Quit Messages ### Cooldown System ## \ud83d\udcca Statistics<\/p>\n Use `\/extragreetings stats` to view: ## \ud83e\uddea Testing System<\/p>\n ### Usage: ### Features: ## \ud83d\udc1b Troubleshooting<\/p>\n ### Common Issues<\/p>\n 1. **Greetings not showing**: Check if join\/quit events are enabled in config ### Debug Mode<\/p>\n Enable debug mode to see detailed logging: Or use the command: `\/extragreetings debug on`<\/p>\n ## \ud83d\udd04 Migration<\/p>\n ### From Other Greeting Plugins<\/p>\n 1. **Stop your server** ## \ud83e\udd1d Support<\/p>\n – **Discord**: Join our Discord<\/p>\n","protected":false},"excerpt":{"rendered":" A feature-rich greeting plugin for Minecraft servers with customizable particles, titles, subtitles, action bars, boss bars, chat messages, and more.<\/p>\n","protected":false},"featured_media":67352,"template":"","meta":{"_minecraft_slug":"extragreetings","_minecraft_project_id":"qutjObaT","_minecraft_author":"BloodRed","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":343,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"extragreetings.zip","_minecraft_size_bytes":422295,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-16T11:24:32.225876Z","_minecraft_date_created":"2025-07-19T01:48:40.972236Z","_minecraft_date_modified":"2025-07-19T17:43:54.447225Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/extragreetings","_minecraft_icon_attachment_id":67352,"_minecraft_imported_at":"2026-06-03T20:28:16+00:00","_minecraft_import_hash":"a21e9c87d8b2cfa475cb60867e12fc4a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,127,128],"mod_loader":[131,132,133],"minecraft_version":[36,60,93,94,101,102,62,37,73,74,38,78,79,80,81],"class_list":["post-67351","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-paper","mod_category-purpur","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n
\n firstTime:
\n title: “
\n subtitle: “
\n actionbar: “
\n bossbar:
\n enable: true
\n text: “Welcome, %player%!”
\n color: BLUE
\n style: SOLID
\n duration: 10
\n particles:
\n enable: true
\n effect: “HEART”
\n count: 50
\n offset: {x: 0.5, y: 1.0, z: 0.5}
\n speed: 0.1
\n sound:
\n enable: true
\n effect: “ENTITY_PLAYER_LEVELUP”
\n volume: 1.0
\n pitch: 1.0
\n message: “
\n commands:
\n – “give %player% diamond 1”
\n – “broadcast &aWelcome new player %player%!”<\/p>\n
\n title: “
\n subtitle: “
\n message: “
\n enable: true
\n title: “
\n subtitle: “
\n # … more VIP settings<\/p>\n
\n # VIP quit greeting (for players with extragreetings.vip permission)
\n vip:
\n message: “
\n particles:
\n enable: true
\n effect: “DRAGON_BREATH”
\n count: 30
\n offset: {x: 0.5, y: 1.0, z: 0.5}
\n speed: 0.15
\n sound:
\n enable: true
\n effect: “ENTITY_ENDER_DRAGON_FLAP”
\n volume: 1.0
\n pitch: 1.2
\n commands:
\n – “say VIP %player% has left the server!”<\/p>\n
\n regular:
\n message: “
\n particles:
\n enable: true
\n effect: “SMOKE_NORMAL”
\n count: 20
\n offset: {x: 0.0, y: 0.5, z: 0.0}
\n speed: 0.1
\n sound:
\n enable: true
\n effect: “ENTITY_HORSE_SADDLE”
\n volume: 0.8
\n pitch: 1.0
\n commands: []
\n“`<\/p>\n
\n|———|————-|————|
\n| `\/extragreetings` | Show help menu | `extragreetings.admin` |
\n| `\/extragreetings reload` | Reload configuration | `extragreetings.admin` |
\n| `\/extragreetings info` | Show plugin information | `extragreetings.admin` |
\n| `\/extragreetings stats` | Show plugin statistics | `extragreetings.admin` |
\n| `\/extragreetings debug [on\/off]` | Toggle debug mode | `extragreetings.admin` |
\n| `\/extragreetings reset [data\/cooldowns]` | Reset plugin data | `extragreetings.admin` |
\n| `\/extragreetings test [join\/quit]` | Test greetings (actually triggers them!) | `extragreetings.admin` |
\n| `\/extragreetings update` | Update configuration to latest version | `extragreetings.admin` |<\/p>\n
\n|————|————-|———|
\n| `extragreetings.admin` | Access to admin commands | `op` |
\n| `extragreetings.vip` | Receive VIP greetings (join AND quit) | `false` |
\n| `extragreetings.bypass.cooldown` | Bypass greeting cooldown | `op` |<\/p>\n
\n– **Automatic Updates**: Updates configuration on plugin startup
\n– **Comment Preservation**: Maintains all your configuration comments
\n– **Backup System**: Creates timestamped backups before changes
\n– **Manual Updates**: Use `\/extragreetings update` to force updates
\n– **Validation**: Checks for invalid sound\/particle effects<\/p>\n
\nBackups are stored in `\/plugins\/ExtraGreetings\/backups\/config.yml.timestamp.bak`<\/p>\n
\n1. **Startup**: Plugin automatically checks for missing config options
\n2. **Updates**: Adds new options with default values
\n3. **Cleanup**: Removes obsolete configuration options
\n4. **Preservation**: Keeps all your custom settings and comments<\/p>\n
\n“`
\n[ExtraGreetings] Added missing config option: quit.vip.message
\n[ExtraGreetings] Configuration updated successfully!
\n[ExtraGreetings] Config backed up to: config.yml.1234567890.bak
\n“`<\/p>\n
\ntitle: “
\nsubtitle: “
\nactionbar: “
\nmessage: “
\n“`<\/p>\n
\n– `
\n– `
\n– `
\n– `
\n– `%player%` – Player name
\n– `%player_displayname%` – Player display name
\n– `%player_uuid%` – Player UUID
\n– `%online_players%` – Online player count
\n– `%max_players%` – Maximum players
\n– `%server_name%` – Server name
\n– `%current_time%` – Current time
\n– `%server_uptime%` – Server uptime
\n– `%plugin_version%` – Plugin version<\/p>\n
\nWhen PlaceholderAPI is installed, you can use any available placeholder:
\n– `%player_level%` – Player level
\n– `%vault_eco_balance%` – Player balance
\n– `%luckperms_prefix%` – Player prefix
\n– And many more!<\/p>\n
\n– `HEART`, `VILLAGER_HAPPY`, `FLAME`, `SMOKE_NORMAL`
\n– `EXPLOSION_LARGE`, `FIREWORKS_SPARK`, `ENCHANTMENT_TABLE`
\n– `SNOWFLAKE`, `WATER_BUBBLE`, `REDSTONE`
\n– **NEW**: `DRAGON_BREATH` (used in VIP quit greetings)
\n– And all other Bukkit particle types<\/p>\n
\n– `ENTITY_PLAYER_LEVELUP`, `ENTITY_EXPERIENCE_ORB_PICKUP`
\n– `ENTITY_ENDER_DRAGON_GROWL`, `ENTITY_HORSE_SADDLE`
\n– `BLOCK_ANVIL_USE`, `ENTITY_FIREWORK_ROCKET_LAUNCH`
\n– **NEW**: `ENTITY_ENDER_DRAGON_FLAP` (used in VIP quit greetings)
\n– And all other Bukkit sound types<\/p>\n
\nbossbar:
\n enable: true
\n text: “Welcome, %player%!”
\n color: BLUE # BLUE, RED, GREEN, YELLOW, PURPLE, PINK, WHITE
\n style: SOLID # SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
\n duration: 10 # Duration in seconds
\n“`<\/p>\n
\nExecute commands when players join or quit:
\n“`yaml
\ncommands:
\n – “give %player% diamond 1”
\n – “broadcast &aWelcome %player%!”
\n – “tp %player% spawn”
\n“`<\/p>\n
\nSpecial greetings for VIP players (both join AND quit):
\n“`yaml
\nvip:
\n enable: true
\n title: “
\n # Players need extragreetings.vip permission
\n“`<\/p>\n
\nDifferent quit messages based on permissions:
\n– **VIP Players** (`extragreetings.vip`): Special quit effects with dragon particles
\n– **Regular Players**: Standard quit messages<\/p>\n
\nPrevent greeting spam:
\n“`yaml
\nsettings:
\n cooldownSeconds: 60 # Cooldown in seconds
\n joinDelay: 1 # Delay before showing greeting
\n“`<\/p>\n
\n– Total players who have joined
\n– Active cooldowns
\n– Active boss bars
\n– Plugin status<\/p>\n
\n– `\/extragreetings test join` – Tests join greetings (shows actual effects!)
\n– `\/extragreetings test quit` – Tests quit greetings (shows actual effects!)<\/p>\n
\n– **Actual Triggering**: Shows real greetings instead of just logging
\n– **Permission Detection**: Automatically detects VIP status
\n– **Feedback**: Shows which type of greeting is being triggered
\n– **Error Handling**: Provides clear error messages if something fails<\/p>\n
\n2. **Particles not spawning**: Verify particle effect names are correct
\n3. **Sounds not playing**: Check sound effect names and volume settings
\n4. **PlaceholderAPI not working**: Make sure PlaceholderAPI is installed and loaded
\n5. **Config not updating**: Use `\/extragreetings update` to manually update<\/p>\n
\n“`yaml
\nsettings:
\n debug: true
\n“`<\/p>\n
\n2. **Remove the old plugin** and its data files
\n3. **Install ExtraGreetings**
\n4. **Configure** the new plugin using this guide
\n5. **Start your server**<\/p>\n