ProxyPlayerNotify
更多信息与指南: GitHub – ProxyPlayerNotify
最新构建版本(包含新功能与错误修复):GitHub Actions – ProxyPlayerNotify
功能介绍
支持全服范围的加入/离开/切换消息,具备按玩家开关、隐身支持、LuckPerms/PAPI 占位符以及可选的 Webhook 通知功能。
注意: 这是一个代理插件 —— 请安装在 BungeeCord/Waterfall 或 Velocity 上(不要安装在 Spigot/Paper 上)。
适用平台:BungeeCord/Waterfall, Velocity
使用方法
- 将其安装到你的代理服务器上并重启以生成配置文件。
- 自定义消息/占位符以及(可选的)Webhook 设置。
- 根据需要授予查看或切换权限。
配置文件 (YAML)
# ProxyPlayerNotify Config
# 此配置文件包含 ProxyPlayerNotify 插件的设置。
# 使用此文件来自定义加入/离开消息和权限。
# 使用 \n 来创建多行消息/发送给玩家的多条消息。
# 将消息设置为 "" 以不发送任何消息/空消息。
# 网络加入消息
# 当玩家加入网络时显示此消息。
# 可用占位符: %player%, %lp_prefix%, %lp_suffix%, %server%, %time%.
join_message: "%player% has joined the network (Logged in server: %server%) at %time%"
# 网络私有加入消息
# 此消息仅向加入网络的玩家显示。
# 它的优先级高于公共加入消息。
# 可用占位符: %player%, %lp_prefix%, %lp_suffix%, %server%, %time%.
join_private_message:
- "&aWelcome, %player%!"
- "&bYou have joined the server %server% at %time%."
- "Enjoy your stay!"
# 首次加入消息
# 当玩家首次加入网络时显示此消息。
# 可用占位符: %player%, %lp_prefix%, %lp_suffix%, %server%, %time%.
first_join_message: "%player% has joined the network for the first time on %server% at %time%"
# 首次加入私有消息
# 此消息仅向首次加入的玩家显示。
# 可用占位符: %player%, %lp_prefix%, %lp_suffix%, %server%, %time%.
first_join_private_message: "&aWelcome for the first time, %player%!"
# 服务器切换消息
# 当玩家切换到不同服务器时显示此消息。
# 可用占位符: %player%, %last_server%, %server%, %time%, %lp_prefix%, %lp_suffix%.
switch_message: "%player% has switched from %last_server% and joined to the %server% server at %time%"
# 网络离开消息
# 当玩家离开网络时显示此消息。
# 可用占位符: %player%, %lp_prefix%, %lp_suffix%, %last_server%, %time%.
leave_message: "%player% has left the network (Last server: %last_server%) at %time%"
# 加入消息延迟
# 此选项设置在玩家连接后发送加入消息之前的延迟时间。
# 例如,join_message_delay: 49 将在 49 tick 后发送消息。
# 警告:将此值设置得过低可能导致消息未发送或占位符为空(如果服务器名称尚不可用)。
join_message_delay: 45
# 首次加入消息延迟
# 此选项设置在玩家连接后发送首次加入消息之前的延迟时间。
first_join_message_delay: 10
# 私有加入消息延迟
# 此选项设置在向加入玩家发送私有加入消息之前的延迟时间。
# 例如,join_private_message_delay: 50 将在 50 tick 后发送消息。
# 警告:将此值设置得过低可能导致消息未发送或占位符为空(如果服务器名称尚不可用)。
join_private_message_delay: 50
# 首次加入私有消息延迟
# 此选项设置在向加入玩家发送首次加入私有消息之前的延迟时间。
first_join_private_message_delay: 10
# 切换消息延迟
# 此选项设置在玩家切换服务器后发送切换消息之前的延迟时间。
# 例如,switch_message_delay: 0 将在 0 tick 后立即发送消息。
switch_message_delay: 0
# 禁用隐身玩家的 notify 消息(目前支持 PremiumVanish 和 SuperVanish)
disable_vanish_notifications: false
# 允许玩家在离开网络后重新加入他们之前所在的服务器。
# 如果启用此选项,玩家将在加入时被发送回他们在离开网络前所在的最后一个服务器。
# 如果启用,则需要增加消息延迟选项,以便消息能够获取到服务器名称
join_last_server: false
# 为所有消息启用 MiniMessage 格式解析
use_minimessage: false
# 权限设置
# 使用这些设置来控制谁能看到加入/离开消息。
# 如果你希望使用权限功能并使用以下两个选项,请启用权限。
# 如果启用了权限,且 notify_message 为 true,而玩家没有 ppn.notify 权限,则他们的加入/离开/消息将不会发送。
# 如果启用了权限,且 hide_message 为 true,而玩家没有 ppn.view 权限,则他们将看不到其他人的加入/切换/离开消息。
permission:
# 如果你希望使用权限功能并使用以下两个选项,请启用此项。
permissions: false
# 通知消息
# 如果此项为 true,且玩家没有 ppn.notify 权限,则他们的加入/离开/消息将不会发送。
notify_message: false
# 隐藏消息
# 如果此项为 true,且玩家没有 ppn.view 权限,则他们将看不到其他人的加入/切换/离开消息。
hide_message: false
# 服务器名称
# 在此处定义自定义服务器名称。玩家可以使用下面指定的自定义名称加入/离开/切换到该服务器。
ServerNames:
example: "example-1"
lobby: "Hub"
禁用的服务器
定义后端服务器(小写),在这些服务器上不应发送加入/切换/离开消息。
简单来说,此插件不会向这些服务器上的玩家发送任何消息。
简而言之:不会向这些服务器上的玩家发送活动通知。
DisabledServers:
- "example-1"
- "other-backend-server"
私有服务器
指定私有服务器(小写),当玩家在这些服务器上加入、离开或从这些服务器切换时,不发送通知。
可以将它们视为管理员服务器。
当有人加入此类服务器时,整个代理网络都不应收到关于该事件的通知,因为你希望保持该服务器的私密性/隐秘性,不让玩家知晓。
简而言之:与这些服务器相关的活动通知不会在整个网络中广播。
PrivateServers:
- "example"
- "private-server"
Limbo 服务器
指定 Limbo 服务器(小写),在这些服务器上玩家的加入、离开和切换通知应以不同方式处理。
这些服务器通常作为中转站,可以配置以相应地调整通知行为。
当玩家加入 Limbo 服务器时,不发送全网范围的加入通知。
当玩家从 Limbo 服务器切换到游戏服务器时,应发送加入通知,仿佛玩家是首次加入网络。
相反,当玩家从游戏服务器切换到 Limbo 服务器时,应发送离开通知,仿佛玩家正在离开网络。
此配置有助于避免不必要的通知,并防止在网络的公共部分和私密部分之间进行隐蔽移动。
简而言之:根据与这些服务器的进出转换来发送加入和离开通知,以有效管理全网通知。
LimboServers:
禁用的玩家
指定不应发送任何通知消息的玩家(小写)。
他们也不会收到 join_private_message。
不建议使用此功能,而是建议为每个组/玩家使用权限控制。
DisabledPlayers:
Webhook
配置当玩家加入网络时发送的 webhook 通知。
可用的占位符:%player%、%server%、%time%。
webhook:
enabled: false
url: ""
message: "%player% joined %server% at %time%"
以 Discord 嵌入形式发送 webhook(推荐)。如果为 true,则上述消息用作嵌入描述。
use_embed: true
嵌入颜色为十进制 RGB(例如,3447003 是 Discord 的“blurple”色)。
embed_color: 3447003
**支持**
GitHub Issues: https://github.com/NewAmazingPVP/ProxyPlayerNotify/issues
Discord: https://discord.gg/u3u45vaV6G
---
ProxyPlayerNotify
More info & guide: GitHub – ProxyPlayerNotify
Latest builds (features + bug fixes): GitHub Actions – ProxyPlayerNotify
What it does
Network-wide join/leave/switch messages with per-player toggles, vanish support, LuckPerms/PAPI placeholders, and optional webhook ping.
Note: This is a proxy plugin — install on BungeeCord/Waterfall or Velocity (not on Spigot/Paper).
Works on: BungeeCord/Waterfall, Velocity
How to use
- Install on your proxy and restart to generate the config.
- Customize messages/placeholders and (optionally) webhook settings.
- Grant the view/toggle permissions as needed.
Config (YAML)
# ProxyPlayerNotify Config
# This config file contains settings for the ProxyPlayerNotify plugin.
# Use this file to customize the join/leave messages and permissions.
# Use \n to create multiple lines/messages to players.
# Set message to "" to not send any message/empty.
# Network Join Message
# This message is displayed when a player joins the network.
# Placeholders available: %player%, %lp_prefix%, %lp_suffix%, %server%, %time%.
join_message: "%player% has joined the network (Logged in server: %server%) at %time%"
# Network Private Join Message
# This message is displayed only to the player who joins the network.
# It has a higher priority than the public join message.
# Placeholders available: %player%, %lp_prefix%, %lp_suffix%, %server%, %time%.
join_private_message:
- "&aWelcome, %player%!"
- "&bYou have joined the server %server% at %time%."
- "Enjoy your stay!"
# First Join Message
# This message is displayed when a player joins the network for the first time.
# Placeholders available: %player%, %lp_prefix%, %lp_suffix%, %server%, %time%.
first_join_message: "%player% has joined the network for the first time on %server% at %time%"
# First Join Private Message
# This message is displayed only to the player joining for the first time.
# Placeholders available: %player%, %lp_prefix%, %lp_suffix%, %server%, %time%.
first_join_private_message: "&aWelcome for the first time, %player%!"
# Servers Switch Message
# This message is displayed when a player switches to a different server.
# Placeholders available: %player%, %last_server%, %server%, %time%, %lp_prefix%, %lp_suffix%.
switch_message: "%player% has switched from %last_server% and joined to the %server% server at %time%"
# Network Leave Message
# This message is displayed when a player leaves the network.
# Placeholders available: %player%, %lp_prefix%, %lp_suffix%, %last_server%, %time%.
leave_message: "%player% has left the network (Last server: %last_server%) at %time%"
# Delay for Join Messages
# This option sets the delay before sending the join message after a player connects.
# For example, join_message_delay: 49 will send the message after 49 ticks.
# 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.
join_message_delay: 45
# Delay for First Join Messages
# This option sets the delay before sending the first join message after a player connects.
first_join_message_delay: 10
# Delay for Private Join Messages
# This option sets the delay before sending the private join message to the joining player.
# For example, join_private_message_delay: 50 will send the message after 50 ticks.
# 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.
join_private_message_delay: 50
# Delay for First Join Private Messages
# This option sets the delay before sending the first join private message to the joining player.
first_join_private_message_delay: 10
# Delay for Switch Messages
# This option sets the delay before sending the switch message after a player switches servers.
# For example, switch_message_delay: 0 will send the message after 0 ticks.
switch_message_delay: 0
# Disable messages for vanished players (Currently supports PremiumVanish and SuperVanish)
disable_vanish_notifications: false
# Option to let players rejoin the server they were on before they left the network.
# 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.
# If enabled, the message delay options would need to be increased so that the messages can get the server
join_last_server: false
# Enable MiniMessage format parsing for all messages
use_minimessage: false
# Permissions
# Use these settings to control who can see the join/leave messages.
# Enable permissions if you want to use permissions and want to use next two options.
# 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.
# 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.
permission:
# Enable this if you want to use permissions and want to use next two options.
permissions: false
# Notify Messages
# If this is true and the player doesn't have ppn.notify permission, then their join/leave/message will not be sent.
notify_message: false
# Hide Messages
# If this is true and the player doesn't have ppn.view permission, then they won't see the others' join/switch/leave messages.
hide_message: false
# Server Names
# Define custom server names here. Players can join/leave/switch to the server using the custom names specified below.
ServerNames:
example: "example-1"
lobby: "Hub"
# Disabled Servers
# Define the backend servers (lowercase) where the join/switch/leave messages should not be sent.
# In simple words, no messages of this plugin will be sent to players on that server
# In short: No activity notifications are sent to players on these servers.
DisabledServers:
- "example-1"
- "other-backend-server"
# Private Servers
# Specify the private servers (lowercase) where if player joins, leaves, and switches from and to, notifications should not be sent.
# Think about them like admin servers
# 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.
# In short: Activity notifications related to these servers are not broadcasted across the entire network.
PrivateServers:
- "example"
- "private-server"
# Limbo Servers
# Specify the limbo servers (lowercase) where player join, leave, and switch notifications should be managed differently.
# These servers act as pass-throughs most of the time and can be configured to adjust notification behavior accordingly.
# When a player joins a limbo server, no network-wide join notification is sent.
# 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.
# 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.
# This configuration helps avoid unnecessary notifications and prevents stealthy movements between public and private parts of the network.
# In short: Join and leave notifications are sent based on transitions to and from these servers to manage network-wide notifications effectively.
LimboServers:
- "limbo-afk"
# Disabled Players
# Specify the players (lowercase) that should not send any notification messages.
# They will also will not recieve join_private_message.
# It is not recommended to use this feature and instead use permissions for each group/player
DisabledPlayers:
- "player1"
- "player2"
# Webhook
# Configure a webhook notification sent when a player joins the network.
# Placeholders available: %player%, %server%, %time%.
webhook:
enabled: false
url: ""
message: "%player% joined %server% at %time%"
# Send webhook as Discord embed (recommended). If true, the message above is used as the embed description.
use_embed: true
# Embed color as decimal RGB (e.g., 3447003 is Discord "blurple").
embed_color: 3447003
Support
GitHub Issues:
Discord:
评论 0
登录后参与评分
还没有评论,来抢沙发吧