## ProxyPlayerNotify
**更多信息、指南和最新版本:** [GitHub – ProxyPlayerNotify](https://github.com/NewAmazingPVP/ProxyPlayerNotify)
**它做什么**
全网络 **加入/离开/切换** 消息,带有每个玩家的开关、隐身支持、LuckPerms/PAPI 占位符和可选的 webhook 提醒。
> **注意:** 这是一个 **代理** 插件 — 安装在 **BungeeCord/Waterfall** 或 **Velocity** (而不是 Spigot/Paper) 上。
**适用于**: BungeeCord/Waterfall, Velocity
**如何使用**
1. 安装在你的 **代理** 上并重启以生成配置文件。
2. 自定义消息/占位符和 (可选) webhook 设置。
3. 授予查看/切换权限,如需要。
**配置文件 (YAML)**
```yaml
# ProxyPlayerNotify 配置文件
# 此配置文件包含 ProxyPlayerNotify 插件的设置。
# 使用此文件自定义加入/离开消息和权限。
# 使用 \n 创建多行/消息发送给玩家。
# 将 message 设置为 "" 则不发送任何消息/空.
# 网络加入消息
# 此消息在玩家加入网络时显示。
# 占位符可用:%player%,%lp_prefix%,%lp_suffix%,%server%,%time%。
join_message: "%player% 已加入网络 (登录服务器:%server%) 在 %time%"
# 网络私密加入消息
# 此消息仅向加入网络的玩家显示。
# 它的优先级高于公共加入消息。
# 占位符可用:%player%,%lp_prefix%,%lp_suffix%,%server%,%time%。
join_private_message:
- "&a欢迎, %player%!"
- "&b你已加入服务器 %server% 在 %time%."
- "享受你的停留!"
# 首次加入消息
# 此消息在玩家第一次加入网络时显示。
# 占位符可用:%player%,%lp_prefix%,%lp_suffix%,%server%,%time%。
first_join_message: "%player% 第一次加入网络在 %server% 在 %time%"
# 首次加入私密消息
# 此消息仅向第一次加入的玩家显示。
# 占位符可用:%player%,%lp_prefix%,%lp_suffix%,%server%,%time%。
first_join_private_message: "&a欢迎初次光临, %player%!"
# 服务器切换消息
# 此消息在玩家切换到不同的服务器时显示。
# 占位符可用:%player%,%last_server%,%server%,%time%,%lp_prefix%,%lp_suffix%。
switch_message: "%player% 已从 %last_server% 切换到 %server% 服务器在 %time%"
# 网络离开消息
# 此消息在玩家离开网络时显示。
# 占位符可用:%player%,%lp_prefix%,%lp_suffix%,%last_server%,%time%。
leave_message: "%player% 已离开网络 (上次服务器:%last_server%) 在 %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
# 禁用隐身玩家的消息 (目前支持 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"
# 限时服务器
# 指定限时服务器 (小写),其中玩家的加入、离开和切换通知应以不同的方式管理。
# 这些服务器通常充当中继,并且可以配置为相应地调整通知行为。
# 当玩家加入限时服务器时,不会发送网络范围内的加入通知。
# 当玩家从限时服务器切换到游戏服务器时,应该发送加入通知,就像玩家第一次加入网络一样。
# 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.
# 简而言之:基于到和从这些服务器的转换发送加入和离开通知,以有效地管理网络范围内的通知。
LimboServers:
- "limbo-afk"
# 禁用玩家
# 指定不应发送任何通知消息的玩家 (小写)。
# 他们也将不会收到 join_private_message。
# 不建议使用此功能,而应该为每个组/玩家使用权限
DisabledPlayers:
- "player1"
- "player2"
# Webhook
# 配置在玩家加入网络时发送的 webhook 通知。
# 占位符可用:%player%,%server%,%time%。
webhook:
enabled: false
url: ""
message: "%player% 加入 %server% 在 %time%"
# 将消息作为 Discord 嵌入发送 (推荐)。如果为 true,则使用上面的消息作为嵌入描述。
use_embed: true
# 以十进制 RGB 颜色表示嵌入颜色 (例如,3447003 是 Discord "blurple")。
embed_color: 3447003
```
**支持**
GitHub Issues: https://github.com/NewAmazingPVP/ProxyPlayerNotify/issues
Discord: https://discord.gg/u3u45vaV6G
---