Turn Timer - GashiStudios

Why Turn Timers?

Nothing kills competitive momentum like a player who takes forever to move. Turn timers ensure every battle flows smoothly with fair time limits for decisions.

This is the per-turn timer (time you get to pick each move). CobbleRanked also has an optional per-match cumulative Player Timer (chess-clock style). The two are independent and can both be active.

How It Works

Each turn starts with full time
Timer counts down during move selection
Warning appears when time is low
If time runs out, a random move is auto-selected

Players see a boss bar countdown that changes color as time runs low. Audio warnings play near timeout.

Timer Colors

Green: Plenty of time
Yellow (30%): Think faster
Red (20%): Decide now

Default Timer Values

Format	Turn Timer	Team Selection	Lead Selection
Singles	90s	60s	30s
Doubles	120s	60s	30s
Triples	150s	60s	30s

Configuration

Format-specific timers are configured in season presets. Global timers (team selection, ready check, countdown) remain in battle.yaml.

Format-Specific Timers (Season Presets)

# season_presets/default.yml
singles:
  turnTimer: 90           # seconds per turn (set 0 to disable the turn timer)
  matchDuration: 15       # minutes total (set 0 to disable the match timer)
  playerTimerSeconds: 0   # per-player cumulative budget (0 = Player Timer off)

Set any timer to 0 to turn it off for that format. The Turn Timer, Match Timer, and Player Timer are independent — you can run any combination.

Global Timers (battle.yaml)

# battle.yaml
timers:
  teamSelectionSeconds: 60
  leadSelectionSeconds: 30
  matchReadySeconds: 17
  countdownSeconds: 5
  battleTimeWarningSeconds:
    - 300
    - 60
    - 30
  matchTimerDisplay: "ACTION_BAR"   # ACTION_BAR (default) or BOSS_BAR

Setting	Default	Description
`matchTimerDisplay`	`ACTION_BAR`	Where the match-duration timer is shown. `ACTION_BAR` packs every timer into the action bar; `BOSS_BAR` shows the match timer as a boss bar at the top of the screen, leaving the action bar for the turn + player timers only.

On Timeout

When the timer hits zero:

A random valid move is selected automatically
If no moves are available, Struggle is used
The turn proceeds without waiting

This applies to faint switches and turn-based switching too.

Timer Sounds

Audio cues help players track time:

# battle.yaml
sounds:
  battle:
    turnTimer30Percent:
      sound: "minecraft:block.note_block.harp"
      volume: 2.0
      pitch: 1.5
    turnTimer20Percent:
      sound: "minecraft:block.note_block.pling"
      volume: 3.0
      pitch: 2.0