# ModernChatInjector
一个替换ChatInjector的插件,现在内置了对EssentialsX Chat 2.21.1+的支持,以及对旧版本的有限支持。
## 用法
将ModernChatInjector与PlaceholderAPI、您需要的任何扩展以及您选择的聊天格式化插件一起安装。
然后在您的聊天格式化插件中使用以下语法在聊天格式中添加PlaceholderAPI占位符:
`{placeholder_name}`。
请注意,您需要使用`{}`将占位符括起来,而不是像您可能期望的`%`符号!
## 它如何工作?
在EssentialsX 2.20.0及更高版本中,ModernChatInjector会钩住EssentialsX Chat自身的聊天事件,以确保在启用本地/全局聊天时,PlaceholderAPI
占位符被注入到消息格式中。
这是必要的,因为ChatInjector的先前版本依赖于Bukkit事件和协议hack,而这些事件与EssentialsX Chat或Paper聊天事件的当前版本不完全兼容。
如果未安装EssentialsX Chat,或者您正在运行旧版本的Spigot或Paper,此插件将回退
到钩住Bukkit的`AsyncPlayerChatEvent`(就像ChatInjector所做的那样),以确保与其它遗留聊天
格式化器的兼容性。
## 为什么这不内置在EssentialsX Chat中?
这为“legacy”风格的聊天格式化插件(例如EssentialsX Chat和
VaultChatFormatter)提供PlaceholderAPI支持,就像ChatInjector过去所做的那样。
我们计划在未来的版本中对EssentialsX Chat进行更大的改头换面,其中包括对外部
占位符的支持。在准备好之前,我们不想保证对特定PAPI格式的支持,因为这个格式可能会在
未来发生变化,届时所有服务器所有者都需要第二次重新配置他们的聊天格式。