Guide › Modules
Wheel of Fortune
Weighted segments that add time, remove time, freeze the clock, assign a random training task, or do nothing — with a cooldown between spins.
🎡 The wheel is chance with consequences. One spin, one segment, one event — and the clock moves, or a task appears, or nothing happens this time.
Spinning
- The session must be locked and not frozen.
- There is a cooldown between spins: 60 minutes by default (
Settings → Wheel). The dashboard button reads ready when you can spin. - A spin earns 5 XP and lands in the log with the segment it hit.
Whatever the wheel does, it does through the core: time changes are adjustment events, a freeze is a real timed freeze, a task is a real assignment from your training library.
Segments
Each segment has a label, a weight, an effect, a value and a colour.
| Effect | What happens | Value |
|---|---|---|
add |
time is added to the clock | minutes |
remove |
time is taken off the clock | minutes |
freeze |
the clock freezes for this long, then thaws itself | minutes |
task |
a random enabled task that is not already open is assigned to this session | — |
nothing |
"Nothing happens… this time" | — |
Weight is probability, not size
Wedges are drawn equal, as on a real wheel. A segment with weight 3 is three times as likely as one with weight 1; it does not get a bigger slice. Weight 0 never lands.
Segments can be disabled without deleting them; a disabled one is not drawn and not shown.
Editing is on Settings → 🎡 Wheel of Fortune.
The default wheel
| Label | Weight | Effect |
|---|---|---|
| +30 min | 3 | add |
| +1 hour | 3 | add |
| +3 hours | 2 | add |
| +12 hours | 1 | add |
| −30 min | 2 | remove |
| −1 hour | 1 | remove |
| Freeze 1h | 1 | freeze |
| Random task | 2 | task |
| Nothing | 2 | nothing |
Time added outweighs time removed on purpose. Change it to taste.
History
The wheel page lists past spins with what each one did. On the dashboard the wheel card shows the last result and the cooldown remaining.
Undo
A spin can be undone within the window like any adjustment — unless it started a freeze or assigned a task. Those carry their own events; undo them first.
API
POST /api/v1/wheel/spin spins as the calling actor; GET /api/v1/wheel/segments lists the
wheel. See API.
This page is docs/wheel.md in the repo. Spotted a mistake? Tell us how to report it →