Auto-Messages

Features

Auto-Messages

Cycling Auto-Messages

Auto-messages are defined under auto-messages, one named entry per message. Each entry cycles through its list at a configurable frequency and supports the same optional targeting fields (see Targeting).

TypeSectionDescription
BossBarauto-messages.bossbarsCycling titles with color, style, progressive fill/drain and per-entry display time
Titleauto-messages.titlesTitle + subtitle with fade-in / display-time / fade-out
ActionBarauto-messages.actionbarsMessages above the hotbar with per-entry display time
Chatauto-messages.chatsMulti-line chat messages with MiniMessage click/hover
Scheduledauto-messages.scheduledFire once per day at a real-world time (chat, title or actionbar)

BossBars

auto-messages:
  bossbars:
    bossbar-example:
      enabled: true
      frequency: 15s
      sound: ""
      messages:
      - text: "<red>This is an example message!"
        color: RED
        style: SEGMENTED_6
        progressive: true
        progressive-reverse: false
        display-time: 10
KeyDescription
colorBLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW
styleSOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
progressiveWhether the bar fills/drains over its display time
progressive-reversetrue = fill up, false = drain down
display-timeSeconds the bar stays visible
time-rangeOptional window, e.g. 20:00-06:00 (cross-midnight supported)

Create as many bossbars as you want — each named entry is independent and runs on its own frequency.

Titles, ActionBars & Chat

Titles take a list of title / subtitle pairs with display-time (seconds), fade-in and fade-out (ticks, 20 = 1s). ActionBars take a list of text + display-time. Chat takes a plain list of MiniMessage strings.

chats:
  chat-example:
    enabled: true
    frequency: 15s
    sound: "block.note_block.pling"
    messages:
    - "<red>Welcome! <click:run_command:/spawn><green>Click to spawn</click>"
    - "<light_purple>Second message"

Chat messages are MiniMessage, so click and hover events work natively: <click:run_command:/spawn>, <click:open_url:...>, <hover:show_text:'...'>.

Scheduled Messages

Scheduled messages fire once per day at a real-world time (server timezone). They support chat, title and actionbar types and the same targeting fields.

scheduled:
  evening-reminder:
    enabled: true
    time: "19:30"           # HH:mm (24-hour)
    type: chat
    message: "<gold>Event PvP starts in 30 minutes!"
    sound: "entity.experience_orb.pickup"

Still need help?

Ask our team on Discord or browse the source.