pyJoinsMessages

🌸 A lightweight Minecraft plugin for custom join and leave messages.

Add clean, colored messages when players join or leave your server, with separate messages for staff, donors, special ranks, or everyone.

Features

• Custom join and leave messages
• Unlimited message groups under join-messages
• Permission-based messages for ranks like staff, donors, nitro, and more
• Priority based on the order of groups in config.yml
• Single-line and multi-line message support
• Hex color support using &#RRGGBB or #RRGGBB
• Classic Minecraft color support using &a, &c, &l, etc.
• Optional Vault support for %prefix%
• Option to disable vanilla join/leave messages
• Reload command with /pyjoinsmessages reload

Placeholders

• %user% - player name
• %player% - player name
• %prefix% - player prefix from Vault, requires Vault and a chat/permissions plugin

If Vault is installed and a chat provider is found, the plugin will print a startup message saying that %prefix% can be used.

Configuration

# ============================================================
# pyJoinsMessages - config version 1.0
# Author: 666pyke
# ============================================================
#
# Add as many groups as you want under join-messages.
# The plugin checks groups from top to bottom and uses the
# first group whose permission the player has.
#
# Messages can be one line:
#   join-message: "%user% joined the server"
#
# Or multiple lines:
#   join-message:
#     - "&8----"
#     - "%user% joined the server"
#     - "&8----"
#
# Supported colors:
#   &a, &c, &l, etc.
#   &#55FF55 or #55FF55 for hex colors
#
# Supported placeholders:
#   %user%
#   %player%
#   %prefix% - requires Vault + a chat/permissions plugin with prefix support
#
# Example with Vault prefix:
#   join-message:
#     - "&8----"
#     - "%prefix% &f%user% &7joined the server"
#     - "&8----"
#
# The default group is used for everyone who does not match
# a permission group.
#
# If you want to disable default custom messages for everyone
# and keep only messages for donors/staff/players with perms,
# comment out the whole default section like this:
#
#   # default:
#   #   join-message:
#   #     - "&8----"
#   #     - "%user% joined the server"
#   #     - "&8----"
#   #   leave-message:
#   #     - "&8----"
#   #     - "%user% left the server"
#   #     - "&8----"
#
# ============================================================
join-messages:
  staff:
    join-message:
      - "&8----"
      - "&#55FF55%user% joined the server"
      - "&8----"
    leave-message:
      - "&8----"
      - "&#FF5555%user% left the server"
      - "&8----"
    permission: joinmessages.staff

  nitro:
    join-message: "%user% joined the server"
    leave-message: "%user% left the server"
    permission: joinmessages.nitro

  donator:
    join-message: "%prefix% %user% joined the server"
    leave-message: "%prefix% %user% left the server"
    permission: joinmessages.donator

  default:
    join-message:
      - "&8----"
      - "%user% joined the server"
      - "&8----"
    leave-message:
      - "&8----"
      - "%user% left the server"
      - "&8----"

options:
  disable-vanilla-message: true

messages:
  reloaded: "Plugin reloaded."

Permissions

Give each group permission to the rank that should use that message.

Example:

permission: joinmessages.donator

Players with joinmessages.donator will use the donor join/leave messages. If a player does not match any permission group, the plugin will use the default group.

Commands

• /pyjoinsmessages reload - reloads the config
• /joinmessages reload - alias for the same command

Notes

💗 If you only want special messages for ranks like donors or staff, just comment out the default section. Players without a matching permission will not get a custom join/leave message.

The plugin can also disable the default yellow Minecraft join/leave messages, keeping your chat cleaner and easier to style.