Skip to content

Puzzle CAPTCHAs

Sepehr0Day edited this page Jun 13, 2026 · 2 revisions

Puzzle CAPTCHAs

SliderPuzzleCaptcha

Extracts a rectangular image piece and asks the user to move it horizontally into its slot.

Returns: ChallengeResult; answer is target x-coordinate.

Metadata includes:

  • background_path
  • piece_path
  • piece_start_x
  • target_x, target_y
  • piece_size
  • tolerance

Verify with abs(user_x - result.answer) <= tolerance.

Example: Examples/CaptchaExamples/SliderPuzzleCaptcha/

IrregularPuzzleCaptcha

Like the slider puzzle, but uses an irregular polygon piece and can generate a procedural background when image_path is omitted.

Key parameters: vertices, piece_radius, tolerance, image_path.

Example: Examples/CaptchaExamples/IrregularPuzzleCaptcha/

PatternCompletionCaptcha

Displays a repeating shape pattern with one missing shape.

Returns: ChallengeResult; answer is the zero-based option index.

Metadata includes pattern, missing_index, options and answer_is_zero_based.

Example: Examples/CaptchaExamples/PatternCompletionCaptcha/

MazeCaptcha

Generates and solves a randomized maze.

Answer modes:

  • directions: list such as ["right", "down", ...]
  • path: list of grid cells
  • exit: exit cell

Use directions for interactive clients and validate the final move list on the server.

Example: Examples/CaptchaExamples/MazeCaptcha/

Clone this wiki locally