# gChat-Towny
**gChat-Towny** 是一个为 [gChat](https://modrinth.com/plugin/gchat) 插件的扩展，它集成了对 [Towny](https://www.spigotmc.org/resources/towny-advanced.72606/) 的支持，并在聊天中直接显示玩家城镇和国家标签。该插件还与 [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) 兼容，可用于灵活的占位符使用。
---
## 特性
* 显示 **城镇** 和 **国家** 标签在聊天中。
* 支持 **HEX 颜色** 用于标签（例如，`&#FF0000` → 红色）。
* 与 **PlaceholderAPI** 集成：
* `%gchat_towny%` — 完整标签: `[国家 | 城镇]`
* `%gchat_townytown%` — 城镇标签：`[城镇]`
* `%gchat_townynation%` — 国家标签：`[国家]`
* 完全兼容 **gChat**：标签会自动应用于聊天格式。
* 检查 Towny 和 gChat — 如果缺少依赖项，则安全地禁用自身。
* **调试模式** 用于检查标签和配置。
* 通过 `towny-gChat.yml` 进行配置。
---
## 安装
1. 下载 [gChat-Towny.jar](https://github.com/YourRepo/gChat-Towny/releases/latest)。
2. 将文件放在服务器的 `plugins` 文件夹中。
3. 确保已安装：
* [gChat](https://modrinth.com/plugin/gchat)
* [Towny](https://www.spigotmc.org/resources/towny-advanced.72606/)
* (可选) [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/)
4. 启动服务器。该插件将在 `plugins/gChat/towny-gChat.yml` 创建一个配置文件。
---
## 配置
`towny-gChat.yml` 示例：
```yaml
tag_formats:
town: '&f[&a%s&f] '
nation: '&f[&#FF5656%s&f] '
both: '&f[&c%s&f | &a%s&f] '
use_hex_colors: true
debug: false
```
* **tag\_formats.town** — 城镇标签格式。
* **tag\_formats.nation** — 国家标签格式。
* **tag\_formats.both** — 城镇和国家标签格式。
* **use\_hex\_colors** — 启用标签中的 HEX 颜色。
* **debug** — 启用控制台错误输出以进行调试。
---
## PlaceholderAPI 占位符
| 占位符 | 描述 |
| --------------------- | ------------------------------ |
| `%gchat_towny%` | 完整标签: `[国家 / 城镇]` |
| `%gchat_townytown%` | 城镇标签 `[城镇]` |
| `%gchat_townynation%` | 国家标签 `[国家]` |
---
## 兼容性
* **gChat 1.x**
* **Towny 0.101+**
* **Minecraft 1.21+**
* **PlaceholderAPI (可选)**