# 简单表情
**SimpleEmojis** 是一个轻量级的 Minecraft 服务器插件，它允许玩家通过输入简单的占位符，如 `:skull:`，在聊天中使用 Unicode 表情符号。
无需资源包——它完全在服务器端运行，利用 Minecraft 默认的 Unicode 支持。
---
## 特性
- 将占位符（如 `:skull:`、`:heart:` 或 `:smile:`）替换为聊天中的 Unicode 表情符号等效项。
- 通过 `config.yml` 轻松配置表情符号映射。
- 使用命令动态添加或删除表情符号映射。
- 与其他聊天格式化插件兼容；保持您的前缀和颜色不变。
- 主要命令和表情符号占位符的 Tab 补全。
---
## 安装
1. 下载最新的 SimpleEmojis `.jar` 文件。
2. 将其放入服务器的 `plugins` 文件夹中。
3. 启动或重新加载服务器以生成默认的 `config.yml`。
4. 在 `plugins/SimpleEmojis/config.yml` 文件中自定义表情符号或使用命令。
---
## 使用
### 聊天中的表情符号占位符
在聊天中键入用冒号括起来的任何表情符号占位符。
示例：
`
Hello :skull: world!
`
将显示为：
`
Hello 💀 world!
`
---
### 命令
所有命令都需要权限，除非您默认是 OP。
#### `/simpleemojis `
- **list** —— 显示所有当前加载的表情符号占位符及其 Unicode 等效项。
- **reload** —— 从磁盘重新加载插件配置。
- **help** —— 显示帮助和使用信息。
**权限:** `simpleemojis.admin` (默认 OP)
---
#### `/addemoji `
即时添加新的表情符号映射。占位符**必须以冒号开头和结尾** (`:example:`)，并且表情符号必须是**单个 Unicode 表情符号字符**。
示例：
`
/addemoji :star: ⭐
`
结果：在聊天中键入 `:star:` 将显示 ⭐。
**权限:** `simpleemojis.add` (默认 OP)
---
#### `/removeemoji `
通过其占位符删除现有的表情符号映射。
示例：
`
/removeemoji :star:
`
**权限:** `simpleemojis.remove` (默认 OP)
---
## 权限
| 权限 | 描述 | 默认 |
|----------------------|-------------------------------------------|-----------|
| `simpleemojis.admin` | 访问 `/simpleemojis` 命令（list、reload、help） | OP |
| `simpleemojis.add` | 使用 `/addemoji` 命令添加表情符号 | OP |
| `simpleemojis.remove`| 使用 `/removeemoji` 命令删除表情符号 | OP |
---
## 配置 (`config.yml`)
配置包含占位符到 Unicode 表情符号的映射：
`
emojis:
":skull:": "💀"
":heart:": "❤️"
":smile:": "😄"
":fire:": "🔥"
`
- 占位符**如果包含冒号（：），则必须引用**。
- 您可以通过手动编辑此文件或使用命令来添加/删除表情符号。
- 编辑后，使用 `/simpleemojis reload` 重新加载配置。
---
## 支持与贡献
对于错误报告或功能请求，请在 [GitHub 仓库](https://github.com/tommustbe12com/SimpleEmojis) 中提出问题。
欢迎贡献和拉取请求！
---
## 许可证
MIT 许可 © TomMustBe12
---
感谢您使用 SimpleEmojis！ 🎉
让您的聊天变得有趣和富有表现力。