Wheel of Fortune
The Wheel of Fortune is a game of chance that adds unpredictability to your lock session. Spin the wheel and accept whatever fate decides — rewards, punishments, or something in between.
How It Works
The wheel displays 3 to 8 colored segments, each configured with a different outcome. When you spin, the server selects one segment using cryptographically secure random selection — no one can predict or manipulate the result.
The wheel animates for 4 seconds before landing on the server-chosen segment. The outcome is applied immediately.
After each spin, a cooldown timer starts. You must wait before spinning again. The cooldown is configured by the keyholder or lock creator, ranging from 1 minute to 24 hours.
Spin Outcomes
Each segment on the wheel has a type that determines what happens when it lands. All outcomes have equal probability.
Time Change (Reward / Punishment)
| Direction | Effect |
|---|---|
| Reward (negative seconds) | Removes time from your lock — you get closer to unlocking |
| Punishment (positive seconds) | Adds time to your lock — the countdown gets longer |
Time changes range from 15 minutes up to 1 full day. Available presets: 15 min, 30 min, 1 hour, 2 hours, 3 hours, 6 hours, 12 hours, 1 day.
If the Card Game module is also enabled, time changes may translate into Red or Green cards based on the card configuration, rather than direct time adjustments.
Freeze / Unfreeze
| Outcome | Effect |
|---|---|
| Freeze | Pauses the lock countdown for a set duration (15 min to 24 hours). The timer stops until the freeze ends. |
| Unfreeze | Immediately removes any active freeze and resumes the countdown. |
Freeze durations are configured per segment. Available presets: 15 min, 30 min, 1 hour, 2 hours, 3 hours, 4 hours, 6 hours, 8 hours, 12 hours, 24 hours.
The wheel can be configured to hide entirely while the lock is frozen, replacing the spinner with a freeze message instead.
Shock / Vibrate
Triggers a physical shock or vibration on your connected device.
- Duration is configured per segment: 10s, 20s, 30s, 45s, 1 min, 1.5 min, 2 min, or 3 min
- Intensity can optionally be set per segment (0–100%)
- If no intensity is configured, your default shock settings are used
- For QIUI devices: resolved to the nearest 4-step level (1–4), capped by your safety setting
- For Lockink devices: applied as a voltage percentage of your capped voltage
The Android app uses Google Play Activity Recognition to automatically block shocks while driving or cycling. Shocks are also blocked if GPS detects movement above walking speed. See Supported Devices — Driving Safety for details.
Pillory
Sends the wearer to the pillory for a set duration. This outcome is only available if the Pillory module is enabled on the lock.
Pillory durations range from 15 minutes to 24 hours.
Task Assignment
Assigns a task to the wearer. This outcome is only available if the Task module is enabled on the lock.
Two modes:
- Random Task — picks any task from the task pool
- Specific Task — always assigns the same chosen task
Text / Message
Displays a custom message on screen. No server-side effect — purely for flavor, roleplay, or instructions.
Configuration
The wheel is configured during lock setup or via the Edit Wheel button on the game page.
Segment Setup
- Each wheel requires 3 to 8 segments
- Each segment has a type, duration, optional intensity, and a label
- Segments are color-coded with 8 preset colors that cycle automatically
- Labels are auto-generated but can be customized (up to 50 characters)
- A live preview wheel shows your configuration in real time
- A Test Spin button lets you try the wheel locally — test spins do not call the server
Edit Permissions
| Lock Type | Who Can Edit | Setting |
|---|---|---|
| Self lock | Wearer | "Allow to edit after session start" — controls whether the wheel can be changed once the timer is running |
| Shared lock (keyholder) | Keyholder | "Allow you to edit wheel while wearer has started lock" |
| Shared lock (wearer) | Wearer | "Allow you to edit wheel while locked" |
Cooldown Between Spins
The minimum wait time between spins. Configured in days, hours, and minutes.
- Range: 1 minute to 24 hours (1440 minutes)
- Default: 60 minutes
- Displayed as a countdown on the spin button (e.g., "Wait 1h 23m")
Penalty System Integration
The penalty system can require a minimum number of daily wheel spins.
wheelSpinsPerDay: If set (1–100), the wearer must spin at least this many times per day- Daily counters reset at midnight in the wearer's timezone
- If daily requirements are not met, the penalty system applies additional time or cards to the lock
- If the wheel module is disabled while a daily spin requirement is active, the requirement is automatically cleared
Module Dependencies
The wheel integrates with other lock modules:
| If You Disable... | Effect on Wheel |
|---|---|
| Task module | All "Task" type segments are removed. If fewer than 3 segments remain, the wheel module is disabled entirely. |
| Pillory module | All "Pillory" type segments are removed. If fewer than 3 segments remain, the wheel module is disabled entirely. |
| Wheel module | Any daily spin requirement in the penalty config is cleared. |
Notifications
| Event | Who Receives | When |
|---|---|---|
| Wheel result notification | Wearer | 10 seconds after the spin completes |
| Spin result | Keyholder | Immediately after spin (shared locks only) |
Frequently Asked Questions
Can the outcome be predicted or manipulated?
No. The server uses cryptographically secure random number generation to select the outcome. Neither the wearer nor the keyholder can predict or influence which segment will be selected. All segments have exactly equal probability.
Can I edit the wheel while my lock is running?
It depends on the edit permissions configured during setup. For self-locks, "Allow to edit after session start" controls this. For shared locks, the keyholder and wearer each have their own edit permission toggle.
What happens if I have no device connected and a shock segment lands?
If no shock-capable device is connected, the app will attempt to use a vibration-capable device instead. If no device is available at all, an error message is shown.
Does the wheel work with the Card Game?
Yes. When both the Wheel and Card Game modules are enabled, time-based wheel outcomes (rewards and punishments) may translate into cards rather than direct time changes, depending on the card configuration.