# ChatPings - 一个 Minecraft 服务器插件！
ChatPings 是一个插件，允许你像在 Discord 中一样 ping 其他玩家。
该插件可以自定义，从 ping 颜色和声音到声音的音量和音高！
该插件允许你使用三种不同的 ping 类型来 ping 玩家：
- @Player (通过用户名或 EssentialsX 昵称 ping 某个玩家)
- @everyone (ping 服务器上的所有人) [这需要一个权限节点]
- @someone (ping 当前在线的随机玩家 (如果启用此选项，也包括你自己))
每个 ping 也会播放一个声音，你可以在 config.yml 中更改它，以及声音的音高和音量！
有一些命令可以被所有人使用，以及一些仅供管理员使用的命令。
#### 管理员命令:
- /pingreload: 重新加载 config.yml 和 lang.yml，以便使用你设置的新设置。
- /pingprefix: 更改用于 ping 的前缀。
- /pinginfo: 显示关于 ChatPings 的信息。
- /pingresetcooldown <玩家>: 重置玩家的冷却时间。
#### 玩家命令:
- /pinghelp: 显示此插件的命令列表。
- /pingtoggle: “静音 ping”，不播放声音。*
*拥有 “chatpings.bypass” 权限节点的玩家可以绕过玩家的 ping 静音，因此你可以听到他们的 ping 声音。
#### 管理员权限:
- chatpings.admin /pingreload、在 /pinghelp 中查看管理员命令以及 ping 所有人的权限节点。（默认 OP）
- chatpings.bypass 权限节点以绕过玩家的 ping 静音 (默认 OP)
#### 玩家权限:
- chatpings.help /pinghelp 权限节点。（默认 TRUE）
- chatpings.toggle /pingtoggle 权限节点。（默认 TRUE）
- chatpings.player ping 另一个玩家的权限节点。（默认 TRUE）
- chatpings.someone ping 另一个玩家的权限节点。（默认 TRUE）
Ping Pop-Up 是 ChatPings 中的一个全新功能，它通过例如标题、操作栏或 Bossbar 显示谁 ping 了你。
以下是可以选择的不同类型：
- title (在屏幕中间显示文本)
- subtitle (与标题相同，但较小)
- actionbar (在热条上方显示文本)
- boss* (在 Bossbar 中显示文本，健康条为消失前的倒计时)
- everything (这个选项不需要解释，对吧？)
- none (基本上不显示任何 Pop-Up)
除此之外，你还可以选择这些 Pop-Up 在屏幕上停留的时间。
*Bossbar Pop-Up 仅适用于 1.19+ 版本！
```
ping:
Prefix: '@'
everyoneFormat: everyone
someoneFormat: someone
placeholder: enter placeholder here
pingcooldown:
enabled: true
duration:
player: 5
someone: 5
everyone: 5
everyonePing:
color: '&b&l'
sound: ENTITY_EXPERIENCE_ORB_PICKUP
volume: 3.0F
pitch: 0.5F
playerPing:
color: '&b&l'
sound: ENTITY_EXPERIENCE_ORB_PICKUP
volume: 3.0F
pitch: 0.5F
someonePing:
color: '&b&l'
sound: ENTITY_EXPERIENCE_ORB_PICKUP
volume: 3.0F
pitch: 0.5F
pingYourself: true
includePicked: true
pop-up:
title: none
fade-in: 1
duration: 3
fade-out: 1
bosscolor: WHITE
```
```
title: '&0[&bChat&cPings&0]&r '
reload:
start: '&b正在重新加载配置...'
done: '&b重新加载完成！'
toggle:
mute: '&b已成功静音 ping! &c[只有工作人员可以 ping 你了！'
unmute: '&b已成功取消静音 ping！'
prefix:
success: '&b已成功将前缀设置为 &e{prefix}&b！'
reset: '&b已成功重置为默认前缀! (@)'
help:
reload: '&b重新加载配置文件和语言文件。'
prefix: '&b更改用于 ping 的前缀。'
toggle: '&b仅允许工作人员 ping 你。'
help: '&b向你显示此插件的命令列表。'
resetcooldown: '&b重置玩家的冷却时间。'
cooldown:
resetsuccess: '&b已成功重置 &e{player}&b 的冷却时间！'
error:
permissions: '&c权限不足！'
args: '&c参数太少！'
prefix: '&c不能将前缀设置为 &e/ &c，因为它是一个命令前缀！'
oncooldown: '&c你的 ping 正在冷却！等待 &e{time} &c 秒！'
player: '&c玩家 &e{player} &c 不存在！'
notoncooldown: '&c玩家 &e{player} &c 没有在冷却中！'
pop-up:
message: '&b&l{name} &6 ping 了你！'
```
- 声音音量可以在 0.0F 到 10.0F 之间设置
- 声音音高可以在 0.0F 到 2.0F 之间设置
- 声音列表: [点击这里](https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html)
[注意] 根据你的服务器版本，某些声音可能无法正常工作！
如果你有任何问题或错误报告，请随时提出或在 [Github Issues 区域](https://github.com/Niestrat99/ChatPings/issues) 或 [Discord 服务器](https://discord.gg/jntpdcM) 上报告！