game-types.yml

game-types.yml defines the rules and visuals for each matchmaking queue.

Each entry is a mode like solo, duo, trio, or squad.

Modes control:

• Player limits and team sizing

• Countdown behavior

• Per-mode scoreboards for each game state

Where to find it

Generated after the first server start:

• plugins/Zentrix/game-types.yml

What you edit here

• Define available game types

• Tune game-type specific rules

• Create custom game-type

• Customize per-mode scoreboard layouts and placeholders

Keep names consistent across files. If a name changes, update references.

Modes are selected by arenas. See: Game Type.

File structure (hierarchy)

At a high level, everything lives under game-types.

game-types:
  <mode-id>:
    maximum-players: <int>
    minimum-players: <int>
    start-time: <seconds>
    team-size: <int>
    scoreboards:
      <state>:
        title: "<string>"
        lines:
          - "<string>"

• <mode-id> is the key you reference elsewhere (example: solo).

• <state> is one of waiting, starting, playing, win.

Settings breakdown

These keys exist once per mode under game-types.<mode-id>.

maximum-players

Hard cap for total players in the match.

maximum-players: 100

minimum-players

Minimum required players before the countdown can start.

minimum-players: 50

start-time

Pre-game countdown duration in seconds.

start-time: 90

team-size (critical)

Max players per team for this mode.

• 1 = Solo (every player is their own team)

• 2 = Duo

• 3 = Trio

• 4 = Squad

team-size: 2

team-size and minimum-players should match your match pacing.

Large team sizes with low minimum-players can create “empty” matches.

Scoreboard system

Scoreboards are defined per mode and per state:

• game-types.<mode-id>.scoreboards.waiting

• game-types.<mode-id>.scoreboards.starting

• game-types.<mode-id>.scoreboards.playing

• game-types.<mode-id>.scoreboards.win

Each state has:

• title: the scoreboard header

• lines: an ordered list of lines (empty string = spacer)

States (4 total)

• waiting: lobby / waiting room (before countdown)

• starting: countdown is running

• playing: active match

• win: victory screen / end state

Placeholders reference

You can use placeholders inside title and lines.

Supported formats:

• Internal: {placeholder}

• PlaceholderAPI: %zentrix_placeholder%

The default config also uses formatted variants like %zentrix_phase_time_mm_ss%.

See the full list in Placeholders.

See Scoreboard for formatting tips.

Default configuration

Expand: default game-types.yml

# -----------------------------------------------------------------------------
# Zentrix Battle Royale - Game Types Configuration
# Developed by Harsh
# -----------------------------------------------------------------------------

# CONFIGURATION GUIDE
# =============================================================================
# This file defines the different game modes (Solo, Duo, Squad, etc.).
# Each mode has specific player limits, team sizes, and unique scoreboards.

# SETTINGS REFERENCE:
#   maximum-players:  Hard limit on player count.
#   minimum-players:  Required player count to start the countdown.
#   start-time:       Duration (in seconds) of the pre-game countdown.
#   team-size:        Max players per team (1 = Solo, 2 = Duo, etc.).

# =============================================================================
# Support: Internal {placeholder} and PlaceholderAPI %zentrix_placeholder%
#
# COMMON (All States):
#   %zentrix_players%       Current player count
#   %zentrix_max_players%   Max player limit
#   %zentrix_min_players%   Min players to start
#   %zentrix_mode%          Game mode name (e.g., Solo)
#   %zentrix_arena%         Arena name
#   %zentrix_date%          Date (MM/DD/YYYY)
#   %zentrix_clock%         Time (HH:MM)
#   %zentrix_game_id%       Short Game ID (last 3 chars)
#
# PLAYER & TEAMS:
#   %zentrix_kills%         Current game kills
#   %zentrix_team%          Team display name
#   %zentrix_team_symbol%   Team symbol/icon
#   %zentrix_team_alive%    Alive teammates count
#   %zentrix_teams_row_X%   Team status row (X = 1-5)
#
# STATE SPECIFIC:
#   %zentrix_needed%        Players needed to start (Waiting)
#   %zentrix_countdown%     Seconds until start (Starting)
#   %zentrix_alive%         Alive player count (Playing)
#   %zentrix_phase%         Current phase name (Playing)
#   %zentrix_next_phase%    Next phase name (Playing)
#   %zentrix_phase_time%    Time remaining in phase (Playing)
#   %zentrix_border_size%   Current border size (Playing)
#   %zentrix_winner%        Winning player/team name (Win)

game-types:

  # ===========================================================================
  # SOLO MODE (1 Player)
  # ===========================================================================
  solo:
    maximum-players: 100
    minimum-players: 50
    start-time: 90
    team-size: 1
    scoreboards:
      waiting:
        title: "&#FFD700&lS&#FED804&lO&#FCDA08&lL&#FBDB0C&lO &#F8DE15&lR&#F7DF19&lO&#F5E11D&lY&#F4E221&lA&#F2E425&lL&#F1E529&lE"
        lines:
          - "&7%zentrix_date% &8%zentrix_clock% %zentrix_game_id%"
          - ""
          - "&fPlayers: &a%zentrix_players%&7/%zentrix_max_players%"
          - "&fStarting in: &aWaiting"
          - ""
          - "%zentrix_team_symbol% &r&f%zentrix_team_alive% &8(&7Your Team&8)"
          - "%zentrix_teams_row_1%"
          - "%zentrix_teams_row_2%"
          - "%zentrix_teams_row_3%"
          - ""
          - "&#FFD700play.example.net"
      starting:
        title: "&#FFD700&lS&#FED804&lO&#FCDA08&lL&#FBDB0C&lO &#F8DE15&lR&#F7DF19&lO&#F5E11D&lY&#F4E221&lA&#F2E425&lL&#F1E529&lE"
        lines:
          - "&7%zentrix_date% &8%zentrix_clock% %zentrix_game_id%"
          - ""
          - "&fPlayers: &a%zentrix_players%&7/%zentrix_max_players%"
          - "&fStarting in: &a%zentrix_countdown%s"
          - ""
          - "%zentrix_team_symbol% &r&f%zentrix_team_alive% &8(&7Your Team&8)"
          - "%zentrix_teams_row_1%"
          - "%zentrix_teams_row_2%"
          - "%zentrix_teams_row_3%"
          - ""
          - "&#FFD700play.example.net"
      playing:
        title: "&#FFD700&lS&#FED804&lO&#FCDA08&lL&#FBDB0C&lO &#F8DE15&lR&#F7DF19&lO&#F5E11D&lY&#F4E221&lA&#F2E425&lL&#F1E529&lE"
        lines:
          - ""
          - "&f%zentrix_next_phase% in:"
          - "&a%zentrix_phase_time_mm_ss%"
          - ""
          - "&fPlayers: &a%zentrix_alive%&7/%zentrix_max_players%"
          - ""
          - "%zentrix_team_symbol% &r&f%zentrix_team_alive% &8(&7Your Team&8)"
          - "%zentrix_teams_row_1%"
          - "%zentrix_teams_row_2%"
          - "%zentrix_teams_row_3%"
          - ""
          - "&fKills: &a%zentrix_kills%"
          - "&fBorder: &a%zentrix_border_size%"
          - ""
          - "&#FFD700play.example.net"
      win:
        title: "&#FFD700&lS&#FED804&lO&#FCDA08&lL&#FBDB0C&lO &#F8DE15&lR&#F7DF19&lO&#F5E11D&lY&#F4E221&lA&#F2E425&lL&#F1E529&lE"
        lines:
          - "&7%zentrix_date% &8%zentrix_clock% %zentrix_game_id%"
          - ""
          - "&fWinner:"
          - "&a%zentrix_winner%"
          - ""
          - "&fPlayers:"
          - "&a%zentrix_alive%&7/%zentrix_max_players%"
          - ""
          - "&fKills: &a%zentrix_kills%"
          - ""
          - "&#FFD700play.example.net"

  # ===========================================================================
  # DUO MODE (2 Players)
  # ===========================================================================
  duo:
    maximum-players: 100
    minimum-players: 40
    start-time: 80
    team-size: 2
    scoreboards:
      waiting:
        title: "&#FFD700&lD&#FED804&lU&#FCDA08&lO &#F8DE15&lR&#F7DF19&lO&#F5E11D&lY&#F4E221&lA&#F2E425&lL&#F1E529&lE"
        lines:
          - "&7%zentrix_date% &8%zentrix_clock% %zentrix_game_id%"
          - ""
          - "&fPlayers: &a%zentrix_players%&7/%zentrix_max_players%"
          - "&fStarting in: &aWaiting"
          - ""
          - "%zentrix_team_symbol% &r&f%zentrix_team_alive% &8(&7Your Team&8)"
          - "%zentrix_teams_row_1%"
          - "%zentrix_teams_row_2%"
          - "%zentrix_teams_row_3%"
          - ""
          - "&#FFD700play.example.net"
      starting:
        title: "&#FFD700&lD&#FED804&lU&#FCDA08&lO &#F8DE15&lR&#F7DF19&lO&#F5E11D&lY&#F4E221&lA&#F2E425&lL&#F1E529&lE"
        lines:
          - "&7%zentrix_date% &8%zentrix_clock% %zentrix_game_id%"
          - ""
          - "&fPlayers: &a%zentrix_players%&7/%zentrix_max_players%"
          - "&fStarting in: &a%zentrix_countdown%s"
          - ""
          - "%zentrix_team_symbol% &r&f%zentrix_team_alive% &8(&7Your Team&8)"
          - "%zentrix_teams_row_1%"
          - "%zentrix_teams_row_2%"
          - "%zentrix_teams_row_3%"
          - ""
          - "&#FFD700play.example.net"
      playing:
        title: "&#FFD700&lD&#FED804&lU&#FCDA08&lO &#F8DE15&lR&#F7DF19&lO&#F5E11D&lY&#F4E221&lA&#F2E425&lL&#F1E529&lE"
        lines:
          - "&7%zentrix_date% &8%zentrix_clock% %zentrix_game_id%"
          - ""
          - "&f%zentrix_next_phase% in:"
          - "&a%zentrix_phase_time_mm_ss%"
          - ""
          - "%zentrix_team_symbol% &r&f%zentrix_team_alive% &8(&7Your Team&8)"
          - "%zentrix_teams_row_1%"
          - "%zentrix_teams_row_2%"
          - "%zentrix_teams_row_3%"
          - ""
          - "&fKills: &a%zentrix_kills%"
          - ""
          - "&fBorder: &a%zentrix_border_size%"
          - ""
          - "&#FFD700play.example.net"
      win:
        title: "&#FFD700&lD&#FED804&lU&#FCDA08&lO &#F8DE15&lR&#F7DF19&lO&#F5E11D&lY&#F4E221&lA&#F2E425&lL&#F1E529&lE"
        lines:
          - "&7%zentrix_date% &8%zentrix_clock% %zentrix_game_id%"
          - ""
          - "&fWinner:"
          - "&a%zentrix_winner%"
          - ""
          - "&fPlayers:"
          - "&a%zentrix_alive%&7/%zentrix_max_players%"
          - ""
          - "&fKills: &a%zentrix_kills%"
          - ""
          - "&#FFD700play.example.net"

  # ===========================================================================
  # TRIO MODE (3 Players)
  # ===========================================================================
  trio:
    maximum-players: 100
    minimum-players: 36
    start-time: 60
    team-size: 3
    scoreboards:
      waiting:
        title: "&#FFD700&lT&#FED804&lR&#FCDA08&lI&#FBDB0C&lO &#F8DE15&lR&#F7DF19&lO&#F5E11D&lY&#F4E221&lA&#F2E425&lL&#F1E529&lE"
        lines:
          - "&7%zentrix_date% &8%zentrix_clock% %zentrix_game_id%"
          - ""
          - "&fPlayers: &a%zentrix_players%&7/%zentrix_max_players%"
          - "&fStarting in: &aWaiting"
          - ""
          - "%zentrix_team_symbol% &r&f%zentrix_team_alive% &8(&7Your Team&8)"
          - "%zentrix_teams_row_1%"
          - "%zentrix_teams_row_2%"
          - "%zentrix_teams_row_3%"
          - ""
          - "&#FFD700play.example.net"
      starting:
        title: "&#FFD700&lT&#FED804&lR&#FCDA08&lI&#FBDB0C&lO &#F8DE15&lR&#F7DF19&lO&#F5E11D&lY&#F4E221&lA&#F2E425&lL&#F1E529&lE"
        lines:
          - "&7%zentrix_date% &8%zentrix_clock% %zentrix_game_id%"
          - ""
          - "&fPlayers: &a%zentrix_players%&7/%zentrix_max_players%"
          - "&fStarting in: &a%zentrix_countdown%s"
          - ""
          - "%zentrix_team_symbol% &r&f%zentrix_team_alive% &8(&7Your Team&8)"
          - "%zentrix_teams_row_1%"
          - "%zentrix_teams_row_2%"
          - "%zentrix_teams_row_3%"
          - ""
          - "&#FFD700play.example.net"
      playing:
        title: "&#FFD700&lT&#FED804&lR&#FCDA08&lI&#FBDB0C&lO &#F8DE15&lR&#F7DF19&lO&#F5E11D&lY&#F4E221&lA&#F2E425&lL&#F1E529&lE"
        lines:
          - "&7%zentrix_date% &8%zentrix_clock% %zentrix_game_id%"
          - ""
          - "&f%zentrix_next_phase% in:"
          - "&a%zentrix_phase_time_mm_ss%"
          - ""
          - "%zentrix_team_symbol% &r&f%zentrix_team_alive% &8(&7Your Team&8)"
          - "%zentrix_teams_row_1%"
          - "%zentrix_teams_row_2%"
          - "%zentrix_teams_row_3%"
          - ""
          - "&fKills: &a%zentrix_kills%"
          - ""
          - "&fBorder: &a%zentrix_border_size%"
          - ""
          - "&#FFD700play.example.net"
      win:
        title: "&#FFD700&lT&#FED804&lR&#FCDA08&lI&#FBDB0C&lO &#F8DE15&lR&#F7DF19&lO&#F5E11D&lY&#F4E221&lA&#F2E425&lL&#F1E529&lE"
        lines:
          - "&7%zentrix_date% &8%zentrix_clock% %zentrix_game_id%"
          - ""
          - "&fWinner:"
          - "&a%zentrix_winner%"
          - ""
          - "&fPlayers:"
          - "&a%zentrix_alive%&7/%zentrix_max_players%"
          - ""
          - "&fKills: &a%zentrix_kills%"
          - ""
          - "&#FFD700play.example.net"

  # ===========================================================================
  # SQUAD MODE (4 Players)
  # ===========================================================================
  squad:
    maximum-players: 100
    minimum-players: 40
    start-time: 80
    team-size: 4
    scoreboards:
      waiting:
        title: "&#FFD700&lS&#FED804&lQ&#FCDA08&lU&#FBDB0C&lA&#F8DE15&lD &#F7DF19&lR&#F5E11D&lO&#F4E221&lY&#F2E425&lA&#F1E529&lL&#F0E62D&lE"
        lines:
          - "&7%zentrix_date% &8%zentrix_clock% %zentrix_game_id%"
          - ""
          - "&fPlayers: &a%zentrix_players%&7/%zentrix_max_players%"
          - "&fStarting in: &aWaiting"
          - ""
          - "%zentrix_team_symbol% &r&f%zentrix_team_alive% &8(&7Your Team&8)"
          - "%zentrix_teams_row_1%"
          - "%zentrix_teams_row_2%"
          - "%zentrix_teams_row_3%"
          - ""
          - "&#FFD700play.example.net"
      starting:
        title: "&#FFD700&lS&#FED804&lQ&#FCDA08&lU&#FBDB0C&lA&#F8DE15&lD &#F7DF19&lR&#F5E11D&lO&#F4E221&lY&#F2E425&lA&#F1E529&lL&#F0E62D&lE"
        lines:
          - "&7%zentrix_date% &8%zentrix_clock% %zentrix_game_id%"
          - ""
          - "&fPlayers: &a%zentrix_players%&7/%zentrix_max_players%"
          - "&fStarting in: &a%zentrix_countdown%s"
          - ""
          - "%zentrix_team_symbol% &r&f%zentrix_team_alive% &8(&7Your Team&8)"
          - "%zentrix_teams_row_1%"
          - "%zentrix_teams_row_2%"
          - "%zentrix_teams_row_3%"
          - ""
          - "&#FFD700play.example.net"
      playing:
        title: "&#FFD700&lS&#FED804&lQ&#FCDA08&lU&#FBDB0C&lA&#F8DE15&lD &#F7DF19&lR&#F5E11D&lO&#F4E221&lY&#F2E425&lA&#F1E529&lL&#F0E62D&lE"
        lines:
          - "&7%zentrix_date% &8%zentrix_clock% %zentrix_game_id%"
          - ""
          - "&f%zentrix_next_phase% in:"
          - "&a%zentrix_phase_time_mm_ss%"
          - ""
          - "%zentrix_team_symbol% &r&f%zentrix_team_alive% &8(&7Your Team&8)"
          - "%zentrix_teams_row_1%"
          - "%zentrix_teams_row_2%"
          - "%zentrix_teams_row_3%"
          - ""
          - "&fKills: &a%zentrix_kills%"
          - ""
          - "&fBorder: &a%zentrix_border_size%"
          - ""
          - "&#FFD700play.example.net"
      win:
        title: "&#FFD700&lS&#FED804&lQ&#FCDA08&lU&#FBDB0C&lA&#F8DE15&lD &#F7DF19&lR&#F5E11D&lO&#F4E221&lY&#F2E425&lA&#F1E529&lL&#F0E62D&lE"
        lines:
          - "&7%zentrix_date% &8%zentrix_clock% %zentrix_game_id%"
          - ""
          - "&fWinner:"
          - "&a%zentrix_winner%"
          - ""
          - "&fPlayers:"
          - "&a%zentrix_alive%&7/%zentrix_max_players%"
          - ""
          - "&fKills: &a%zentrix_kills%"
          - ""
          - "&#FFD700play.example.net"