A lightweight and customizable plugin configuration for managing player join, first join, and leave messages with full color support and in-game admin controls.

🖥️ Compatibility

Compatible with Minecraft 1.19 – 1.21+ (both Paper and Spigot)
Supports Java 17+ servers

📝 Changelog

v1.0 – Initial Release

First release of the Welcome Message Config plugin
Basic first join/join/leave message support
In-game admin commands to manage messages

🔮 Planned Features

Placeholder support (e.g., %online%, %world%)
GUI configuration menu for easier editing
Custom animations or sounds on join/leave
Title, Action bar on join/leave
Rewards on first join
Rewards on welcoming

⚠️ Note: This is my first plugin and my first upload! If you notice any errors or bugs, please let me know on Discord.

ReadMe

📘 Welcome Message Config – README

This configuration file controls join/leave messages and admin commands for your plugin.

⚙️ Features

Custom first join message
Custom regular join message
Custom leave message
Enable/disable each message type
Admin command to edit settings in-game

🧩 Configuration Overview

🔹 First Join Message / Join Message / Leave Message

firstjoin_message/join_message/leave_message:
  enabled: true
  text: "&7[&5+&7] %player%"

enabled: Enable/disable the first-time join/join/leave message
text: Message shown when a player joins for the first time/join/leave

🎨 Formatting

& is used for color codes (Minecraft formatting)
%player% will be replaced with the player's name

🛠️ Admin Command

Base Command

/wlcadmin

Permission

wlcadmin.use
&cYou do not have permission to perform this command. (%permission%)

📌 Available Subcommands

/wlcadmin reload
/wlcadmin setfirstjoinmessage <message>
/wlcadmin setfirstjoinenabled <true/false>
/wlcadmin setjoinmessage <message>
/wlcadmin setjoinenabled <true/false>
/wlcadmin setleavemessage <message>
/wlcadmin setleaveenabled <true/false>

⚠️ Usage Notes

Boolean values must be true or false
Invalid usage will return an error message with correct syntax

Deafult Config

firstjoin_message:
  enabled: true
  text: "&7[&5+&7] %player%"

join_message:
  enabled: true
  text: "&7[&a+&7] %player%"

leave_message:
  enabled: true
  text: "&7[&c+&7] %player%"

wlcadmin_command:
  permission: wlcadmin.use
  nopermissionmessage: "&cYou do not have permission to perform this command. (%permission%)"
  correctusage: "Correct usage /wlcadmin <reload/setjoinmessage/setleavemessage/setjoinenabled/setleaveenabled>"
  reload:
    successfully: "&aThe configuration has been successfully reloaded."
    warning: "&eThe configuration was reloaded, but some values may not be valid."
    error: "&cAn error occurred while reloading the configuration."
  setfirstjoinmessage:
    successfully: "&aThe join message has been updated successfully."
    error: "&cUsage: /wlcadmin setfirstjoinmessage <message>"
  setfirstjoinenabled:
    successfully: "&aThe join message state has been updated to %newstate%."
    samestate: "&eThe join message state is already set to this value."
    error: "&cUsage: /wlcadmin setfirstjoinenabled <true/false>"
  setjoinmessage:
    successfully: "&aThe join message has been updated successfully."
    error: "&cUsage: /wlcadmin setjoinmessage <message>"
  setjoinenabled:
    successfully: "&aThe join message state has been updated to %newstate%."
    samestate: "&eThe join message state is already set to this value."
    error: "&cUsage: /wlcadmin setjoinenabled <true/false>"
  setleavemessage:
    successfully: "&aThe leave message has been updated successfully."
    error: "&cUsage: /wlcadmin setleavemessage <message>"
  setleaveenabled:
    successfully: "&aThe leave message state has been updated to %newstate%."
    samestate: "&eThe leave message state is already set to this value."
    error: "&cUsage: /wlcadmin setleaveenabled <true/false>"