broadcasts.yml

Configure automated broadcast messages. This file controls periodic chat or title messages shown to players based on game state.

Where to find it

Generated after the first server start:

• plugins/Zentrix/broadcasts.yml

What you edit here

• Enable or disable individual broadcasts

• Time interval between messages (in seconds)

• Which game states see each broadcast

• Display type (CHAT or TITLE)

• Message contents, colors, and formatting

Broadcasts are state-aware. A message will only appear if the player is currently in one of the states listed in show-in.

Introduction

broadcasts.yml manages automated reminders, tips, and informational messages. These broadcasts help guide players without staff intervention and keep important information visible during gameplay, waiting lobbies, and the main lobby.

File structure

All broadcasts live under the broadcasts: key. Each broadcast is a keyed block with its own timing and display rules.

broadcasts:
  <broadcast-id>:
    enabled: <true|false>
    interval: <seconds>
    show-in: [STATE, STATE]
    type: CHAT | TITLE

Common settings

enabled

Turns the broadcast on or off.

enabled: true

interval

Time in seconds between broadcasts.

interval: 180

show-in

List of game states where this broadcast is visible.

Available states:

• LOBBY — Main server lobby (not in a match)

• WAITING — Waiting lobby / countdown

• PLAYING — Alive players in an active match

show-in: [PLAYING]

type

Controls how the message is displayed.

• CHAT — Appears as chat messages

• TITLE — Appears as a title + subtitle in the center of the screen

type: CHAT

CHAT-type broadcasts

CHAT broadcasts cycle through a list of message lines. Each entry is sent as-is, in order.

messages:
  - ""
  - "&#FF4500&l⚠ FAIR PLAY"
  - "&#AAAAAAserver rules"

You can freely use:

• Hex colors (&#RRGGBB)

• Legacy colors (&7, &l)

• Empty lines for spacing

• Unicode symbols and emojis

TITLE-type broadcasts

TITLE broadcasts display centered text with timing control.

type: TITLE
title: "Main Text"
subtitle: "Sub Text"
fade-in: 10
stay: 40
fade-out: 10

Timing values are in ticks (20 ticks = 1 second).

Example breakdown: gameplay tip

This broadcast reminds active players about looting.

loot-tip:
  enabled: true
  interval: 180
  show-in: [PLAYING]
  type: CHAT
  messages:
    - ""
    - "&#B241FF&l💎 FINDING GEAR"
    - "&#AAAAAAgameplay tip"
    - ""
    - "&#B241FF| &#FFFFFFSearch buildings for Chests."
    - "&#B241FF| &#FFFFFFCenter chests contain better loot!"
    - ""
    - "&#B241FF✎ &nExplore the map"
    - ""

What players see:

• Message appears every 3 minutes

• Only visible to players actively playing

• Styled header, divider lines, and spacing for readability

Example breakdown: waiting lobby reminder

Used to guide players before the match starts.

waiting-info:
  enabled: true
  interval: 45
  show-in: [WAITING]
  type: CHAT
  messages:
    - ""
    - "&#FF9900&l🗡 PREPARE FOR BATTLE"
    - "&#AAAAAAgame starting soon"
    - ""
    - "&#FF9900| &#FFFFFFSelect your class while you wait."
    - ""

This keeps players informed without spamming chat too aggressively.

Avoid very low intervals (under 30 seconds) in PLAYING. Frequent broadcasts can clutter chat during combat.

Full configuration

Expand: default broadcasts.yml

# -----------------------------------------------------------------------------

# Zentrix Battle Royale - Broadcasts Configuration

# Developed by VoltByte Creations

# -----------------------------------------------------------------------------

# =============================================================================

# CONFIGURATION REFERENCE

# =============================================================================

# This file manages automated messages sent to players at specific intervals.

#

# COMMON SETTINGS:

#   enabled:    true/false          # Toggle this broadcast on or off.

#   interval:   120                 # Time in seconds between broadcasts.

#   show-in:    [STATE, STATE]      # Game states where this appears.

#   type:       CHAT or TITLE       # The display format.

#

# TYPE CONFIGURATION:

#   CHAT:

#     messages:                     # List of messages to cycle through.

#       - "Line 1"

#       - "Line 2"

#

#   TITLE:

#     title: "Main Text"            # The large center text.

#     subtitle: "Sub Text"          # The smaller text below.

#     fade-in: 10                   # Ticks to fade in (20 ticks = 1s).

#     stay: 40                      # Ticks to stay on screen.

#     fade-out: 10                  # Ticks to fade out.

#

# GAME STATES (for 'show-in'):

#   LOBBY:      Players in the main server lobby (not in a match).

#   WAITING:    Players in a game's waiting lobby or countdown.

#   PLAYING:    Players alive in an active match.

broadcasts:

  # ===========================================================================
  # GAMEPLAY BROADCASTS
  # ===========================================================================

  loot-tip:
    enabled: true
    interval: 180
    show-in: [PLAYING]
    type: CHAT
    messages:
      - ""
      - "&#B241FF&l💎 FINDING GEAR"
      - "&#AAAAAAgameplay tip"
      - ""
      - "&#B241FF| &#FFFFFFSearch buildings for Chests."
      - "&#B241FF| &#FFFFFFCenter chests contain better loot!"
      - ""
      - "&#B241FF✎ &nExplore the map"
      - ""

  rules-reminder:
    enabled: true
    interval: 240
    show-in: [PLAYING]
    type: CHAT
    messages:
      - ""
      - "&#FF4500&l⚠ FAIR PLAY"
      - "&#AAAAAAserver rules"
      - ""
      - "&#FF4500| &#FFFFFFCross teaming is strictly forbidden."
      - "&#FF4500| &#FFFFFFSpot a cheater? Report them!"
      - ""
      - "&#FF4500✎ &n/report <player>"
      - ""

  health-tip:
    enabled: true
    interval: 360
    show-in: [PLAYING]
    type: CHAT
    messages:
      - ""
      - "&#FF1493&l❤ STAY ALIVE"
      - "&#AAAAAAsurvival tip"
      - ""
      - "&#FF1493| &#FFFFFFKeep your hunger bar full to regen."
      - "&#FF1493| &#FFFFFFSave Golden Apples for tough fights!"
      - ""
      - "&#FF1493✎ &nManage your health"
      - ""

  # ===========================================================================
  # WAITING LOBBY BROADCASTS
  # ===========================================================================

  waiting-info:
    enabled: true
    interval: 45
    show-in: [WAITING]
    type: CHAT
    messages:
      - ""
      - "&#FF9900&l🗡 PREPARE FOR BATTLE"
      - "&#AAAAAAgame starting soon"
      - ""
      - "&#FF9900| &#FFFFFFThe match will begin shortly!"
      - "&#FF9900| &#FFFFFFSelect your class while you wait."
      - ""
      - "&#FF9900✎ &nUse class selector!"
      - ""

  # ===========================================================================
  # MAIN LOBBY BROADCASTS
  # ===========================================================================

  join-reminder:
    enabled: true
    interval: 300
    show-in: [LOBBY]
    type: CHAT
    messages:
      - ""
      - "&#55FF55&l⚑ JOIN A GAME"
      - "&#AAAAAAquick play"
      - ""
      - "&#55FF55| &#FFFFFFType /play <arena> to join!"
      - ""
      - "&#55FF55✎ &n/play <arena>"
      - ""

  profile-reminder:
    enabled: true
    interval: 600
    show-in: [LOBBY]
    type: CHAT
    messages:
      - ""
      - "&#38B6FF&l👤 YOUR PROFILE"
      - "&#AAAAAAstats & progress"
      - ""
      - "&#38B6FF| &#FFFFFFView your stats and leaderboard position."
      - ""
      - "&#38B6FF✎ &n/profile"
      - ""

  check-coins:
    enabled: true
    interval: 750
    show-in: [LOBBY]
    type: CHAT
    messages:
      - ""
      - "&#FFD700&l💰 COIN BALANCE"
      - "&#AAAAAAserver economy"
      - ""
      - "&#FFD700| &#FFFFFFCheck how many coins you've earned."
      - ""
      - "&#FFD700✎ &n/coins"
      - ""