playto / Docs / Overlay

Overlay

The overlay displays translated text on top of your game. It also supports learning modes that test your vocabulary during gameplay.

Display

The overlay is an always-on-top, transparent, click-through window that sits over your game. It automatically positions itself based on the translation mode:

  • Cursor mode — bottom of screen, resizes based on result count
  • Fixed/Region mode — below the capture region
  • Custom position — drag to reposition the overlay

Text alignment can be set to left, center, or right.

Cloze Mode

Fill-in-the-blank vocabulary test right in the overlay while you play.

How it works:

  • 1-2 non-basic words are randomly replaced with underscores
  • Basic words (A1/A2 level or <3 characters) are never masked
  • Masked words show as ______ with a purple background
  • After 3 seconds, the answer auto-reveals in cyan (#67e8f9)

CEFR Highlighting

Words in the overlay are color-coded by estimated CEFR difficulty level. At a glance, you can see which words are beginner-friendly and which are advanced.

LevelRuleColor
A1/A2Common basic words (~300 word list)No highlight
B15 or fewer charactersAmber #fbbf24
B26-8 charactersOrange #f97316
C1+9+ characters or complexRed #ef4444

Classification uses a hardcoded A1/A2 word list plus character-length heuristics for B1-C1. Currently optimized for English text.

Customization

Adjust the overlay to your preferences in Settings:

  • Font size — scalable (default 18px)
  • Font color — custom hex (default white)
  • Line height — adjustable multiplier (default 1.4)
  • Opacity — 0-100% (default 80%)
  • Text alignment — left, center, or right
  • Learning mode — full (show everything), hard (CEFR highlight only), cloze, or off