Join & Leave

A lightweight and fully customizable join and leave message plugin for Minecraft servers.

Features

• Full Color & HEX Support: Custom RGB color codes (#RRGGBB or &#RRGGBB) as well as standard Minecraft color codes (&a, &f, etc.).
• PlaceholderAPI Support: Seamlessly integrate with PlaceholderAPI to display dynamic player stats in join/leave messages.
• First-Join Welcome Messages: Set up special custom welcome messages for players joining the server for the first time.
• Silent Join/Leave Permission: Hide join and leave messages for staff or specific roles using a permission node.
• In-Game Testing Tools: Privately test and preview your join and leave messages or simulate player activity without spamming online players.

Config

# Placeholders: %player% (+ PlaceholderAPI placeholders if installed)
# Colors: &-codes or hex #RRGGBB / &#RRGGBB
# https://htmlcolorcodes.com

join:
  enabled: true
  message: "#55FF7F + &f%player%"
  first-join-enabled: false
  first-join-message: "#55FF7F + &f%player% &7Welcome to the server for the first time!"

leave:
  enabled: true
  message: "#FF5C5C - &f%player%"

test:
  amount: 30
  names:
    - beerigg
    - ShadowCrafter
    - PixelFalcon
    - EnderKnight88
    - BlockyWolf
    - StormRider22
    - CraftyPanda
    - NightHawk77
    - DiamondFoxx
    - MysticElm
    - RapidBadger
    - GoldenTiger3
    - FrostByte
    - EmberQuill
    - VividStorm
    - CopperWren
    - LunarSpark
    - TurboYeti
    - SilentArrow
    - IronMaple
    - CrimsonLynx
    - VelvetOtter
    - TitanSpruce
    - WanderingCub
    - EchoRavine
    - ObsidianFinch
    - MapleForge
    - ZephyrFalls
    - GraniteHawk
    - VortexPine

Permissions

# Required to run /joinleave at all (reload/test/testmany)
joinleave.use

# /joinleave reload
joinleave.reload

# /joinleave test <name>
# /joinleave testmany
joinleave.test

# Not a command - when a player has this, their join/leave messages aren't shown to anyone
joinleave.silent

Commands

Reload

/joinleave reload

Reloads config.yml without restarting the server or plugin.

Permission: joinleave.reload

Test

/joinleave test <name>

Sends only the command sender a preview of the join and leave message for a given name.

If the name matches a player who is currently online, PlaceholderAPI placeholders resolve for the real player too.

Permission: joinleave.test

Test Many

/joinleave testmany

Sends only the command sender a simulation of 30 join messages followed by 30 leave messages.

Uses the fictional names from test.names in the config. This is useful for testing how the messages look under load.

Permission: joinleave.test

Placeholders

• %player% — The player's name.
• PlaceholderAPI placeholders — Supported when PlaceholderAPI is installed.

Colors

• Minecraft Colors: &a, &f, &c, etc.
• HEX: #55FF7F
• Alternative HEX: &#55FF7F

Silent

Players with the following permission will not have their join/leave messages shown to anyone:

joinleave.silent

This is useful for staff, bots, or specific roles that should remain hidden.

That's pretty much the whole plugin good luck with the server!