Friends for Spigot (MC1.8.X - 1.17.X) - Friends for Spigot

FriendsRELOADED 是一款功能强大的好友系统插件，拥有丰富的选项和图形界面（GUI）来管理一切！它让玩家可以轻松添加好友、组建队伍、发送消息，并通过直观的菜单进行各种互动。将这款插件安装到你的服务器上，即可享受便捷的好友与社交管理体验。

💡重要须知

在给予差评前，请仔细阅读本文档并先联系作者寻求帮助。请将遇到的漏洞、问题或建议发布在插件的“讨论区”中。

如果你正在寻找适用于 BungeeCord 网络的版本，请查看 FriendsPremium，它是 FriendsRELOADED 的优化版，功能更丰富。

🎮核心功能

• 高度可配置：所有消息均可自定义。
• Base64 支持：可为物品创建自定义皮肤。
• 扩展的 GUI：用于管理好友和队伍。
• 好友管理：管理好友、请求和屏蔽的玩家。
• 状态系统：玩家和好友可设置状态来展示当前心情。
• 好友信息：查看成为好友的时间、最后在线时间以及所在服务器/世界。
• 好友聊天：与所有好友进行群聊（可禁用）。
• 私密消息：向好友发送私人消息。
• 语言过滤：可检查各类消息中是否包含不当用语。
• 传送功能：可跳转到好友所在的服务器/位置。
• 加入/退出通知。
• 可点击的消息。
• 屏蔽玩家：阻止他们向你发送消息和好友请求。
• 完整的队伍系统（可禁用）：

- 邀请好友并一起加入服务器。

- 专用的队伍聊天频道。

- 在队伍内提升或降级玩家权限。

- 完全集成在 GUI 中。

🔧配置摘要

以下是配置文件 config.yml 中的部分关键设置概览：

基础设置

• Prefix: "&bFriends &7|"
• CheckForUpdates: true
• CommandAliases: [f, friend, freund, freunde]
• FriendLimit: 20 （默认好友数量上限）
• FriendLimitExtended: 50 （拥有 Friends.FriendLimit.Extended 权限的玩家可拥有更多好友）
• DateFormat: "MM/dd/yyyy" （日期显示格式）

物品与功能选项

• FriendItemOptions:

- `KeepOnDeath`: true （好友物品死亡后保留）

- `JoinQuitMessages`: true （启用加入/退出通知）

- `FriendsCanPvP`: false （好友间是否可以互相造成伤害）

- `HitToSendRequest`: true （用好友头颅击中玩家可发送好友请求）

状态与昵称

• Status:

- `EnableFilter`: true （启用状态语言过滤）

- `MaxLenght`: 30 （状态最大长度）

- `ChangeDuration`: 600 （状态更改冷却时间，秒）

- `AllowFarbcodes`: false （是否允许在状态中使用颜色代码）

• Nicknames:

- `Enable`: true （启用昵称功能）

- `CheckForAbusiveWords`: true （检查昵称是否包含不当用语）

聊天与消息

• FriendChat:

- `Enable`: true （启用好友聊天）

- `Format`: `"@friends"` （触发好友聊天的前缀）

- `CheckForAbusiveWords`: true （检查聊天内容）

• FriendMSG:

- `Enable`: true （启用私人消息）

- `CheckForAbusiveWords`: true

- `UseMSGCommand`: true （允许使用 `/msg <玩家> <消息>` 格式）

命令与交互

• Commands:

- `EnableClickableMessages`: true （启用可点击的消息）

- `AddMessage`: （添加好友时可附加个人备注）

- `Enable`: true

- `CharacterLimit`: 40

- `BlockNote`: （屏蔽玩家时可附加备注）

- `Enable`: true

- `CharacterLimit`: 40

传送与物品

• Jumping:

- `Enable`: true （启用传送功能）

- `DisabledWorlds`: `[world_end, world_nether]` （禁止传送的世界列表）

• FriendItem:

- `Enable`: true （启用在物品栏中显示好友物品）

- `Name`: `"&aFriends &7(Rightclick)"`

- `Material`: `"player_head"`

- `Lore`: `"//&7Rightclick this item to open the//&7friend-inventory!"`

- `InventorySlot`: 4

- `DelayedInventorySet`: false

GUI 设置

• OpenGUIWithCommand: true （允许使用 /friends 命令打开 GUI）
• 提供了 FriendInventory、FriendEditInventory、RequestsInventory、RequestEditInventory、OptionsInventory 等多个图形界面的详细配置选项，包括标题、大小、物品材质、名称、描述（Lore）和槽位等。
• 支持使用 Base64 值自定义物品皮肤。

✨使用与支持

• 请确保在编辑配置文件时，正确使用引号和有效的材质名称。
• 材质列表可参考：https://www.digminecraft.com/lists/item_id_list_pc.php
• 轻微的配置错误也可能导致插件无法正常工作，请谨慎修改。
• 如需获取自定义头颅的 Base64 值，可访问：https://minecraft-heads.com