PlayerChannels [Chat Channels] [GUI] [Cross-server messaging] - PlayerChannels

赋予玩家创建专属聊天频道的能力！

PlayerChannels 是一款轻量、高度集成的聊天频道/聊天室插件，完全通过一系列菜单进行操作，并可根据您的喜好进行深度配置。其设计旨在让玩家能够完全掌控自己的频道，按需管理，同时不与服务器频道冲突。它既可作为玩家小组的简易队伍聊天，也可作为拥有独立管理体系和昵称等功能的复杂聊天系统。此外，如果您禁止玩家创建频道，它也能作为服务器频道使用，用途极为广泛。

💡核心特性

• 跨服支持：支持 BungeeCord，自 3.7 版本起支持跨服务器消息传递。
• MySQL 支持：为 BungeeCord 服务器新增 MySQL 支持。
• 全面的 GUI 操作：所有频道功能均基于图形菜单。
• 深度自定义：通过 menus.yml 自定义菜单，通过 messages.yml 自定义消息。
• 智能消息系统：在菜单内也能清晰显示聊天消息。
• 频道内管理：支持禁言、封禁、踢出成员，并可晋升成员为频道管理员或所有者。
• 智能菜单：记住您上次离开的位置。
• 昵称系统：可开关昵称功能，玩家可设置自己的昵称或由他人设置。
• 频道保存：频道可永久保存。
• 公开/私密频道：可创建公开或私密频道。
• 玩家个人资料：玩家可管理邀请接收状态并设置个人状态（类似“墙”功能）。
• 无限制加入：可加入任意数量的聊天室。
• 快速聊天：支持快速向特定频道发送消息或专注于某个频道。
• 监听控制：使用 /pc listen 子命令可屏蔽来自其他频道（如全局聊天）的消息。
• 命令创建：使用 /pc create 子命令可通过命令创建聊天室（无需菜单）。
• 新手引导：独特的菜单消息系统，引导玩家创建频道。
• 管理功能：管理员菜单可用于监视、删除频道及重载插件。
• 隐藏频道：可创建仅对成员和管理员可见的隐藏频道（需权限 playerchannels.hide）。
• 服务器频道：新增可独立存在、无需成员的服务器频道。
• 非 GUI 操作：新增子命令，支持不通过 GUI 使用 PlayerChannels。
• @提及功能：可在频道内提及（Ping）其他玩家。
• 智能命令补全：智能自动补全命令，可填入相应的频道名称。

🎮如何使用

聊天方式

有三种方式在 PlayerChannels 中发送消息：

• “In Chat”模式：在频道菜单中点击“In Chat”按钮，之后所有消息都将发送至该频道。
• @前缀：在消息前加上 @ 前缀。此方法仅在你只加入了一个聊天室时有效。
• 快速编号：在消息前加上频道序号和冒号。例如：你加入了“A”、“B”、“C”三个频道。输入 1: 大家好！ 消息会发送到频道“A”；2: 再见！ 会发送到频道“B”，依此类推。

命令与权限

• 主命令：/playerchannels（可在 config.yml 中自定义）。默认别名：/pc、/channels、/chatrooms。
• 管理员命令：/pcadmin（需权限 playerchannels.admin）。
• 监听控制：/pc listen（选择要接收消息的频道）。
• 创建频道：/pc create（通过命令创建聊天室）。
• 保存权限：playerchannels.saved（允许玩家保存其聊天室）。
• 隐藏频道权限：playerchannels.hide（允许创建隐藏频道）。

🔧配置文件概述

PlayerChannels 的配置主要通过三个 YAML 文件实现，请勿随意添加不存在的配置键。

config.yml

主要设置插件基础行为。

# 是否允许在插件内使用聊天颜色（频道名、玩家状态等）
chat-colors: true
# 主命令名称
command-name: "playerchannels"
# 命令别名
aliases:
  - "pc"
  - "chatrooms"
  - "channels"
# 保存频道的物品材质
saved-material: "OAK_SIGN"
# 快速聊天前缀（@前缀）
quickchat-prefix: "@"
# 聊天消息格式
chatroom-message-format: "&7[&e$chatroom$&7] &e$role$ $nickname$ &7➤ &e$message$"
# 是否启用 BungeeCord 支持
bungeecord: false

**可用占位符**

• $role$：玩家在频道中的角色（如 Member, Moderator, Owner，值在 messages.yml 中定义）。
• $chatroom$：消息发送所在的频道名称。
• $nickname$：玩家在频道中的昵称。如果未设置或已禁用，则回退到 $name$。
• $name$：玩家的真实 Minecraft 名称。

menus.yml

用于自定义所有菜单的布局、物品和位置。注意：更改物品槽位时，若数字过大可能导致物品消失。请参考默认文件结构进行修改。

messages.yml

用于自定义插件中显示的所有文本消息。注意：只能在默认已使用占位符的消息中使用相应的占位符，请勿随意添加。

✨安装方法

• 将插件文件拖放至服务器的 plugins 文件夹。
• 重启服务器。

如需帮助，请在 Spigot 讨论页面寻求支持。感谢使用！