qAutoMessages

Send automatic messages to your players on a timer — chat announcements, action bar tips, boss bars, and screen titles. Each message type is fully configurable, everything lives in two YAML files, and you don't need to restart the server to apply changes.

Message types

Chat

Sends one or more lines to the chat. Each entry in the text list can be a separate message or combined into one, depending on the split-lines setting. Optional pixel-accurate centering is available with centered: true.

- type: CHAT
  text:
    - "<gradient:#f0c040:#ff8c00><bold>       ★ Welcome to the server! ★       </bold></gradient>"
    - "<gray>Currently online: <green>{online}<gray>/<red>{max_online}"
    - "<dark_gray>Server TPS: {tps}"
  split-lines: true
  centered: false

Action bar

Displays text above the hotbar. duration is in ticks — the plugin automatically refreshes it every second so it doesn't disappear mid-display.

- type: ACTIONBAR
  text: "<gradient:#00c6ff:#0072ff>⏱ {server_time}  |  {online}/{max_online} online  |  TPS: {tps}</gradient>"
  duration: 60

Boss bar

Shows a progress bar at the top of the screen. You can configure the color, bar style, fill amount, how long it stays, and how it animates.

- type: BOSSBAR
  text: "<red><bold>⚠ PvP is enabled in this area!</bold></red>"
  color: RED
  style: SEGMENTED_10
  progress: 1.0
  duration: 8
  animation: PULSE

Colors — PINK BLUE RED GREEN YELLOW PURPLE WHITE

Styles — SOLID SEGMENTED_6 SEGMENTED_10 SEGMENTED_12 SEGMENTED_20

Animations:

Title & subtitle

Sends a large title and smaller subtitle to the center of the screen. Timing is in ticks (20 ticks = 1 second).

- type: TITLE
  title: "<gradient:#a18cd1:#fbc2eb><bold>{player}</bold></gradient>"
  subtitle: "<gray>Welcome back. There are <green>{online}</green> players online.</gray>"
  fade-in: 20
  stay: 70
  fade-out: 20

Message groups

Messages are organized into groups. Each group runs its own independent scheduler, meaning they don't interfere with each other and you can have as many as you want.

message-groups:
  announcements:
    enabled: true
    interval: 120        # how often to send, in seconds
    random-order: false  # cycle in order, or pick randomly
    worlds: []           # limit to specific worlds, empty = all
    permission-required: ""  # only players with this permission receive it
    messages:
      - ...
      - ...

World filtering — list world names to restrict a group to those worlds only. Players in other worlds won't receive the message.

worlds:
  - world_nether
  - world_the_end

Permission filtering — set permission-required to a permission node. Only players who have that permission will receive the messages from that group. Useful for VIP announcements, staff notices, etc.

permission-required: "server.vip"

Players with automessages.bypass are excluded from all groups regardless of settings.

Formatting

Three formatting systems are supported and can be mixed freely in any message.

Legacy codes — &a green &l bold &r reset and so on.

Hex colors — &#FF5500text

MiniMessage — the full Adventure tag set, including interactive elements:

Colors and gradients:
  <#FF5500>text</#FF5500>
  <gradient:#f0c040:#ff4500>text</gradient>
  <rainbow>text</rainbow>

Decorations:
  <bold>, <italic>, <underlined>, <strikethrough>, <obfuscated>

Click events:
  <click:open_url:'https://discord.gg/example'>Join Discord</click>
  <click:suggest_command:'/vote'>Click to vote</click>
  <click:run_command:'/rules'>View rules</click>
  <click:copy_to_clipboard:'play.example.com'>Copy IP</click>

Hover tooltips:
  <hover:show_text:'<green>Opens the store!'>Store</hover>

Click and hover tags only work in chat messages — they have no effect in action bars, boss bars, or titles.

Placeholders

These are available without any additional plugins:

If PlaceholderAPI is installed, all %expansion_placeholder% values work automatically — no extra configuration needed.

Commands

Aliases: /am, /amsg

Permissions

Configuration files

Two files are generated on first run inside plugins/AutoMessages/:

config.yml — all message groups, intervals, and plugin-wide settings like prefix, world filters, and console logging.

messages.yml — every system message the plugin sends to players and admins (reload confirmation, toggle feedback, help text, etc.). Fully supports MiniMessage formatting.

Requirements

• PaperMC 1.18 – 1.21.x
• Java 17+
• PlaceholderAPI — optional