Overview:
Allow players to welcome new players using
/welcome and earn configurable rewards. The plugin supports two modes:
- Time-based: Players can welcome a new player within a set time window after they join.
- Count-based: Only a limited number of players can welcome the new player.
Code (Text):
# Set to either "time" or "count":
# - "time": Players can welcome the newest player within a time window (in seconds)
# - "count": A limited number of players (max-welcomes) can welcome the newest player
welcome-mode: "time"
welcome-time-limit-seconds: 300
max-welcomes: 3
Rewards can be customized based on the order players welcome the newcomer—such as unique rewards for the first, second, or third player. Players who try to welcome more than once, or outside the allowed window, will receive a message and won’t receive rewards.
Includes
/welcome reload command to update settings from the config without restarting the server.
Command Usage:
- /welcome – Welcomes the newest player on the server.
- ✅ Grants rewards based on the player's welcome position (1st, 2nd, 3rd, etc.).
- ⛔ If the welcome window has expired or the player has already welcomed, a message will be shown and no rewards will be given.
- Permission required: welcome.use
- /welcome reload – Reloads the plugin's configuration without restarting the server.
- Permission required: welcome.reload
Plugin Prerequisites:
There are no required dependencies to run this plugin. However, if you want to reward players with items, permissions, or currency, you’ll need additional plugins (e.g., EssentialsX, Vault, LuckPerms) to handle those actions via console commands. Integrating rewards is entirely optional and fully customizable!
Installation:
Welcome is a lightweight plugin that doesn't store any player data. It comes with just the .jar file and a simple
config.yml.
To install:
- Download the WELCOME.jar file (thank you!)
- Place it in your server’s /plugins folder.
- Restart your server or use a plugin loader (e.g., PlugMan).
- Edit the configuration to suit your needs.
- You're all set—enjoy!
Placeholders:
The plugin supports two placeholders:
- %newplayer% — the username of the new player being welcomed
- %player% — the player who executed the /welcome command
Note: These placeholders are only supported in their designated config fields (such as messages and command strings).
Configuration:
Code (Text):
# Welcome Plugin Configuration
# Set to either "time" or "count":
# - "time": Players can welcome the newest player within a time window (in seconds)
# - "count": A limited number of players (max-welcomes) can welcome the newest player
welcome-mode: "time"
welcome-time-limit-seconds: 300
max-welcomes: 3
# Whether rewards are tiered (different for 1st, 2nd, 3rd...) or the same for everyone
tiered-rewards: true
# If true, when more players welcome than the number of configured reward tiers,
# the last tiered reward will be repeated for all additional players (e.g., 4th, 5th, 6th...)
# If false, they will receive the no-reward-message instead
repeat-last-tier: true
# Message shown when a player welcomes someone but all rewards are already claimed
# Only shown if repeat-last-tier is false
no-reward-message: "&7Thanks for welcoming %newplayer%, but all rewards have already been claimed."
# Message players use when welcoming a new player
message: "&7Welcome, &f%newplayer%&7, to the server!"
# Reload messages
reload-message-successful: "&aWelcome plugin reloaded."
reload-no-permission: "&cYou do not have permission to reload the config."
# Console attempt to run /welcome
not-player: "&cOnly players may use this command."
# No permission to welcome
no-permission: "&cYou do not have permission to use /welcome."
# Welcome window expired or player already welcomed
already-welcome: "&7There is no new player to welcome right now, or the welcome window has ended."
# Reward tiers
# You can configure different rewards based on welcome order.
# Use %player% for the player who welcomed and %newplayer% for the new player.
# All players after the last reward will receive the same reward. For example,
# the 3rd, 4th, 5th, etc. players to welcome will receive reward 3.
rewards:
1:
message: "&aYou were the first to welcome %newplayer%! Here's a reward!"
commands:
- "eco give %player% 500"
2:
message: "&bYou were the second to welcome %newplayer%! You get a smaller bonus!"
commands:
- "eco give %player% 350"
3:
message: "&eThanks for welcoming %newplayer%! You’ve earned a reward of $250!"
commands:
- "eco give %player% 250"
Feedback & Features:
If you would like to see a new feature added, message me and I will try my best to implement it. If you have any questions, comments, or concerns, feel free to message me. I have a few other plugins you may enjoy, such as
Trash, so make sure to check them out!
Leave a Review!
Don't forget to leave a review down below! Message me with any issues before taking it into account in your review.