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!)
Custom Permission Greetings - Create unlimited custom greetings based on any permission with priority system
Permission-Based Quit Messages - VIP, custom permission, 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:
Spoiler: Configuration Example
Code (Text):
# 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>[VIP]</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
/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 [on/off]
Toggle debug mode
extragreetings.admin
/extragreetings reset [data/cooldowns]
Reset plugin data
extragreetings.admin
/extragreetings test [join/quit]
Test greetings (actually triggers them!)
extragreetings.admin
/extragreetings update
Update configuration to latest version
extragreetings.admin
/extragreetings permissions [player]
Show custom permissions for a player
extragreetings.admin
Aliases : /eg
Permissions
extragreetings.admin
Access to admin commands
op
extragreetings.vip
Receive VIP greetings (join AND quit)
false
extragreetings.bypass.cooldown
Bypass greeting cooldown
op
example.one
Custom permission greeting (priority 10)
false
example.two
Custom permission greeting (priority 5)
false
your.custom.permission
Any custom permission you define
false
Custom Permission Greetings
Features:
Unlimited Permissions : Define as many custom permissions as you want
Priority System : Higher priority permissions override lower ones
Both Join & Quit : Separate greetings for joining and leaving
First-Time vs Recurring : Different messages for new vs returning players
All Effects Supported : Titles, particles, sounds, boss bars, commands, etc.
Spoiler: Configuration Example
Code (Text):
customPermissions:
# Higher priority = higher precedence
example.one:
priority: 10
join:
firstTime:
title: "<gradient:#FF0000:#00FF00>Special Welcome</gradient>"
subtitle: "<italic>%player% joined with example.one permission!</italic>"
actionbar: "<gold>You have special powers!</gold>"
bossbar:
enable: true
text: "Welcome, Special One %player%!"
color: RED
style: SOLID
duration: 8
particles:
enable: true
effect: "FIREWORKS_SPARK"
count: 75
offset: {x: 1.0, y: 1.5, z: 1.0}
speed: 0.2
sound:
enable: true
effect: "ENTITY_FIREWORK_ROCKET_LAUNCH"
volume: 1.0
pitch: 1.0
message: "<bold><red>[SPECIAL]</red></bold> <white>%player%</white> joined with example.one powers!"
commands:
- "give %player% gold_ingot 5"
- "effect give %player% minecraft:speed 60 1 true"
recurring:
title: "<red>Welcome back, Special One!</red>"
subtitle: "<gray>Your powers await!</gray>"
# ... more settings
quit:
message: "<bold><red>[SPECIAL]</red></bold> <white>%player%</white> has left the server!"
particles:
enable: true
effect: "LAVA"
count: 25
offset: {x: 0.5, y: 1.0, z: 0.5}
speed: 0.1
sound:
enable: true
effect: "ENTITY_BLAZE_DEATH"
volume: 1.0
pitch: 1.0
commands:
- "say Special player %player% has departed!"
example.two:
priority: 5
join:
firstTime:
title: "<gradient:#0000FF:#FFFF00>Elite Member</gradient>"
subtitle: "<italic>%player% joined as an Elite!</italic>"
# ... more elite settings
quit:
message: "<bold><blue>[ELITE]</blue></bold> <white>%player%</white> has left the server!"
# ... more elite quit settings
How It Works:
Priority Based : If a player has multiple custom permissions, the highest priority one is used
Fallback System : Custom permissions → VIP → Regular greetings
Automatic Registration : Permissions are automatically registered from your config
Safe Reloading : No duplicate permission conflicts when reloading
Usage Examples:
Code (Text):
# Grant a player the example.one permission
/luckperms user PlayerName permission set example.one true
# Grant a player the example.two permission
/luckperms user PlayerName permission set example.two true
# Check what custom permissions a player has
/extragreetings permissions PlayerName
# Test the custom permission greetings
/extragreetings test join
/extragreetings test quit
MiniMessage Formatting
ExtraGreetings supports full MiniMessage formatting:
Code (Text):
title: "<gradient:#FF55FF:#55FFFF>Welcome</gradient>"
subtitle: "<italic><yellow>%player%</yellow> has joined!</italic>"
actionbar: "<rainbow>Enjoy your stay!</rainbow>"
message: "<bold><gold>[+]</gold></bold> <white>%player%</white> joined!"
Available Tags:
<bold>, <italic>, <underlined>, <strikethrough>
<color:#hex>, <red>, <green>, <blue>, etc.
<gradient:#start:#end>, <rainbow>
<click:run_command:/command>, <hover:show_text:text>
Placeholders
Built-in Placeholders
%player% - Player name
%player_displayname% - Player display name
%player_uuid% - Player UUID
%online_players% - Online player count
%max_players% - Maximum players
%server_name% - Server name
%current_time% - Current time
%server_uptime% - Server uptime
%plugin_version% - Plugin version
PlaceholderAPI Support
When PlaceholderAPI is installed, you can use any available placeholder:
%player_level% - Player level
%vault_eco_balance% - Player balance
%luckperms_prefix% - Player prefix
And many more!
Particle Effects
Supported particle effects include:
HEART, VILLAGER_HAPPY, FLAME, SMOKE_NORMAL
EXPLOSION_LARGE, FIREWORKS_SPARK, ENCHANTMENT_TABLE
SNOWFLAKE, WATER_BUBBLE, REDSTONE
NEW : DRAGON_BREATH (used in VIP quit greetings)
And all other Bukkit particle types
Sound Effects
Supported sound effects include:
ENTITY_PLAYER_LEVELUP, ENTITY_EXPERIENCE_ORB_PICKUP
ENTITY_ENDER_DRAGON_GROWL, ENTITY_HORSE_SADDLE
BLOCK_ANVIL_USE, ENTITY_FIREWORK_ROCKET_LAUNCH
NEW : ENTITY_ENDER_DRAGON_FLAP (used in VIP quit greetings)
And all other Bukkit sound types
Boss Bar Configuration
Code (Text):
bossbar:
enable: true
text: "Welcome, %player%!"
color: BLUE # BLUE, RED, GREEN, YELLOW, PURPLE, PINK, WHITE
style: SOLID # SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
duration: 10 # Duration in seconds
Testing System
Usage:
/extragreetings test join - Tests join greetings (shows actual effects!)
/extragreetings test quit - Tests quit greetings (shows actual effects!)
Features:
Actual Triggering : Shows real greetings instead of just logging
Permission Detection : Automatically detects VIP and custom permission status
Feedback : Shows which type of greeting is being triggered
Error Handling : Provides clear error messages if something fails
Troubleshooting
Common Issues
Greetings not showing : Check if join/quit events are enabled in config
Particles not spawning : Verify particle effect names are correct
Sounds not playing : Check sound effect names and volume settings
PlaceholderAPI not working : Make sure PlaceholderAPI is installed and loaded
Config not updating : Use /extragreetings update to manually update
Custom permissions not working : Use /extragreetings permissions to check player permissions
Wrong greeting showing : Check permission priorities in your config
Debug Mode
Enable debug mode to see detailed logging:
Code (Text):
settings:
debug: true
Or use the command:
/extragreetings debug on
Statistics
Use
/extragreetings stats to view:
Total players who have joined
Active cooldowns
Active boss bars
Plugin status
Support
Discord : Join our Discord
GitHub : Report issues and contribute
Documentation : Full configuration examples included
Download ExtraGreetings today and create amazing welcome experiences for your players!