ModernChatInjector

Плагин ModernChatInjector для Minecraft — инъекция плейсхолдеров в чат

ModernChatInjector — это плагин для серверов Minecraft, разработанный как замена устаревшему ChatInjector. Он решает проблему совместимости, внедряя плейсхолдеры библиотеки PlaceholderAPI в форматы сообщений чата плагинов EssentialsX Chat и VaultChatFormatter. Инструмент поддерживает широкий спектр версий игры и серверных платформ, обеспечивая стабильную работу расширенных функций чата без необходимости переписывать конфигурации.

Принцип работы и поддержка новых версий

Плагин разработан для работы с современными версиями EssentialsX Chat (начиная с 2.20.0 и 2.21.1+), где архитектура чата изменилась. В отличие от предыдущих решений, которые использовали хакерские методы через события Bukkit и протоколы, ModernChatInjector подключается к собственным событиям чата EssentialsX. Это гарантирует корректную инъекцию плейсхолдеров как в локальном, так и в глобальном чате при их включении.

Для серверов, использующих старые версии Spigot или Paper, а также при отсутствии плагина EssentialsX Chat, система автоматически переключается на использование события AsyncPlayerChatEvent. Такой подход обеспечивает обратную совместимость с классическими форматами чата, работая по аналогии с оригинальным ChatInjector.

Настройка и интеграция

Для использования функционала плагин устанавливается вместе с библиотекой PlaceholderAPI, необходимыми расширениями и выбранным форматтером чата.

Ключевой особенностью является синтаксис вставки плейсхолдеров. В конфигурациях плагинов, поддерживающих этот инструмент, плейсхолдеры должны заключаться в фигурные скобки {}, а не в привычные для других плагинов процентные знаки %.

Пример корректного использования в конфигурации:
{player_name}

Эта детальная настройка необходима для того, чтобы система корректно распознала и обработала запросы к плейсхолдерам.

Технические ограничения и причины архитектуры

Разработчики не интегрировали поддержку внешних плейсхолдеров напрямую в ядро EssentialsX Chat. Основная причина — желание не фиксировать поддержку конкретного формата плейсхолдеров PAPI, который может измениться в будущем. Это позволило бы владельцам серверов не перенастраивать форматы чата повторно при обновлении библиотек.

ModernChatInjector закрывает этот пробел, предоставляя поддержку для плагинов в стиле "legacy", таких как EssentialsX Chat и VaultChatFormatter. Плагин работает по лицензии MIT, что разрешает его распространение и использование в любых проектах. Поддерживаемые версии серверов включают актуальные релизы (например, 26.2) и обширный список версий Minecraft начиная с 1.8.8.