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).
| Type | Section | Description |
|---|---|---|
| BossBar | auto-messages.bossbars | Cycling titles with color, style, progressive fill/drain and per-entry display time |
| Title | auto-messages.titles | Title + subtitle with fade-in / display-time / fade-out |
| ActionBar | auto-messages.actionbars | Messages above the hotbar with per-entry display time |
| Chat | auto-messages.chats | Multi-line chat messages with MiniMessage click/hover |
| Scheduled | auto-messages.scheduled | Fire 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
| Key | Description |
|---|---|
color | BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW |
style | SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20 |
progressive | Whether the bar fills/drains over its display time |
progressive-reverse | true = fill up, false = drain down |
display-time | Seconds the bar stays visible |
time-range | Optional 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"