Scoring & Events

Game Scoring & Special Events

During a game, each game updates the sidebar scoreboard in real time via onScoreChange, and triggers onGameEvent to award immediate rewards at milestones. Cross-reference to Game Modes.

Game	Scoring Rule	Special-Event Reward
2048	Each merge = sum of merged tile values	Reach 2048 → +50 tokens
Minesweeper	+10 per safe cell revealed	Plays hurt sound on mine hit
Whack-a-Mole	+1 per hit, +2 extra on a 3-combo	Hit a golden mole → +5 tokens
Bejeweled	N gems cleared = N×10×chain multiplier	4+ chain → +N tokens each
Lottery	Each draw consumes 1 ticket (or tokens)	Prize-pool random reward (tokens/coins/commands)
Slot Machine	Each spin consumes tokens	Three-of-a-kind → jackpot pool; two-of-a-kind → fixed tokens
Maze	Faster completion = higher score	Base 30 tokens; -2 per extra 10s (min 5)
Battleship	+100 per hit, +500 per sink	Sink reward = ship size × 5 tokens
Connect 4	+1 per drop, +4 on win	Form a 3-in-a-row threat → +2 tokens
Tic-Tac-Toe	+3 win, +1 draw	Form a 2-in-a-row threat → +1 token
Rock-Paper-Scissors	+2 win, +1 draw	2-streak +2, 3-streak +3 tokens
Snake	+10 per food eaten	Every 50-score milestone → +1 token
Dino Run	+1 per alive tick	Every 50-score milestone → +1 token
Chess	Win 200 + capture value×10, Draw 100 + capture value×5	—
Monopoly	Settled by win / draw / lose outcome	Win +10, Draw +3, Lose +2 tokens (extra reward for correct 3-player bet)

PlaceholderAPI Placeholders

Once PlaceholderAPI is hooked, the following placeholders are available:

Placeholder	Description
%gamebox_tokens%	Current player's token balance
%gamebox_highscore_<id>%	Current player's high score in a game (e.g. %gamebox_highscore_2048%)
%gamebox_ingame%	Whether the current player is in a game (true/false)