# 🌟 SGChat
_一个轻量级、可配置且安全的Minecraft服务器聊天系统_
---
## ✨ 主要功能
- **词语过滤**: 自动过滤禁用的词语，以保持聊天清洁。
- **自动静音**: 在发出可配置数量的警告后，自动静音发送禁词的玩家。
- **防垃圾邮件**: 阻止重复或过多的消息，以保持聊天井然有序且易于阅读。
- **可定制的消息**: 根据您的喜好配置警告和系统消息。
- **聊天格式**: 使用颜色和占位符完全自定义聊天格式。
- **轻量级和快速**: 针对卓越的性能进行了优化。
- **PlaceholderAPI 支持**: 使用占位符显示动态数据。
- **易于配置**: 一个清晰且有组织的 `config.yml` 文件。
- **颜色支持**: 使用颜色代码和格式在聊天消息中完全自定义其外观。
---
## 📥 安装
1. 从 Modrinth 下载 `.jar` 文件。
2. 将其放置在服务器的 `plugins` 文件夹中。
3. 重新启动服务器。
4. 编辑 `config.yml` 文件以满足您的需求。
5. 完成！SGChat 将开始工作。
---
## ⚙️ 配置
SGChat 包含一个非常完整的 `config.yml` 文件，因此您可以调整聊天中的各个方面以适应您的服务器。
以下是一些主要选项：
### 💬 聊天格式
- `chat.enable-format`: 启用或禁用自定义聊天格式。
- `chat.format`: 聊天消息格式。
- 占位符: `{nivel}`, `{player}`, `{displayname}`, `{message}`
### 📩 私信
- `chat.msg-format`: `/msg` 私信的格式。
- `chat.r-format`: `/r` 回复的格式。
### 🚫 防垃圾邮件
- `chat.anti-spam-delay`: 消息之间的最短时间 (例如 `2s`)。
- `chat.spam-warning`: 发送消息太快时的警告消息。
- `chat.block-duplicate-messages`: 阻止重复的消息。
- `chat.duplicate-warning`: 重复消息时的警告消息。
### 📝 禁用词语
- `chat.blocked-words`: 禁用的词语列表。
- `chat.blocked-message`: 当玩家使用禁用词语时发送的消息。
### 🔇 警告和自动静音系统
- `chat.warnings-before-mute`: 自动静音前的警告数量。
- `chat.warning-message`: 每次警告时发送的消息。
- `chat.warning-mute-message`: 在警告后静音玩家时发送的消息。
- `chat.enable-mute`: 启用或禁用静音系统。
- `chat.mute-message`: 当静音玩家试图说话时发送的消息。
- `chat.mute-duration`: 静音时长 (例如 `5m`)。
- `chat.mute-expire-message`: 静音过期时发送的消息。
### 🌍 全局消息
- `join.enabled`: 启用或禁用加入消息。
- `join.message`: 当玩家加入时显示的消息。
- `quit.enabled`: 启用或禁用退出消息。
- `quit.message`: 当玩家离开时显示的消息。
---
> 💡 **提示:** 编辑 `config.yml` 后，使用 `/sgchat reload` 或重新启动服务器以应用更改。
---
## 📜 权限和命令
| 命令 | 权限 | 描述 |
|---|---|---|
| `/sgchat reload` | `sgchat.reload` | 重新加载配置 |
---
## 💡 兼容性
- 在 **Spigot**, **Paper** 和兼容的分叉版本上工作。
- 需要 **Java 17+**。
---
> 🎨 **使用 SGChat 让您的聊天保持干净、安全和专业**