AceChat - 多功能聊天格式插件

AceChat 是一款功能丰富的 JSON 聊天格式与管理插件。它完全可配置，拥有众多特性，并且你无需编写任何一行 JSON 代码！

💡核心特性

• 强大的聊天格式系统

- 完全可配置的悬停提示与点击事件。

- 优雅的聊天格式系统，支持按权限组设置不同格式。

- 所有消息（聊天、加入/离开、私信）均支持 JSON 格式，无需 JSON 知识。

• 全面的聊天管理

- 可配置的加入与离开消息。

- 简单的私信系统 (`/tell`, `/reply`)。

- 全局聊天静音与聊天清除功能。

- 社交间谍功能，可查看他人的私信。

• 广泛的兼容性与支持

- 支持 PlaceholderAPI 和 Vault。

- 兼容 Minecraft 1.8 及以上版本。

- 配置文件注释详尽，易于理解与修改。

🎮命令列表

主命令

• /chat (别名: /acechat, /ac)

- `/chat clear` - 清除全局聊天记录。

- `/chat mute` - 切换全局聊天静音状态。

- `/chat version` - 显示当前 AceChat 版本。

- `/chat reload` - 重载所有配置文件。

- `/chat help` - 显示包含所有命令的帮助页面。

- `/chat spy` - 启用/禁用社交间谍模式。

私信命令

• /tell (别名: /pm, /message, /msg, /t, /whisper) - 向其他玩家发送私信。
• /reply (别名: /r) - 回复你收到的上一条私信。

🔧权限节点

管理员权限 (`acechat.admin.*`)

• acechat.admin.clearchat - 允许用户清除聊天。
• acechat.admin.version - 允许用户查看 AceChat 版本。
• acechat.admin.help - 允许用户查看 /chat 的帮助页面。
• acechat.admin.reload - 允许用户重载插件。
• acechat.admin.clearchat.bypass - 允许用户在聊天被清除时不受影响（看不到清除效果）。
• acechat.admin.mutechat - 允许用户静音全局聊天。
• acechat.admin.mutechat.bypass - 允许用户在全局聊天静音时仍可发言。
• acechat.admin.socialspy - 允许用户通过 /chat spy 启用/禁用社交间谍。

用户权限 (`acechat.user.*`) - 默认授予所有玩家

• acechat.user.chat - 允许用户发送聊天消息。
• acechat.user.msg - 允许用户发送私信及回复。

其他权限

• acechat.color - 允许用户在消息中使用颜色代码。

✨配置文件详解

所有配置文件始终保持最新。你可以在插件文件夹的 formats/ 目录下创建格式文件，文件名需与 config.yml 中指定的名称匹配（无需 .yml 扩展名）。

config.yml 主要选项

• formats: 定义各类消息的格式文件。

- `chat`: 全局聊天格式。可设置为单一格式（如 `'chat'`），或按权限组配置。

- `private-sender` / `private-receiver`: 私信的发送方与接收方格式。

- `join` / `leave`: 加入与离开消息格式，同样支持按权限组配置。

• clear-length: 清除聊天时删除的行数（默认 102 行，以确保清空）。
• jl-none-on-none: 当加入/离开格式设为 'none' 时，是否完全不显示任何消息。
• event-priority: 插件事件优先级（通常建议保持默认的 HIGHEST）。

格式文件示例 (chat.yml)

格式文件由多个可配置的“部分”组成，每个部分可独立设置文本、悬停提示和点击动作。

parts:
  1:
    text: '&b%vault_prefix% '
    hover: '&bRank: &7%vault_rank%'
    click:
      type: 'SUGGEST_COMMAND'
      text: '/buy'
  2:
    text: '%player-nick% &8> '
    hover: '&bReal name: &7%player%'
    click:
      type: 'SUGGEST_COMMAND'
      text: '/pm %player%'
  3:
    text: '&f%message%'

**内置占位符**

• %player%: 玩家用户名。
• %player-nick%: 玩家显示名。
• %other%: 相关其他玩家的用户名（如适用）。
• %other-nick%: 相关其他玩家的显示名（如适用）。
• %message%: 用户输入的消息内容。

❓计划中的功能

• 手持物品展示。
• 玩家提及功能。
• 聊天规则（如 /rules、脏话过滤、链接过滤等）。
• 管理聊天频道。
• 加入时的 MOTD 消息。
• 屏蔽玩家（不接收其消息或私信）。
• 更多功能？欢迎告诉我们！