BungeeFriends & BungeeParties - 好友与队伍系统

BungeeFriends 是一款功能强大的 BungeeCord 好友与组队管理插件，支持跨服好友、私聊、组队及前缀同步。本指南将详细介绍其安装、配置与使用方法。

💡重要须知

• 本插件需要 BungeeCord 或 Waterfall 等代理端。
• Spigot 上的构建版本不受支持。
• 官方测试服务器：play.mineformat.net (支持 1.8-1.17)
• 如有疑问，可通过以下方式联系作者：

-   Spigot PM (参与者填写 `SimplyRin_`)

-   Twitter DM

-   电子邮件

🎮依赖与权限

必需插件

• LuckPerms Bungee

-   必须在 BungeeCord 端安装 LuckPerms，以实现跨服权限和前缀同步。

-   通过 MySQL 或正确配置，可同时管理 BungeeCord 与 Spigot 的权限。

管理员权限

• friends.command.admin - 使用以下管理员命令所必需的权限：

-   `/friend force-add`

-   `/friend prefix`

-   `/friend reload`

-   `/friend lang update`

🔧命令列表

玩家命令

在游戏内使用 /friend help 查看完整的玩家命令帮助。

管理员命令 (游戏内)

• /friend force-add <玩家> - 强制与指定玩家成为好友。
• /friend prefix <玩家> <前缀> - 设置玩家的前缀。
• /friend lang update - 检查并更新语言文件。
• /friend reload - 重载插件配置。

控制台专用命令

• /friendconsole prefix <玩家> <前缀> - 从控制台设置玩家前缀。
• /friendconsole lang <语言代码> - 更改控制台显示的语言。
• /friendconsole reload - 从控制台重载插件配置。

✨功能配置

禁用别名命令

编辑 config.yml，将对应命令的值改为 true 即可禁用。

Plugin:
  Disable-Aliases:
    /msg: false
    /f: false
    /r: false
    /reply: false
    /fl: false
    /pc: false
    /tell: false
    /message: false
    /w: false
    /whisper: false

设置服务器显示名称

编辑 config.yml 中的 ServerName 部分，可以自定义服务器在消息中的显示名。

Plugin:
  ServerName:
    '1':
      Type: startsWith
      ServerName: lobby
      ReplaceName: 大厅
    '2':
      Type: contains
      ServerName: game
      ReplaceName: 游戏区
    '3':
      Type: equalsIgnoreCase
      ServerName: sw-1
      ReplaceName: 空岛战争

匹配类型 (Type) 说明：

• startsWith：服务器名以此字符串开头时替换。
• contains：服务器名包含此字符串时替换。
• equalsIgnoreCase：服务器名完全匹配此字符串时替换（不区分大小写）。

启用 BungeeParties 组队功能

在 config.yml 中启用组队功能。

Plugin:
  Enable-BungeeParties: true # false 为禁用

禁用组队传送

当队伍队长切换服务器时，是否自动传送队员。设为 true 则禁用。

Plugin:
  Disable-PartyWarp: false # true 为禁用

禁用服务器切换通知

玩家切换服务器时是否显示通知。设为 true 则禁用。

Plugin:
  Disable-ServerSwitchNotifer: true # false 为显示通知

⭐前缀设置 (已弃用)

> 重要提示：prefix.yml 已在 v2.1.3 版本中移除。官方推荐使用 LuckPerms Bungee 来管理和同步玩家前缀。

如需自行承担风险重新启用旧的 prefix.yml 方式，请在 config.yml 中设置：

Plugin:
  Enable-Deprecated-PrefixYml: true

注意：启用此选项后将无法获得官方支持。

🔧MySQL 配置

编辑 mysql.yml 文件以启用数据库存储。请注意，仅好友列表和前缀数据会存入 MySQL，其他数据不会保存。

Enable: true
DebugMode: false
Username: root
Password: PASSWORD
Address: localhost:3306
Database: bungeefriends
Timezone: JST
UseSSL: false

❓API 使用 (自行负责，已弃用)

将插件 Jar 包导入 Maven 项目后，可通过以下方式访问 API：

<dependency>
    <groupId>net.simplyrin.bungeefriends</groupId>
    <artifactId>BungeeFriends</artifactId>
    <version>2.0.4</version>
    <scope>system</scope>
    <systemPath>${basedir}/libs/BungeeFriends-2.0.4.jar</systemPath>
</dependency>

BungeeFriends api = BungeeFriends.getAPI();
ProxiedPlayer player = ProxyServer.getInstance().getPlayer("SimplyRin");

// 获取好友列表
FriendUtils friendUtils = api.getFriendUtils(player.getUniqueId());
List<UUID> friends = friendUtils.getFriendsUniqueId();

// 获取队伍成员
PartyUtils partyUtils = api.getPartyUtils(player.getUniqueId());
List<String> members = partyUtils.getParties();