MSG Plugin - MSG 私信插件

MSG 是一款功能全面的私信插件，允许玩家之间发送私人消息，并支持单服务器与 BungeeCord 网络环境。它提供了丰富的命令、权限控制和高度可自定义的消息格式，满足不同服务器的管理需求。

💡核心功能

• 支持在单服务器或 BungeeCord 网络上发送私信。
• 提供回复 (/r) 功能，快速回复最后一条消息的发送者。
• 允许玩家屏蔽 (/msg ignore) 其他玩家的私信。
• 提供私信开关 (/msg toggle)，可全局启用或禁用接收私信。
• 内置消息窥探 (/msg spy) 功能，供管理员监控玩家间的私信。
• 支持通过 PlaceholderAPI 在配置中使用丰富的变量。
• 开发者可通过 PlayerSendMessageEvent 和 PlayerRepliedEvent 进行二次开发。

🎮命令列表

发送与管理私信

• /msg <player> <message> 或 /tell <player> <message> - 向指定玩家发送私信。
• /r <message> 或 /reply <message> - 回复最后一条私信的发送者。
• /msg toggle - 开启或关闭接收私信。

屏蔽与解除屏蔽

• /msg ignore <Player> (或 /msg block//msg mute) - 屏蔽指定玩家，使其无法向你发送私信。
• /msg unignore <Player> (或 /msg unblock//msg unmute) - 解除对指定玩家的屏蔽。

消息窥探 (Spy)

• /msg spy <Player, All, List> - 开始窥探特定玩家、所有玩家或查看当前窥探列表。
• /msg unspy <Player, All> - 停止窥探特定玩家或所有人。

管理命令

• /msg reload - 重载插件配置与玩家数据。

✨权限节点

• msg.use - 使用 /msg 和 /tell 命令。
• msg.reply - 使用 /r 和 /reply 命令。
• msg.toggle - 使用 /msg toggle 命令。
• msg.ignore - 使用 /msg ignore 和 /msg unignore 命令。
• msg.spy - 使用 /msg spy 和 /msg unspy 命令。
• msg.reload - 使用 /msg reload 命令。
• msg.updatecheck - 接收插件更新通知。
• msg.* - 获得本插件的所有权限。

🔧配置概述

配置文件 (config.yml) 允许你自定义消息格式、声音和功能开关。你可以使用插件内置变量（如 %prefix%, %targetName%, %senderName%, %message%）或 PlaceholderAPI 的变量。

主要配置项包括

• check_for_updates: 是否检查更新。
• spy_function: 是否启用窥探功能。
• play_sound: 发送私信时是否播放音效。
• sound, sound_volume, sound_pitch: 音效类型、音量与音高设置。
• prefix: 插件消息前缀。
• 各类消息文本，如 sender_message (发送者看到的格式)、receiver_message (接收者看到的格式)、spy_message (窥探者看到的格式) 等。
• aliases: 命令别名设置。

⭐自定义组格式

插件支持为不同权限组的玩家设置独立的私信显示格式。此功能通过 group_format.yml 文件配置。

启用与配置

• 在插件目录中找到 group_format.yml。
• 将 enabled 从 false 改为 true。
• 在 groups 部分下，复制现有模板，修改组名、权限节点 (permission) 以及对应的 sender 和 receiver 消息格式。
• 如果玩家没有匹配到任何组格式，将使用 config.yml 中定义的默认格式。

示例格式

groups:
  admin:
    sender: '%prefix% &cYou &8➔ &c%targetName% &8➔ &7%message%'
    receiver: '%prefix% &c%senderName% &8➔ &cYou &8➔ &7%message%'
    permission: group.admin

在此文件中，同样支持使用插件内置变量和 PlaceholderAPI 变量。

❓安装指南

单服务器安装

• 下载插件 JAR 文件。
• 将其放入服务器的 plugins 文件夹。
• 设置相关权限（可通过权限插件）。
• 重启服务器。
• 安装完成。

BungeeCord 网络安装

• 下载插件 JAR 文件。
• 仅将其放入 BungeeCord 代理服务器的 plugins 文件夹（不要安装在子服）。
• 在代理端设置相关权限。
• 重启 BungeeCord 代理。
• 安装完成。

🔧依赖说明

• PlaceholderAPI (可选但推荐)
• 支持在 config.yml 和 group_format.yml 中使用 PlaceholderAPI 的变量。
• 使用前，必须在服务器上安装 PlaceholderAPI 及其所需的变量扩展包。