AutoMessage (Автомесседж, DMK)

Мод для Майнкрафт, который помогает серверу показывать объявления нужным игрокам в нужный момент. Сообщения можно выводить в чат, строку над хотбаром, заголовок, подзаголовок и боссбар, дополняя их звуком.

Возможности

• Создаёт независимые каналы объявлений с собственными задержками и периодами.
• Поддерживает порядок показа SHUFFLE, SEQUENTIAL, RANDOM и WEIGHTED. В режиме SHUFFLE каждое сообщение будет показано один раз до повторов, а WEIGHTED учитывает параметр weight.
• Показывает сообщения по расписанию или по событиям: входу игрока JOIN, первому входу FIRST_JOIN и достижению заданного онлайна PLAYER_COUNT.
• Условие PLAYER_COUNT срабатывает при достижении порога один раз и снова становится активным лишь после падения онлайна ниже порога.
• Позволяет выбирать получателей по праву, группе прав, миру, онлайну и наигранному времени. Условия можно объединять через ANY_OF, NONE_OF и NOT.
• Поддерживает переменные {PLAYER}, {DISPLAY_NAME}, {UUID}, {WORLD}, {ONLINE}, {MAX_PLAYERS}, {DATE} и {TIME}. На Bukkit и Folia также распознаются переменные PlaceholderAPI.
• Текст оформляется через MiniMessage: доступны цвета, градиенты, наведение, кликабельные действия и форматирование.
• Отправляет одинаковый текст игрокам одного языка одним готовым сообщением, а персональные переменные обрабатывает отдельно.

Как пользоваться

Расписание каналов, интервалы и выбор сообщений задаются в config.yml; сами сообщения, их условия и триггеры — в scheduledMessages.yml; текст хранится отдельно в lang/<код>.yml. Изменения применяются без перезапуска командой /automessage reload.

Для уведомления можно указать одну строку чата либо объединить несколько частей в одном сообщении:

• chat — строка или список строк в чате;
• actionbar — текст над хотбаром;
• title и subtitle — заголовок и подзаголовок;
• times — длительность появления, показа и исчезновения;
• bossbar — боссбар с текстом, цветом, видом, длительностью и прогрессом;
• sound — звук в формате ключ источник громкость высота.

Доступны команды:

• /automessage enable — включить объявления по расписанию; право command.automessage.enable.
• /automessage disable — приостановить объявления по расписанию; право command.automessage.disable.
• /automessage reload — перечитать конфиги и языковые файлы; право command.automessage.reload.
• /automessage view <name> — посмотреть локализованный вариант сообщения только для себя; право command.automessage.view.
• /automessage next — узнать следующее сообщение каждого канала и время до него; право command.automessage.next.
• /automessage send <channel> — немедленно отправить следующее сообщение канала; право command.automessage.send.
• /automessage toggle — выключить или включить объявления для себя; выбор сохраняется между перезапусками.
• /automessage stats — посмотреть статистику каналов и сообщений; право command.automessage.stats.

Настройки

Языковые файлы лежат в папке lang/. Для игрока с языком pt_br сначала ищется lang/pt_br.yml, затем lang/pt.yml, после чего используется язык из fallbackLanguage. Если в переводе нет отдельного сообщения, для него также применяется резервный язык.

Длительности принимают единицы ms, s, m, h и d; их можно объединять, например 1m30s. Число без единицы считается секундами.

Требования и совместимость

Поддерживаются Bukkit-серверы, включая Spigot, Paper и Purpur, а также Folia, Sponge, Velocity, выделенный сервер Fabric и Minestom. Для Fabric нужен Fabric API; мод устанавливается только на сервер. На Bukkit и Folia PlaceholderAPI подключается автоматически, если он установлен.

Для большинства платформ требуется Java 21 или новее; для Minestom нужна Java 25. На Velocity и Minestom недоступны условия мира, наигранного времени и первого входа; на Minestom проверка прав и групп требует собственного обработчика прав.