## **Awesome Chat 插件 – 配置指南**
Awesome Chat (由 ADF 提供) 是一款强大的聊天自定义插件，旨在增强您的 Minecraft 服务器的聊天体验。本指南概述了其配置选项和功能。
## **ℹ️ REQUIREMENTS**
Awesome Chat 服务器要求：
✔️ **[LuckPerms]('https://luckperms.net/download') 插件。**
✔️ **Java 21 或更高版本。**
## **✨ 特点概述**
Awesome Chat 包含各种聊天增强功能：
✅ **PlaceholderAPI 支持** – 使用占位符来显示动态信息。
✅ **LuckPerms 集成** – 根据权限组自动使用前缀/后缀。
✅ **自定义占位符** – 定义用户名、消息、等级等的占位符。
✅ **Bukkit 颜色代码** – 启用 Minecraft 的标准颜色和格式代码。
✅ **按组聊天格式** – 根据玩家等级/组分配聊天格式。
✅ **可点击和悬停的消息** – 添加带有悬停文本或点击动作的交互式消息。
✅ **广播系统** – 带有声音和冷却时间的全局发送格式化公告。
✅ **聊天过滤器** – 自动阻止、替换或惩罚包含被禁止词语或模式的消息。
✅ **私信系统** – 使用 `/msg` 和 `/reply` 并自定义格式。
✅ **社交间谍** – 如果您有权限，可以监控私信。
✅ **MiniMessage 支持** – & 代码的格式化替代方案。
✅ **支持最新的 Minecraft 版本** – 与 1.21+ 完全兼容。
## **⚙ 配置设置**
## **插件前缀**
所有插件消息前显示的字样：
`prefix: "&7[&bAwesomeChat&7] "`
## **PlaceholderAPI 集成**
启用动态占位符：
placeholderAPI:
enabled: true
## **LuckPerms 集成**
使用 LuckPerms 前缀和后缀：
luckperms:
enabled: true
prefix-suffix: true
## **自定义占位符**
定义聊天占位符：
placeholders:
enabled: true
chat:
username: "{player}"
message: "{message}"
prefix: "{prefix}"
suffix: "{suffix}"
## **Bukkit 颜色代码支持**
color-codes:
enabled: true
## **可点击聊天消息**
启用点击操作：
clickable-messages:
enabled: true
action: "fill" # 选项：fill, execute, copy
command: "/msg %player% "
## **可悬停聊天消息**
在聊天消息上显示悬停文本：
hoverable-messages:
enabled: true
text-lines:
- "&bPlayer&f: &f%player%"
- "&bMoney&f: &f%vault_eco_balance_formatted%"
- ""
- "&aClick to message this player!"
- "&7Click: [/msg %player%]"
## **聊天格式**
chat-format:
global_format: "{prefix}&r &e{player}&7: &f{message}"
per-group-format:
enabled: true
groups:
owner: "&cOwner&r &6{player}&7: &f{message}"
admin: "&6&lAdmin &e{player}&f: &f{message}"
moderator: "&3&lMod &b{player}&f: &f{message}"
default: "{prefix} &7[&f{player}&7]: &f{message}"
## **私信 & 社交间谍**
private-messages:
enabled: true
socialspy:
enabled: true
format:
sender: "&7[&bYou &7-> &b{receiver}&7] &f{message}"
receiver: "&7[&b{sender} &7-> &bYou&7] &f{message}"
spy: "&7[&cSpy&7] &b{sender} &7-> &b{receiver}&7: &f{message}"
errors:
use-plugin-prefix: true
player-not-found: "&cThat player could not be found!"
reply-target-not-found: "&cYou have nobody to reply to!"
cannot-message-yourself: "&cYou cannot message yourself!"
messages-disabled: "&cThat player has private messages disabled!"
self-messages-disabled: "&cYou have private messages disabled!"
no-permission: "&cYou do not have permission to do this!"
## **广播系统**
broadcast:
enabled: true
sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
format:
- "&7[&cBroadcast&7]"
- "&f%message%"
## **聊天过滤器系统**
阻止冒犯性语言、垃圾邮件和广告：
chat-filter:
enabled: true
prefix: "&8[&cChatFilter&8]&r "
announce-actions: true
bypass-permission: true
punishments:
3: "warn {player} Please watch your language!"
5: "mute {player} 1d Inappropriate language."
banned-words:
- "f**"
- "s***"
- "b***h"
- "a******e"
... # 为了简洁和道德而截断
anti-advertising:
enabled: true
block-tlds: true
tlds:
- ".com"
- ".net"
...
rules:
- name: "swear-words"
regex: "(?i)(f--k|s---|b---h|as-----e)" #为了简洁和道德而截断
player-message: "&cPlease do not use profanity!"
staff-message: "&c{player} used profanity in chat: &7{message}"
punishments:
3: "warn {player} Repeatedly attempting to use profanity"
5: "mute {player} 1d [AUTOMUTE] Repeated attempts to use profanity"
7: "mute {player} 7d [AUTOMUTE] Repeated attempts to use profanity"
## **总结**
Awesome Chat 现在包括聊天过滤器、私信、社交间谍和最新的 Minecraft 版本支持。自定义您的聊天、监控消息，并确保您的服务器社区安全且互动。
有关更多信息，请参阅：
[MiniMessage 文档]('https://docs.advntr.dev/minimessage/index.html')
[PlaceholderAPI Wiki]('https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders')
**享受带有 Awesome Chat 的完全自定义的聊天体验！**
## 需要支持？
## [加入我们的 Discord]('https://discord.gg/Z4gtF25jpC')
**或者**
## 在 Discord 上加我: adf.dev