phases.yml

phases.yml defines the phase timeline for Battle Royale.

A phase is a timed segment with:

• a duration

• optional border movement and damage

• optional “on start” actions (titles, sounds, PvP toggles, items, effects)

If you want the player-facing match flow, read Phases.

Where to find it

Generated after the first server start:

• plugins/Zentrix/phases.yml

What you edit here

• Phase order (top-to-bottom in the file)

• Phase timers and transitions

• Border pacing and border damage

• What runs at the start of each phase

Start with small changes. Test a full match after each edit.

Concept overview (timeline)

Phases execute one after another, like a match “timeline”.

The default sequence is:

1. dragon_scatter

2. preparation

3. pvp

4. deathmatch

Configuration structure

Everything is defined under the root phases: key.

Each phase is a keyed block like phases.<phase-id>:.

phases:
  <phase-id>:
    displayName: "<name shown to players>"
    duration: <seconds>
    border:
      doShrinkage: <true|false>
      shrinkTo: <radius-in-blocks>
      duration: <seconds>
      damagePerBlock: <double>
      warningTime: <seconds>
      warning:
        type: TITLE
        title:
          main: "<text>"
          sub: "<text>"
          fadeIn: <ticks>
          stay: <ticks>
          fadeOut: <ticks>
    on-start:
      - <action>: <payload>
      - <action>: <payload>

duration

How long the phase lasts, in seconds.

duration: 900

Border settings (border)

Border settings control whether the world border moves during a phase. They also control how punishing it is to be outside.

doShrinkage

If true, the border moves toward shrinkTo. If false, the border stays static.

doShrinkage: true

shrinkTo

The target border radius in blocks.

shrinkTo: 300

duration (inside border)

How long the border takes to reach shrinkTo, in seconds.

This effectively controls the “speed” of the shrink.

duration: 1800

damagePerBlock

How much damage is dealt:

• per second

• per block outside the border

So the farther out you are, the more damage you take.

damagePerBlock: 8.0

Warnings (warningTime, warning)

Warnings are phase-end alerts shown shortly before the phase finishes.

warningTime

How many seconds before phase end the warning triggers.

warningTime: 15

warning

What gets shown when the warning triggers.

The default uses type: TITLE, which supports:

• main and sub text

• title timings (fadeIn, stay, fadeOut) in Minecraft title ticks

warning:
  type: TITLE
  title:
    main: "&#FF6700&lWARNING"
    sub: "&fGet ready, PvP is about to enable!"
    fadeIn: 10
    stay: 40
    fadeOut: 10

Actions reference (on-start)

on-start is a list of actions. They run in order when the phase begins.

Each list entry should contain exactly one action key.

title

Shows a title + subtitle to all players.

- title:
    main: "&#FF6700&lPvP Enabled"
    sub: "&fBattle begins, PvP is now enabled!"
    fadeIn: 10
    stay: 40
    fadeOut: 10

sound

Plays a sound effect to all players.

- sound:
    name: BLOCK_ANVIL_LAND
    volume: 1.0
    pitch: 0.8

togglePVP

Enables or disables PvP for the arena.

- togglePVP:
    enable: true

giveItem

Gives every player an item.

itemId must be a valid Bukkit Material name.

- giveItem:
    itemId: GOLDEN_APPLE
    count: 3

giveEffect

Applies a potion effect to all players.

- giveEffect:
    effect: GLOWING
    duration: 600
    amplifier: 0

startDeathmatch

Triggers the internal deathmatch logic. This handles the deathmatch teleport and world generation.

- startDeathmatch: {}

Example breakdown: Phase 3 (pvp)

This is what a “PvP enabled” phase usually does:

• turns PvP on

• starts shrinking the border

• announces it (title + sound)

• optionally gives supplies

pvp:
  displayName: "PvP Enables"
  duration: 1800

  border:
    doShrinkage: true
    shrinkTo: 300
    duration: 1800
    damagePerBlock: 8.0

  on-start:
    - togglePVP:
        enable: true
    - title:
        main: "&#FF6700&lPvP Enabled"
        sub: "&fBattle begins, PvP is now enabled!"
        fadeIn: 10
        stay: 40
        fadeOut: 10
    - sound:
        name: BLOCK_ANVIL_LAND
        volume: 1.0
        pitch: 0.8
    - giveItem:
        itemId: GOLDEN_APPLE
        count: 3

How this plays out logically:

• togglePVP.enable: true makes combat legal.

• border.doShrinkage: true starts movement immediately.

• border.shrinkTo: 300 is the target radius.

• border.duration: 1800 means “shrink over the full phase”.

• damagePerBlock: 8.0 punishes players staying outside the border.

• sound + title are broadcast cues.

• giveItem gives everyone 3x GOLDEN_APPLE at phase start.

Default configuration

Expand: default phases.yml

# -----------------------------------------------------------------------------
# Zentrix Battle Royale - Phase Configuration
# Developed by Harsh
# -----------------------------------------------------------------------------

# =============================================================================
# PHASE SYSTEM OVERVIEW
# =============================================================================
# Phases control the flow of the game, executing sequentially.
# Each phase handles border movement, PvP states, and specific game events.

# AVAILABLE ACTIONS (for 'on-start'):
#   - title:            Display a title/subtitle to all players.
#   - sound:            Play a sound effect.
#   - togglePVP:        Enable (true) or Disable (false) PvP.
#   - giveItem:         Give players a specific item (Material name).
#   - giveEffect:       Apply a potion effect to all players.
#   - startDeathmatch:  Triggers the deathmatch teleport and world generation.

# BORDER SETTINGS:
#   doShrinkage:    If true, the border moves. If false, it stays static.
#   shrinkTo:       The target size (radius) the border will reach.
#   duration:       Time (in seconds) the border takes to reach 'shrinkTo'.
#   damagePerBlock: Damage dealt per second per block outside the border.

phases:

  # ===========================================================================
  # PHASE 1: DRAGON SCATTER
  # ===========================================================================
  # Players are dropping from the dragon/gliding.
  dragon_scatter:
    displayName: "Dragon Scatter"
    duration: 120                   # Phase lasts 2 minutes

    border:
      doShrinkage: false
      shrinkTo: 0                   # Ignored (Static)
      duration: 0
      damagePerBlock: 2.0

      # Phase End Warning
      warningTime: 20
      warning:
        type: TITLE
        title:
          main: "&#00FF00&lPvP is about to disable"
          sub: "&fPreparation phase is going to start!"
          fadeIn: 10
          stay: 40
          fadeOut: 10

    on-start:
      - title:
          main: "&#FBD400&lDescent"
          sub: "&#D2D1D2Jump from your dragon to begin the match!"
          fadeIn: 10
          stay: 40
          fadeOut: 10
      - togglePVP:
          enable: true              # PvP allowed while dropping

  # ===========================================================================
  # PHASE 2: PREPARATION (GRACE PERIOD)
  # ===========================================================================
  # Players gather resources. PvP is disabled.
  preparation:
    displayName: "Preparation"
    duration: 900                   # Phase lasts 15 minutes

    border:
      doShrinkage: false
      shrinkTo: 0                   # Ignored (Static)
      duration: 0
      damagePerBlock: 2.0

      # Phase End Warning
      warningTime: 15
      warning:
        type: TITLE
        title:
          main: "&#FF6700&lWARNING"
          sub: "&fGet ready, PvP is about to enable!"
          fadeIn: 10
          stay: 40
          fadeOut: 10

    on-start:
      - togglePVP:
          enable: false             # Disable PvP (Grace Period)
      - title:
          main: "&#00FF00&lPreparation Begins"
          sub: "&fGather resources and prepare for battle!"
          fadeIn: 10
          stay: 40
          fadeOut: 10

  # ===========================================================================
  # PHASE 3: PVP ENABLED
  # ===========================================================================
  # Main gameplay loop. Border shrinks, PvP is on.
  pvp:
    displayName: "PvP Enables"
    duration: 1800                  # Phase lasts 30 minutes

    border:
      doShrinkage: true
      shrinkTo: 300                 # Shrink to 300 block radius
      duration: 1800                # Slowly shrink over the full 30 mins
      damagePerBlock: 8.0

    on-start:
      - togglePVP:
          enable: true             # Enable PvP (Grace Period)
      - title:
          main: "&#FF6700&lPvP Enabled"
          sub: "&fBattle begins, PvP is now enabled!"
          fadeIn: 10
          stay: 40
          fadeOut: 10
      - sound:
          name: BLOCK_ANVIL_LAND
          volume: 1.0
          pitch: 0.8
      - giveItem:
          itemId: GOLDEN_APPLE
          count: 3

  # ===========================================================================
  # PHASE 4: DEATHMATCH
  # ===========================================================================
  # Final showdown. Fast shrinking border, high damage.
  deathmatch:
    displayName: "Deathmatch"
    duration: 600                   # Phase lasts 10 minutes

    border:
      doShrinkage: true
      shrinkTo: 5                   # Shrink to near-zero (5 blocks)
      duration: 480                 # Shrink fast (8 minutes)
      damagePerBlock: 10.0          # High border damage

    on-start:
      - startDeathmatch: {}         # INTERNAL: Triggers DM teleport logic
      - title:
          main: "&#FF0000&lDeathmatch Begins"
          sub: "&fThe final showdown! Last player standing wins!"
          fadeIn: 10
          stay: 50
          fadeOut: 10
      - sound:
          name: ENTITY_ENDER_DRAGON_GROWL
          volume: 1.0
          pitch: 1.5
      - giveEffect:
          effect: GLOWING
          duration: 600
          amplifier: 0