AutoMessage [1.21]

Не очередной чат-ротатор. Полноценный движок объявлений.
Адресные, локализованные и привязанные к событиям рассылки для современных серверов и сетей Minecraft.

_{6 платформ  ·  8 способов показа  ·  8 правил аудитории  ·  3 триггера событий  ·  3 языка из коробки  ·  один рендер на язык  ·  без базы данных}

📣 Рассылки должны привлекать внимание

Игроки привыкают игнорировать объявления, когда каждое сообщение приходит всем подряд. AutoMessage делает общение сервера осознанным: у каждого потока своё расписание, каждое сообщение само выбирает аудиторию, а текст приходит на том языке, на котором игрок действительно играет — из одного общего ядра, работающего на Bukkit, Folia, Sponge, Velocity, Fabric и Minestom.

_{Один набор объявлений в игре на одном сервере: отсчёт в боссбаре, полноэкранный титул и строка чата.}

Полное объявление, от начала до конца

Поприветствуй вернувшихся ветеранов через три секунды после входа — не по таймеру, не новичков и на их родном языке. Всё это описывают два файла:

# scheduledMessages.yml - кто получает и когда
messages:
  - name: welcome-back
    trigger:
      type: JOIN
      delay: 3s
    rules:
      - type: PLAYTIME
        min: 10h

# lang/en.yml - что говорится
announcements:
  welcome-back:
    - chat: "<gray>Welcome back, <aqua>{PLAYER}<gray>."
      sound: "entity.player.levelup MASTER 1.0 1.2"

И вот что сервер делает с ними:

Это весь набор функций в миниатюре: событие вместо часов, аудитория вместо всех и текст, который живёт рядом со всеми остальными переводами.

⚖️ Больше, чем ротация списка

Слоган — не маркетинг. Ротатор отвечает на один вопрос — что мне сказать дальше? — и отправляет ответ всем, на одном языке, по одним часам.

Детали под капотом

🎯 Охватите именно тех, кто должен это услышать

Правила комбинируются. Каждое правило верхнего уровня должно пройти, а ANY_OF, NONE_OF и NOT вкладываются внутрь них, когда аудитории нужно больше, чем просто И.

Те же правила применяются к сообщению, отправленному по событию, поэтому приветствие при входе, ограниченное разрешением, никогда не дойдёт до того, у кого его нет, просто потому что он зашёл на сервер.

⚡ Срабатывай по событию, а не по таймеру

Сообщение с триггером полностью покидает ротацию своего канала и ждёт, пока что-то произойдёт.

PLAYER_COUNT стоит прочитать дважды: он срабатывает один раз при росте и перезаряжается только после того, как сервер опустится ниже порога, так что население, колеблющееся на границе, не объявляет одну и ту же веху каждый раз, когда кто-то заходит.

🪶 Почти ничего не стоит вашему серверу

Форматирование — самая дорогая часть объявления. Цвета, градиенты, текст при наведении и плейсхолдеры — всё это нужно разобрать, прежде чем хоть один символ дойдёт до кого-либо, и очевидный способ сделать это — по разу для каждого игрока, который его получает. Пятьсот игроков онлайн означают, что одно и то же предложение собирается пятьсот раз, чтобы сказать одну вещь, в главном потоке, пока остальной тик ждёт своей очереди.

AutoMessage собирает его один раз на язык и передаёт готовый результат всем, кто его читает.

Это в 15 раз меньше времени главного потока на объявление, измерено на реальном пути отправки при 500 зрителях онлайн — а не на микробенчмарке одной функции. Остаётся лишь передать готовый текст каждому соединению, чего не избежать ни одному плагину.

Экономия растёт с количеством игроков, и настройка ничего вам не стоит: нет кэша, который нужно подбирать по размеру, нет параметра для тюнинга и не нужно ни от чего отказываться.

Он никогда не меняет корректность на скорость. Сообщение, которое читается по-разному для каждого игрока — называющее {PLAYER} или содержащее любой токен PlaceholderAPI — всё равно собирается для каждого из них, потому что только расширение за этим токеном знает, увидят ли два игрока одно и то же. Группировка применяется ровно там, где текст действительно идентичен, и нигде больше.

Ещё три места, где путь отправки отказывается делать лишнюю работу:

• Плейсхолдеры сканируются один раз на сообщение, а не один раз на объявление. Какие токены содержит сообщение, определяется текстом, поэтому это вычисляется при чтении файлов и запоминается до перезагрузки — вместо того чтобы выводиться заново каждый раз, когда срабатывает канал.
• Пустой сервер замыкается накоротко. Никого онлайн — значит, никакого выбора, никакого форматирования и никакой работы.
• Ничто не трогает диск во время объявления. Ни базы данных, ни записей игроков, ни I/O на горячем пути.

🌐 Один движок. Шесть сред выполнения

AutoMessage использует общее платформенно-нейтральное ядро и небольшой адаптер среды выполнения для каждого типа сервера. Это значит, что поведение остаётся привычным, а планирование, зрители, права и хуки жизненного цикла остаются нативными для нижележащей платформы.

[!NOTE] Java 21 — это минимальная версия байткода для плагинов, а не обещание, что каждая версия сервера Minecraft работает на Java 21. Используйте JVM, требуемую вашим сервером; сам Minestom требует Java 25.

Каждый артефакт создаёт конфигурацию с учётом платформы. Опции, которые среда выполнения не может соблюсти, опускаются, а не генерируются и молча игнорируются.

🗂 Модель конфигурации

AutoMessage разделяет когда, кто и что. Добавление языка никогда не требует копирования правил планирования, а изменение интервала канала никогда не затрагивает текст сообщения.

flowchart LR
    schedule["config.yml<br/>КОГДА<br/>каналы · периоды · селекторы"]
    audience["scheduledMessages.yml<br/>КТО<br/>правила · веса · триггеры"]
    content["lang/*.yml<br/>ЧТО<br/>локализованные уведомления MiniMessage"]
    minecraft["Minecraft<br/>ВЫВОД ИГРОКУ"]
    discord["discordWebhook.yml<br/>ОПЦИОНАЛЬНОЕ ЗЕРКАЛО"]

    schedule --> audience --> content --> minecraft
    content -. "текст чата" .-> discord

    classDef config fill:#11182d,stroke:#8b7cf6,color:#eef0ff,stroke-width:1px;
    classDef output fill:#0d2028,stroke:#45d7e8,color:#ecfeff,stroke-width:1px;
    class schedule,audience,content config;
    class minecraft,discord output;

📥 Get AutoMessage

[!IMPORTANT] Статус релиза: этот README описывает локальную мультиплатформенную ветку. Текущие публичные страницы всё ещё относятся к прежней линейке релизов, ориентированной на Bukkit. Пока новый релиз на GitHub не опубликует все шесть артефактов, собирайте мультиплатформенные jar-файлы командой ./gradlew dist.

🚀 Быстрый старт

1. Возьмите артефакт, собранный под вашу среду выполнения. Jar-файлы для платформ намеренно разделены.
2. Положите его в директорию plugins/ или mods/ вашей платформы. Для Minestom добавьте jar в classpath приложения и используйте билдер, показанный ниже.
3. Запустите сервер один раз. AutoMessage создаст размеченную конфигурацию и рабочие примеры объявлений.
4. Отредактируйте config.yml, scheduledMessages.yml и файлы внутри lang/.
5. Выполните /automessage reload, затем проверьте сообщение командой `/automessage view `.

[!TIP] Начните с созданных файлов. Это не пустые шаблоны: каждое доступное поле объяснено рядом с рабочим примером, а содержимое подстраивается под платформу, которая их создала.

🛠 Создайте своё первое объявление

Пример ниже создаёт независимый поток событий, добавляет в него одно объявление и отображает несколько типов уведомлений из одной локализованной нагрузки.

1. Запланируйте поток

# config.yml
enabled: true
fallbackLanguage: en

channels:
  - name: default
    enabled: true
    initialDelay: 1m
    period: 5m
    selector: SHUFFLE

  - name: events
    enabled: true
    initialDelay: 30s
    period: 15m
    selector: SEQUENTIAL

2. Зарегистрируйте объявление

# scheduledMessages.yml
messages:
  - name: event-night
    channel: events

3. Продумайте, что увидят игроки

# lang/en.yml
announcements:
  event-night:
    - chat:
        - "<dark_gray>[<gold>EVENT<dark_gray>] <gray>The arena opens in <gold>5 minutes<gray>."
        - "<gray>Click <click:run_command:'/warp arena'><hover:show_text:'<yellow>Teleport'><aqua><u>here</u></aqua></hover></click> to join."
      actionbar: "<yellow>Prepare your loadout - the event starts soon"
      title: "<gradient:#ffd166:#ff6b6b><bold>EVENT NIGHT</bold></gradient>"
      subtitle: "<gray>The arena opens in 05:00"
      times: "500ms 3s 500ms"
      bossbar:
        message: "<light_purple>Event countdown"
        duration: 10s
        color: PURPLE
        overlay: PROGRESS
        progress: 0.75
      sound: "block.note_block.pling MASTER 1.0 1.0"

Используйте только те части, которые подходят сообщению. Простое объявление в чате может быть одной строкой; демонстрационное объявление может сочетать все поверхности выше.

📖 Справочник

channels:
  - name: tips
    enabled: true
    initialDelay: 1m
    period: 5m
    selector: SHUFFLE

  - name: promotions
    enabled: true
    initialDelay: 2m
    period: 20m
    selector: WEIGHTED

messages:
  - name: vip-event
    channel: events
    rules:
      - type: ANY_OF
        rules:
          - type: PERMISSION
            permission: rank.vip
          - type: PERMISSION
            permission: rank.staff
      - type: PLAYER_COUNT
        min: 10
        max: 100

messages:
  - name: welcome-back
    trigger:
      type: JOIN
      delay: 3s

  - name: first-join-welcome
    trigger:
      type: FIRST_JOIN
      delay: 3s

  - name: one-hundred-online
    trigger:
      type: PLAYER_COUNT
      threshold: 100

Команды и права

MinecraftServer.init();

AutoMessageMinestom autoMessage = AutoMessageMinestom.builder()
        .dataDirectory(Path.of("automessage"))
        .permissions((sender, node) -> myPermissions.check(sender, node)) // optional
        .enable();

// During your server shutdown:
autoMessage.shutdown();

🔨 Сборка из исходников

Для сборки каждой среды выполнения требуется JDK 25. Из корня репозитория выполни:

./gradlew dist

Задача запускает все проверки, собирает jar для каждой платформы и синхронизирует шесть устанавливаемых артефактов в build/dist:

• Bukkit
• Folia
• Sponge
• Velocity
• Fabric
• Minestom

Если какая-либо проверка не проходит, дистрибутив не создаётся. Обычный ./gradlew build выполняет те же проверки проекта, но оставляет артефакты внутри их отдельных модулей.

💛 Поддержать проект

AutoMessage — бесплатный, открытый и поддерживаемый независимо.

Пожалуйста, соблюдай Кодекс поведения проекта во всех сообществах. AutoMessage распространяется под GNU General Public License v3.0.

Если AutoMessage улучшает общение на твоём сервере, поставь репозиторию звезду.
Это помогает другим владельцам серверов узнать о проекте.