Games and the game gate
A site key can require every visitor to play a game to pass, instead of clearing only the quiet background check. This is the game gate. Setting it up has two parts: register the games the key may use, then turn the gate on. Both work on the free plan.
Register games
Before a key can use a game, you register (install) it on that key. Registering takes a pinned, verified snapshot of the game, so the exact version your visitors play is the one Caputchin can re-run when it checks a result.
Open the site key and go to its Games page. In the Add a game panel, search for a game in the Marketplace game box and select it (or click Open). Caputchin registers it, snapshots it, and opens its settings; the game then appears under Registered games.
Almost every marketplace game can gate the key as soon as you register it, and all the first-party games can. If a rare game has no replay build Caputchin can re-run, it shows a Not replayable badge on your Games list once you register it and cannot gate until the author ships a replayable version, so pick a different game for the gate.
Register games on a single site key, or once on the troop to share the same set across every key in it. A key sees its own registered games plus any the troop registered.
Require a game (the gate)
Open the key's Security page and turn on Require a game to verify. With it on, every visitor must clear one of the key's registered games to pass. Caputchin chooses which game each visitor gets and issues it through a one-time, signed ticket, so a visitor cannot pick the game, skip it, or swap it for an easier one.
You cannot turn the gate on until at least one game is registered, so register one first. Leaving the gate off is the less secure choice: the key can be passed without playing a game at all.
To gate every key in a troop at once, a troop has its own Security page with Require a game on every site key. When that is on, each key in the troop is gated regardless of its own setting.
On your page
A gated key serves the game through the <caputchin-game> element. You do not have to name a game: Caputchin serves one of the key's registered games and picks it per visit. You may pass a specific id, or a short list to rotate among, but each must be registered on the key, and naming one that is not registered will not load it.
The plain checkbox element cannot satisfy a gated key, so use <caputchin-game> on any key that requires a game.
See also
- Add a game from the marketplace for the step-by-step walkthrough.
- Security for the rest of a key's protection, including where the gate toggle lives.
- Customize the games to set a game's language, skin, or difficulty.
- Site keys for the rest of a key.