[](https://raw.githubusercontent.com/intergrav/devins-badges/1aec26abb75544baec37249f42008b2fcc0e731f/assets/cozy/supported/paper_vector.svg)
[](https://modrinth.com/plugin/chatformatter)
[](https://hangar.papermc.io/EternalCodeTeam/EternalChatFormatter)
[](https://discord.gg/FQ7jmGBd6c)
[](https://raw.githubusercontent.com/vLuckyyy/badges/main/read-the-documentation.svg)
[](https://docs.eternalcode.pl/eternalcore/introduction)
> ⚠ **此插件运行需要 PlaceholderAPI 和 Vault！**
## 🌌 预览：
## ✨ 特点：
- PlaceholderAPI 支持
- [MiniMessages 支持](https://docs.adventure.kyori.net/minimessage/format.html) 带有 Legacy Colors 支持！
- 模板系统
- 自定义占位符系统
- 基于权限的 MiniMessages 标签 (见下方的权限)
## 🔗 有用链接：
- [Web UI](https://webui.adventure.kyori.net)
- [MiniMessages 格式](https://docs.adventure.kyori.net/minimessage/format.html)
## 🔑 权限：
> **注意:** 每个颜色和装饰权限 (例如 `chatformatter.color.white`, `chatformatter.reset`, `chatformatter.decorations.bold`) 授予了对 legacy 代码 (例如 `&f`, `&r`, `&l`) 和 MiniMessage 标签 (例如 `
`, ``, ``) 的访问权限。
| **权限** | **访问** |
|:------------------------------------------|:------------------------------------------------------------------------------------------------------|
| `chatformatter.decorations.*` | ``, ``, ``, ``, ``, `&l`, `&o`, `&n`, `&m`, `&k` |
| `chatformatter.decorations.bold` | ``, ``, `&l` |
| `chatformatter.decorations.italic` | ``, ``, ``, `&o` |
| `chatformatter.decorations.underlined` | ``, `&n` |
| `chatformatter.decorations.strikethrough` | ``, ``, `&m` |
| `chatformatter.decorations.obfuscated` | ``, ``, `&k` |
| `chatformatter.reset` | ``, `&r` |
| `chatformatter.newline` | ``, `
` |
| `chatformatter.shadow` | `` |
| `chatformatter.gradient` | `` |
| `chatformatter.rainbow` | `` |
| `chatformatter.pride` | `` |
| `chatformatter.transition` | `` |
| `chatformatter.hover` | `` |
| `chatformatter.click` | `` |
| `chatformatter.insertion` | `` |
| `chatformatter.color.*` | 所有颜色代码: ``, ``, `<#a568a9>`, `&c`, `&#a568a9`, 等等。 |
| `chatformatter.color.black` | ``, `&0` |
| `chatformatter.color.dark_blue` | ``, `&1` |
| `chatformatter.color.dark_green` | ``, `&2` |
| `chatformatter.color.dark_aqua` | ``, `&3` |
| `chatformatter.color.dark_red` | ``, `&4` |
| `chatformatter.color.dark_purple` | ``, `&5` |
| `chatformatter.color.gold` | ``, `&6` |
| `chatformatter.color.gray` | ``, `&7` |
| `chatformatter.color.dark_gray` | ``, `&8` |
| `chatformatter.color.blue` | ``, `&9` |
| `chatformatter.color.green` | ``, `&a` |
| `chatformatter.color.aqua` | ``, `&b` |
| `chatformatter.color.red` | ``, `&c` |
| `chatformatter.color.light_purple` | ``, `&d` |
| `chatformatter.color.yellow` | ``, `&e` |
| `chatformatter.color.white` | ``, `&f` |
| `chatformatter.score` | `` |
| `chatformatter.selector` | `` |
| `chatformatter.font` | `` |
| `chatformatter.translatable` | `` |
| `chatformatter.keybind` | `` |
| `chatformatter.nbt` | `` |
| `chatformatter.reload` | `/chatformatter reload` |
| `chatformatter.receiveupdates` | 接收关于此插件的新版本公告 |
### config.yml
```yaml
# ____ _ _ _____ ChatFormatter _ _
# / ___| |__ __ _| |_| ___|__ _ __ _ __ ___ __ _| |_| |_ ___ _ __
# | | | '_ \ / _` | __| |_ / _ \| '__| '_ ` _ \ / _` | __| __/ _ \ '__|
# | |___| | | | (_| | |_| _| (_) | | | | | | | | (_| | |_| || __/ |
# \____|_| |_|\__,_|\__|_| \___/|_| |_| |_| |_|\__,_|\__|\__\___|_|
# 你是否希望接收 ChatFormatter 新版本的更新信息？
receiveUpdates: true
# 职员格式 (Vault) 支持 Mini-messages 和 Legacy Colors
# 我们推荐您使用 webui 进行 Mini-messages 设置: https://webui.adventure.kyori.net/
# 文档在此处: https://docs.adventure.kyori.net/minimessage/format.html
# 您可以查看 LuckPerms 设置和占位符在此处: https://luckperms.net/wiki/Placeholders
#
# 示例用法：
#
# 悬停消息：
# 单行: test'>TEST
# 多行: test'>TestTest2
#
# 点击消息：
# 打开 URL: TEST
# 运行命令: Click to say hello
# 建议命令:
#
# RGB 和渐变消息用法:
# Example message
# Example message
#
# 您可以使用三个内部占位符:
#
defaultFormat: "{displayname} » {message}"
# 您可以在此设置每个等级的不同的格式
# 请记住！等级名称必须与您权限插件配置中的名称完全相同。
# 如果玩家拥有多个等级，请务必正确设置等级权重配置
format:
default: "{member} &7$hoverName({displayname}) &8» {message} "
vip: "{vip} &f$hoverName({displayname}) » {message}"
mod: "{mod} &f$hoverName({displayname}) » {message}"
admin: "{admin} &f$hoverName({displayname}) » {message}"
owner: "{owner} &f$hoverName({displayname}) » {message}"
# 此部分用于有经验的用户
# 它用于进一步缩短文本并保持文件整洁！
placeholders:
{displayname}: ""
{name}: ""
{message}: ""
{member}: "<#6e6764>Member"
{vip}: "VIP"
{mod}: "<#00c900>Mod"
{admin}: "<#6e86ff>Admin"
{owner}: "Owner"
{rankDescription}: "Rank: %vault_group%"
{joinDate}: "Joined: %player_first_join_date%"
{health}: "Health: %player_health%"
{lvl}: "LVL: %player_level%"
{privateMessage}: "Click to send private message"
# 以下部分是用于高级用户
# 用于进一步缩短文本，并保持文件整洁
templates:
- "$hoverName($name) -> 'Name: $name
{rankDescription}
{joinDate}
{health}
{lvl}
{privateMessage}'>{displayname}'"
```
