Targeting & Selection

Features

Targeting & Selection

Targeting Fields

Every auto-message (bossbar / title / actionbar / chat / scheduled) supports these optional fields:

FieldDescription
conditionA named condition (from conditions:) or an inline expression like "%player_level% >= 10". Legacy alias: placeholder-condition.
permissionOnly show to players with this permission (e.g. VIP-only announcements)
worldsOnly show in these worlds
disabled-worldsHide in these worlds — a per-message list overrides the global disabled-worlds for that message
time-range (bossbars)Only display during a window, e.g. 20:00-06:00 (cross-midnight supported)

The top-level disabled-worlds list is a global default applied to every auto-message; any section can override it with its own disabled-worlds for full per-message control.

Random & Weighted Selection

By default a message group cycles through its entries in order (mode: sequential). Set mode: random for random selection, with an optional weights list.

tips:
  enabled: true
  mode: random
  weights: [3, 1, 1]   # first message 3x more likely
  frequency: 5m
  messages:
  - "<gold>Common tip"
  - "<gold>Rare tip"
  - "<gold>Another rare tip"

Still need help?

Ask our team on Discord or browse the source.