WelcomeManager - Increase player retention | Reward friendly players! icon

WelcomeManager - Increase player retention | Reward friendly players! -----

A plugin that rewards users for welcoming & welcoming back players to the server. Community feature!



config.yml


Code (YAML):
# This is the default configuration file for the plugin
# You can change the values to your liking but make sure to keep the format the same
# If you mess up the format, the plugin will not work properly.
#
#           ----> Things to note: <----
# - The rewardCooldown is in milliseconds. 1000 milliseconds = 1 second
# - The timeWindow is in milliseconds. 1000 milliseconds = 1 second
# - The commands are run as the console, so you can use %player% to reference the player that welcomed someone
# - The commands are run in the order they are listed
# - The commands are run synchronously, so if one command takes a long time to run, the next command will not run until the first one is done
# - This plugin is NOT case sensitive, so 'welcome' and 'Welcome' are the same
# - This plugin is not optimized to handle huge servers with hundreds of joins and leaves in short sucession. This system will brick your server
#   if this is run on a server with massive amounts of joins and leaves as the plugin reads/writes to disk a lot for handling data.
#
##################################################


welcomekeywords
: # The keyword that triggers the welcome reward. Do not add more than 10 keywords or you'll see peroformance drop. Here be dragons (or something)
  - welcome
  - wb
  - hello
  - greetings
  - welcome back
rewardCooldown
: 30000 # 30 seconds in milliseconds (1000 milliseconds = 1 second)
timeWindow
: 30000 # 30 seconds in milliseconds (1000 milliseconds = 1 second)
commandFirstWelcome
: # The command(s) that will be run when a player welcomes someone for a first-time join (new to server)
  - 'give %player% diamond 1'
commandReturningWelcome
: # The command(s) that will be run when a player welcomes someone that has already joined the server before
  - 'give %player% iron_ingot 1'
  - 'give %player% apple 5'
messages.yml


Code (YAML):
# This file contains all messages that are sent to the player.
# You can change the messages to your liking.
#
# ======== IMPORTANT ========
# You must follow the minimessage format from adventureAPI (https://docs.advntr.dev/index.html)
# Use this tool: https://webui.advntr.dev/ to convert your messages to minimessage format.
#
# You can use the following placeholders:
# <newPlayerName> - The name of the player that just joined
# <timeWindow> - The time window in seconds
# <timeLeft> - The time left in seconds
# <reward> - The reward message
#
# Version: 1.2.5-r (24032025)
#
# Do NOT leave any messages empty or add new messages. Only change the text between the quotes.

giveReward
: "<green><bold>SUCCESS - Reward granted\n<gray>\nYou gained 1 welcome point\nand received some reward(s)\n<gray>\n<red>TIPP: <gray>You can toggle the\nJoin-reminders by typing:\n<gray>\n<yellow><click:run_command:'/grm nochatprompt'><hover:show_text:'<gray>Click to toggle setting'>/grm nochatprompt</hover></click><gray>\n"

sendErrorMessage
:
  self
: "<red>You cannot greet yourself."
  timeWindowExceeded
: "<red><bold>Denied: <gray>Player joined more than <timeWindow> seconds ago. Try to greet them faster for a reward next time."
  alreadyGreeted
: "<red><bold>Denied: <gray>You've already greeted that player in the last <timeWindow> seconds. Please wait another <timeLeft> seconds to welcome the same player again."

sendChatPromptColored
: "<green>New Join! <gray>Player <newPlayerName> just joined the server.\n<gray>Click <yellow><click:run_command:'/greet <newPlayerName>'><hover:show_text:'<gray>Click to welcome player and get a reward!'>here</hover></click><gray> to welcome them!"
rewardGrantedMessage
: "<green><bold>SUCCESS - Reward granted\n<gray>\n<gray>You gained 1 welcome point\n<gray>and received some reward(s)\n<gray>\n<red>TIPP: <gray>You can toggle the\n<gray>Join-reminders by typing:\n<gray>\n<yellow><click:run_command:'/grm prompt'><hover:show_text:'<gray>Click to toggle setting'>/grm prompt</hover></click><gray>\n"
no_permission
: "<red>You do not have permission to use this command."
Resource Information
Author:
----------
Total Downloads: 49
First Release: Mar 20, 2025
Last Update: Mar 30, 2025
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings