Minigames

Minigames are interactive challenges that occur during contests. They add a skill-based component to scoring beyond move selection.

Category Mapping

By default, each contest category is linked to a specific minigame:

Category	Default Minigame
Cool	Rhythm Challenge
Beauty	Appeal Timing
Cute	Audience Wave
Clever	Sequence Building
Tough	Balance Precision

This mapping is configurable per-hall in the minigames.category-mapping section.

Available Minigames

Rhythm Challenge (Cool)

A Guitar Hero-style note-hitting game. Notes fall from the top of the screen and players must click when they reach the target zone.

Setting	Default	Description
`nbs-file`	`"contest_rhythm.nbs"`	NBS music file that drives the note pattern
`difficulty`	`"medium"`	Difficulty level
`note-speed`	`1.0`	Speed notes fall at
`perfect-window`	`100`	Milliseconds for a perfect hit
`good-window`	`200`	Milliseconds for a good hit
`lane-count`	`3`	Number of note lanes

Scoring: Perfect = 100, Good = 60, OK = 30. Streak bonuses: 5-hit = 1.5x, 10-hit = 2.0x. Duration: 30 seconds.

Appeal Timing (Beauty)

A meter fills up and players must click at the peak moment for maximum appeal.

Setting	Default	Description
`rounds`	`5`	Number of timing rounds
`fill-speed`	`50`	Speed the meter fills
`perfect-window.start`	`8`	Perfect zone start (out of 10)
`perfect-window.end`	`10`	Perfect zone end

Scoring: Perfect = 150, Good = 80, OK = 40. Duration: 20 seconds.

Audience Wave (Cute)

Guide an audience wave to its crest. Click at the right moment when the wave peaks.

Setting	Default	Description
`waves`	`5`	Number of waves
`wave-speed`	`1.0`	Wave movement speed
`reaction-window`	`500`	Milliseconds to react

Scoring: Perfect = 50, Good = 30, OK = 15. Full combo = 2.0x final score. Duration: 25 seconds.

Balance Precision (Tough)

A moving indicator must be stopped in a target zone. Click to lock in your position.

Setting	Default	Description
`rounds`	`5`	Number of balance rounds
`balance-speed`	`1.0`	Indicator movement speed
`target-zone-size`	`3`	Size of the target zone

Scoring: Perfect center = 120 (3.0x bonus), Good = 70, OK = 35. Duration: 35 seconds.

Sequence Building (Clever)

A memory game where players must repeat and extend colored patterns.

Setting	Default	Description
`rounds`	`5`	Number of sequence rounds
`sequence-length`	`5`	Maximum sequence length
`memory-time`	`3000`	Time (ms) to memorize the pattern

Scoring: Perfect recall = 200, Good = 100, OK = 50. Speed bonus: +50% for completing before time limit. Duration: 45 seconds.

Selection Modes

Mode	Description
`category_based`	Minigame is determined by contest category (default)
`random`	Random minigame is chosen each contest
`sequential`	Cycles through all minigames in order
`player_choice`	Players vote on which minigame to play
`disabled`	No minigames

Score Weight

The score-weight setting (0.0-1.0) determines how much minigame performance affects the total contest score:

0.0 — Minigame is purely for fun, no score impact
0.2 — 20% of total score comes from minigame (default)
1.0 — Minigame score has equal weight to appeal score

Skipping

If allow-skip = true in the hall config, players can skip the minigame at a score penalty defined by skip-penalty (default 0.5 = 50% of what they would have earned).

Minigame Launch Sequence

Explainer (5 seconds) — Rules, controls, and scoring are displayed
Countdown (3 seconds) — 3… 2… 1…
GO! — Minigame starts
Play — Player interacts with the minigame
Results — Score is shown with ranking among contestants

Bot Performance

Bot contestants simulate minigame play based on their difficulty level:

Bot Difficulty	Score Range	Perfect Input Chance	Miss Chance
Easy	40-60%	10%	20%
Medium	55-75%	20%	15%
Hard	70-90%	30%	10%
Expert	85-98%	50%	5%

Testing

Admins can test minigames directly:

/minigame rhythm                           # Test with defaults
/minigame rhythm my_song.nbs              # Test with specific NBS file
/minigame rhythm my_song.nbs 120.0        # Test with custom BPM
/minigame balance                          # Test balance minigame
/minigame sequence                         # Test sequence minigame

Next Steps

Music & Beatmaps — NBS files and rhythm minigame backing tracks
Bots — How AI contestants perform in minigames
Hall Configuration — Configure minigames per-hall