BlockcadeDocumentation ← Portfolio

#games.yml

#Defaults

defaults:
  enabled: true
  countdown-seconds: 3
  tick-period: 4
  score-multiplier: 1.0

A per-game value overrides its matching default. Disabling a game hides it from playable menu entries and direct starts.

#Tick period

tick-period is measured in server ticks. Lower values update more often:

ValueMaximum simulation rate at 20 TPS
120 updates per second
210 updates per second
45 updates per second

Do not expect values below 1 or FPS settings to raise Paper's game logic above 20 TPS.

#Game-specific options

PathMeaning
games.snake.width, heightSnake board dimensions, each from 8 to 64
games.pong.score-limitPoints required to win
games.breakout.livesStarting lives
games.minesweeper.<difficulty>.widthDifficulty board width
games.minesweeper.<difficulty>.heightDifficulty board height
games.minesweeper.<difficulty>.minesMine count, leaving room for the safe first-click area

score-multiplier changes the score displayed and saved by Blockcade without rewriting a game's internal rules.

Restart after changing board dimensions. Other settings are safest to apply after ending active sessions and restarting.