AstroJoinLeave
v1.0.01.20+AstroJoinLeave shows custom join and leave messages per player rank using LuckPerms or vanilla permissions. Supports title, actionbar, and chat broadcasts.
Overview
AstroJoinLeave replaces the plain grey 'Player joined the game' line with custom join and leave messages that can change depending on the player's rank. A donor or staff member can get a styled entrance while a default player gets something simpler, which makes ranks feel meaningful the moment someone logs on. The plugin reads the player's group from LuckPerms when it is present, and falls back to vanilla permission nodes when it is not, so it fits both heavily managed networks and small servers.
Beyond plain chat lines, messages can be delivered as a title splashed across the centre of the screen, an actionbar line above the hotbar, or a normal chat broadcast, in any combination. That flexibility lets you make a first-join welcome genuinely feel like an event, with a big title for new players, while keeping routine joins and leaves to a quiet chat line. A dedicated first-join message fires only the very first time an account connects, which is the natural place to greet newcomers and point them at your rules or guide.
Presentation matches the rest of a modern setup: messages support hex colours and gradients, and placeholders like %player%, %online% and %max% drop live values into the text. Because every template lives in the config and the plugin reloads in place, you can tune your welcome flow or add a new rank's messaging without restarting and kicking everyone off.
Who it is for
Ranked survival servers and networks that want entrances to reflect a player's rank, communities that want a memorable first-join welcome, and any server replacing the default join and leave spam with something styled and on-brand.
Features
- Per-rank join/leave messages
- Title + actionbar + chat options
- First-join welcome message
- Hex color and gradient support
- Placeholder support: %player%, %online%, %max%
- Works with LuckPerms or vanilla permissions
Commands
| Command | Description | Permission |
|---|---|---|
/astrojoinleave reload | Reload config | astrojoinleave.admin |
Permissions
| Node | Description | Default |
|---|---|---|
astrojoinleave.admin | Use reload | op |
astrojoinleave.group.<rank> | Use specific rank message template | op |
Example Config
# AstroJoinLeave Configuration
first-join:
enabled: true
message: "&6Welcome &e%player% &6to the server!"
groups:
default:
join: "&7%player% joined"
leave: "&7%player% left"first-join.enabled toggles the one-time welcome and its message supports placeholders and colours. Under groups, each named group defines its own join and leave lines, and the plugin matches a player to a group by their LuckPerms group or the astrojoinleave.group.<rank> permission. Placeholders %player%, %online% and %max% are replaced live, and lines accept legacy, hex and gradient colours.
Installation
Drop AstroJoinLeave.jar into /plugins and restart. For per-rank messages it reads groups from LuckPerms if it is installed; without LuckPerms it falls back to permission nodes, so the per-rank feature needs either LuckPerms or a permissions plugin that can grant the astrojoinleave.group.<rank> nodes. It generates a config.yml on first run with default and first-join templates to edit.
Download
Frequently Asked Questions
Do I need LuckPerms to use this plugin?
No, but it helps. With LuckPerms installed, the plugin reads each player's group automatically to pick the right per-rank message. Without it, the plugin falls back to vanilla permission nodes, so you can still drive per-rank messages by granting astrojoinleave.group.<rank> through whatever permissions plugin you run. Basic join and leave messages work with neither.
How does the first-join message work?
The first-join message fires only the very first time an account connects to the server, never on subsequent logins. Enable it under first-join in the config and write a welcome that greets newcomers, often pointing them at your rules or a getting-started guide. Returning players see the normal join message instead.
What is the difference between title, actionbar and chat messages?
A title is large text shown across the centre of the screen, an actionbar line appears just above the hotbar, and a chat message is a normal line in the chat box. You can use any combination per message, so a first-join can be a big title while routine joins stay as a quiet chat line.
Which placeholders are available?
The built-in placeholders are %player% for the player's name, %online% for the current player count and %max% for the server's slot limit. Drop them into any join, leave or first-join line and the plugin substitutes the live values when the message is sent.
Can I use hex colours in the messages?
Yes. Message templates accept the legacy &-codes, full hex colours and gradients, so you can style each rank's entrance to match your server's palette rather than being limited to the sixteen classic colours.
Do changes require a restart?
No. Edit the templates in config.yml and run /astrojoinleave reload to apply them live. You can add a new rank's messaging or adjust the welcome flow without restarting the server.