## ProxyPlayerNotify<\/p>\n
**More info & guide:** GitHub \u2013 ProxyPlayerNotify<\/p>\n
**Latest builds (features + bug fixes)**: GitHub Actions \u2013 ProxyPlayerNotify<\/p>\n
**What it does**
\nNetwork-wide **join\/leave\/switch** messages with per-player toggles, vanish support, LuckPerms\/PAPI placeholders, and optional webhook ping.<\/p>\n
> **Note:** This is a **proxy** plugin \u2014 install on **BungeeCord\/Waterfall** or **Velocity** (not on Spigot\/Paper).<\/p>\n
**Works on**: BungeeCord\/Waterfall, Velocity<\/p>\n
**How to use**<\/p>\n
1. Install on your **proxy** and restart to generate the config.
\n2. Customize messages\/placeholders and (optionally) webhook settings.
\n3. Grant the view\/toggle permissions as needed.<\/p>\n
**Config (YAML)**<\/p>\n
“`yaml
\n# ProxyPlayerNotify Config<\/p>\n
# This config file contains settings for the ProxyPlayerNotify plugin.
\n# Use this file to customize the join\/leave messages and permissions.
\n# Use n to create multiple lines\/messages to players.
\n# Set message to “” to not send any message\/empty.<\/p>\n
# Network Join Message
\n# This message is displayed when a player joins the network.
\n# Placeholders available: %player%, %lp_prefix%, %lp_suffix%, %server%, %time%.
\njoin_message: “%player% has joined the network (Logged in server: %server%) at %time%”<\/p>\n
# Network Private Join Message
\n# This message is displayed only to the player who joins the network.
\n# It has a higher priority than the public join message.
\n# Placeholders available: %player%, %lp_prefix%, %lp_suffix%, %server%, %time%.
\njoin_private_message:
\n – “&aWelcome, %player%!”
\n – “&bYou have joined the server %server% at %time%.”
\n – “Enjoy your stay!”<\/p>\n
# First Join Message
\n# This message is displayed when a player joins the network for the first time.
\n# Placeholders available: %player%, %lp_prefix%, %lp_suffix%, %server%, %time%.
\nfirst_join_message: “%player% has joined the network for the first time on %server% at %time%”<\/p>\n
# First Join Private Message
\n# This message is displayed only to the player joining for the first time.
\n# Placeholders available: %player%, %lp_prefix%, %lp_suffix%, %server%, %time%.
\nfirst_join_private_message: “&aWelcome for the first time, %player%!”<\/p>\n
# Servers Switch Message
\n# This message is displayed when a player switches to a different server.
\n# Placeholders available: %player%, %last_server%, %server%, %time%, %lp_prefix%, %lp_suffix%.
\nswitch_message: “%player% has switched from %last_server% and joined to the %server% server at %time%”<\/p>\n
# Network Leave Message
\n# This message is displayed when a player leaves the network.
\n# Placeholders available: %player%, %lp_prefix%, %lp_suffix%, %last_server%, %time%.
\nleave_message: “%player% has left the network (Last server: %last_server%) at %time%”<\/p>\n
# Delay for Join Messages
\n# This option sets the delay before sending the join message after a player connects.
\n# For example, join_message_delay: 49 will send the message after 49 ticks.
\n# Warning: Setting this value too low may cause messages not to be sent or be blank placeholder if the server name is not yet available.
\njoin_message_delay: 45<\/p>\n
# Delay for First Join Messages
\n# This option sets the delay before sending the first join message after a player connects.
\nfirst_join_message_delay: 10<\/p>\n
# Delay for Private Join Messages
\n# This option sets the delay before sending the private join message to the joining player.
\n# For example, join_private_message_delay: 50 will send the message after 50 ticks.
\n# Warning: Setting this value too low may cause messages not to be sent or be blank placeholder if the server name is not yet available.
\njoin_private_message_delay: 50<\/p>\n
# Delay for First Join Private Messages
\n# This option sets the delay before sending the first join private message to the joining player.
\nfirst_join_private_message_delay: 10<\/p>\n
# Delay for Switch Messages
\n# This option sets the delay before sending the switch message after a player switches servers.
\n# For example, switch_message_delay: 0 will send the message after 0 ticks.
\nswitch_message_delay: 0<\/p>\n
# Disable messages for vanished players (Currently supports PremiumVanish and SuperVanish)
\ndisable_vanish_notifications: false<\/p>\n
# Option to let players rejoin the server they were on before they left the network.
\n# If this is enabled, the player will be sent to the last server on join in which they were on before they left the network.
\n# If enabled, the message delay options would need to be increased so that the messages can get the server
\njoin_last_server: false<\/p>\n
# Enable MiniMessage format parsing for all messages
\nuse_minimessage: false<\/p>\n
# Permissions
\n# Use these settings to control who can see the join\/leave messages.
\n# Enable permissions if you want to use permissions and want to use next two options.
\n# If permissions enabled Then if notify_message is true and the player doesn’t have ppn.notify permission, then their join\/leave\/message will not be sent.
\n# If permissions enabled Then if hide_message is true and the player doesn’t have ppn.view permission, then they won’t see the others’ join\/switch\/leave messages.
\npermission:
\n # Enable this if you want to use permissions and want to use next two options.
\n permissions: false<\/p>\n
# Notify Messages
\n # If this is true and the player doesn’t have ppn.notify permission, then their join\/leave\/message will not be sent.
\n notify_message: false<\/p>\n
# Hide Messages
\n # If this is true and the player doesn’t have ppn.view permission, then they won’t see the others’ join\/switch\/leave messages.
\n hide_message: false<\/p>\n
# Server Names
\n# Define custom server names here. Players can join\/leave\/switch to the server using the custom names specified below.
\nServerNames:
\n example: “example-1”
\n lobby: “Hub”<\/p>\n
# Disabled Servers
\n# Define the backend servers (lowercase) where the join\/switch\/leave messages should not be sent.
\n# In simple words, no messages of this plugin will be sent to players on that server
\n# In short: No activity notifications are sent to players on these servers.
\nDisabledServers:
\n – “example-1”
\n – “other-backend-server”<\/p>\n
# Private Servers
\n# Specify the private servers (lowercase) where if player joins, leaves, and switches from and to, notifications should not be sent.
\n# Think about them like admin servers
\n# When someone joins it, the whole proxy should not be notified about that because you kind of want to keep that server private\/secret and not let the players know.
\n# In short: Activity notifications related to these servers are not broadcasted across the entire network.
\nPrivateServers:
\n – “example”
\n – “private-server”<\/p>\n
# Limbo Servers
\n# Specify the limbo servers (lowercase) where player join, leave, and switch notifications should be managed differently.
\n# These servers act as pass-throughs most of the time and can be configured to adjust notification behavior accordingly.
\n# When a player joins a limbo server, no network-wide join notification is sent.
\n# When a player switches from a limbo server to a game server, it should send a join notification as if the player is joining the network for the first time.
\n# Conversely, when a player switches from a game server to a limbo server, it should send a leave notification as if the player is leaving the network.
\n# This configuration helps avoid unnecessary notifications and prevents stealthy movements between public and private parts of the network.
\n# In short: Join and leave notifications are sent based on transitions to and from these servers to manage network-wide notifications effectively.
\nLimboServers:
\n – “limbo-afk”<\/p>\n
# Disabled Players
\n# Specify the players (lowercase) that should not send any notification messages.
\n# They will also will not recieve join_private_message.
\n# It is not recommended to use this feature and instead use permissions for each group\/player
\nDisabledPlayers:
\n – “player1”
\n – “player2”<\/p>\n
# Webhook
\n# Configure a webhook notification sent when a player joins the network.
\n# Placeholders available: %player%, %server%, %time%.
\nwebhook:
\n enabled: false
\n url: “”
\n message: “%player% joined %server% at %time%”
\n # Send webhook as Discord embed (recommended). If true, the message above is used as the embed description.
\n use_embed: true
\n # Embed color as decimal RGB (e.g., 3447003 is Discord “blurple”).
\n embed_color: 3447003<\/p>\n
“`<\/p>\n
**Support**
\nGitHub Issues: https:\/\/github.com\/NewAmazingPVP\/ProxyPlayerNotify\/issues
\nDiscord: https:\/\/discord.gg\/u3u45vaV6G<\/p>\n
—<\/p>\n","protected":false},"excerpt":{"rendered":"
Notify when a player joins or leaves the network, or when they switch to another server!<\/p>\n","protected":false},"featured_media":125896,"template":"","meta":{"_minecraft_slug":"proxyplayernotify","_minecraft_project_id":"V83f26KD","_minecraft_author":"NewAmazingPVP","_minecraft_license":"MIT","_minecraft_downloads":78,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"proxyplayernotify.zip","_minecraft_size_bytes":2377985,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:15:05.758065Z","_minecraft_date_created":"2025-09-06T08:45:00.063854Z","_minecraft_date_modified":"2026-01-22T03:50:07.832993Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/proxyplayernotify","_minecraft_icon_attachment_id":125896,"_minecraft_imported_at":"2026-06-07T09:34:51+00:00","_minecraft_import_hash":"2e68152de51e0f93d5d663526c0b241f","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[894,156,126,92,985,992],"mod_loader":[895,986,993],"minecraft_version":[339,340,341,357,359,360,379,382,385,438,446,449,110,111,112,113,114,115,116,117,118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,21,13,14,15,16,17,18,19,20,22,23,24,25,26,27,28,29,30,31,860,861,862,863,864],"class_list":["post-125895","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bungeecord","mod_category-decoration","mod_category-management","mod_category-utility","mod_category-velocity","mod_category-waterfall","mod_loader-bungeecord","mod_loader-velocity","mod_loader-waterfall","minecraft_version-1-10","minecraft_version-1-10-1","minecraft_version-1-10-2","minecraft_version-1-11","minecraft_version-1-11-1","minecraft_version-1-11-2","minecraft_version-1-12","minecraft_version-1-12-1","minecraft_version-1-12-2","minecraft_version-1-13","minecraft_version-1-13-1","minecraft_version-1-13-2","minecraft_version-1-14","minecraft_version-1-14-1","minecraft_version-1-14-2","minecraft_version-1-14-3","minecraft_version-1-14-4","minecraft_version-1-15","minecraft_version-1-15-1","minecraft_version-1-15-2","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-1-7-10","minecraft_version-1-7-2","minecraft_version-1-7-3","minecraft_version-1-7-4","minecraft_version-1-7-5","minecraft_version-1-7-6","minecraft_version-1-7-7","minecraft_version-1-7-8","minecraft_version-1-7-9","minecraft_version-1-8","minecraft_version-1-8-1","minecraft_version-1-8-2","minecraft_version-1-8-3","minecraft_version-1-8-4","minecraft_version-1-8-5","minecraft_version-1-8-6","minecraft_version-1-8-7","minecraft_version-1-8-8","minecraft_version-1-8-9","minecraft_version-1-9","minecraft_version-1-9-1","minecraft_version-1-9-2","minecraft_version-1-9-3","minecraft_version-1-9-4"],"yoast_head":"\n