# OriginChat 插件
# 需要 **[OriginLib](https://www.spigotmc.org/resources/originlib.122170/) 才能工作！**
OriginChat 是一款专为 Minecraft 服务器设计的多功能聊天插件，提供高级功能和与流行 Minecraft 工具的无缝集成。它完全支持 HEX 和颜色代码，增强的聊天格式，以及与 ItemAdder 和 LuckPerms 的兼容性，为服务器管理员和玩家提供广泛的自定义选项。
## 功能
### HEX & 颜色代码支持
OriginChat 完全支持 **HEX** 颜色代码和 **& 颜色代码**，允许您使用鲜艳的颜色来格式化消息，从而获得视觉上吸引人的聊天体验。您可以在聊天消息和命令中的任何位置使用 `#RRGGBB` HEX 值和标准 Minecraft 颜色代码 (`&0` 到 `&f`)。
示例：
- HEX 颜色：`#FF5733`
- 标准颜色代码：`&c` (红色)
### 高级聊天格式
该插件允许灵活的聊天格式，支持占位符、动态消息和自定义格式。使用户名、消息内容等自定义聊天消息。
### ItemAdder 兼容性
OriginChat 与 **ItemAdder** 兼容，可以无缝地将自定义图片集成到您的聊天消息中。显示自定义 ItemAdder 图片，使您的聊天消息更具互动性和开箱即用的功能。
### LuckPerms 前缀支持
OriginChat 直接与 **LuckPerms** 集成，用于在聊天中显示玩家前缀。在 LuckPerms 中配置的玩家等级、权限或任何自定义前缀，无需任何额外设置即可自动显示。
### 命令范围 & 全局消息
您可以配置特定命令的范围（例如，本地聊天），以实现玩家之间更真实的沟通。全局命令，如 `/me` 或 `/roll`，将在整个服务器上广播消息。配置中提供可自定义的范围和命令格式。
### 占位符支持
OriginChat 与 **PlaceholderAPI** 配合使用，允许在聊天消息中包含动态玩家数据（例如，玩家生命值、世界、金钱等）。在您的聊天格式中使用占位符，如 `%player_name%`、`%player_health%`、`%player_world%` 等，以获取实时信息。
### 自定义聊天频道
创建具有特定权限、格式和前缀的自定义聊天频道。支持全局和本地聊天设置，包括基于半径的消息传递，用于本地化沟通。
### 权限管理
根据玩家权限，管理谁可以向特定聊天频道发送消息或使用某些命令。每个频道或命令的自定义权限确保了对聊天行为的完全控制。
### 错误 & 权限消息
OriginChat 允许您使用 HEX 和颜色代码自定义错误消息（例如，权限拒绝或无效命令用法），以便进行更具吸引力的错误处理。
### 完全可配置性
- 配置每个聊天频道的聊天格式和前缀。
- 自定义错误消息、权限消息等等。
- 易于使用的配置文件，用于高级自定义。
## 安装 & 设置
1. 从 Modrinth 或 Spigot 页面下载插件。
2. 将插件放在你的 Minecraft 服务器的 `plugins/` 文件夹中。
3. 重启服务器。
4. 编辑 `config.yml` 以设置您的聊天频道、前缀和其他设置。
5. 修改 `messages.yml` 文件以更改系统消息和错误响应的文本。
## 兼容性
- **Minecraft 版本**: 完全兼容 Minecraft 1.21 及以上版本。
- **ItemAdder**: 支持通过 itemadder 占位符显示自定义图片
- **LuckPerms**: 直接与 LuckPerms 集成，用于动态玩家前缀和权限。
- **PlaceholderAPI**: 无缝集成以实现动态占位符，例如 `%luckperms_prefix%`、`%player_health%`、`%player_rank%` 等。
## 支持
如有任何问题、功能请求或错误报告，请通过 Discord 社区支持聊天与我们联系。
## 许可证
本插件采用 GNU 通用公共许可证版本 3 (GPLv3) 许可。您可以随意修改和重新分发它，但前提是您遵守许可条款。
---
感谢您使用 OriginChat！ 享受可定制、色彩鲜艳且功能齐全的聊天体验。