ESP Overlay

The ESP Overlay draws real-time information about other players on top of the CS2 window - bounding boxes, skeletons, health bars, names, and snaplines - using the pyMeow overlay library.

How It Works

Each frame, VioletWing reads the game's entity list from memory, resolves up to 32 player entries, and projects their 3D world positions to 2D screen coordinates using CS2's view matrix. Only entities that are alive and not dormant are drawn.

The overlay runs at a configurable target FPS with frame pacing to stay consistent without pegging your CPU.

Visual Elements

Bounding Box - A rectangle sized proportionally to the player's on-screen height. A darker filled background makes it easy to spot at a glance.

Skeleton - Lines connecting 17 tracked bone points: full spine, both arms, both legs. Skeleton rendering reads a bone matrix per entity per frame - disable it if you notice CPU impact.

Health Bar - A vertical bar to the left of each box shows current health as a percentage. Color changes by threshold:

• Green - above 50 HP
• Yellow - 21–50 HP
• Red - 20 HP or below

An optional numeric value can be shown beside the bar.

Player Name - Drawn above the bounding box. If the name contains Cyrillic characters, the optional transliteration feature converts them to Latin equivalents.

Snaplines - Lines from the center of your screen to each visible player's head. Useful for scanning positions around the map.

Teammate Visibility

Teammates are not drawn by default. Enable Draw Teammates to show them with a separate configurable color (default: cyan).

Color Options

Colors are specified as hex strings. Quick-select options in the GUI:

• Orange #FFA500
• Red #FF0000
• Green #00FF00
• Blue #0000FF
• White #FFFFFF
• Black #000000
• Cyan #00FFFF
• Yellow #FFFF00

Requirements

The overlay requires pyMeow. The pre-built executable includes it. If running from source, see Build from Source.

CS2 must run in windowed or borderless windowed mode. Exclusive fullscreen is not supported.

Configuration Reference

"Overlay": {
  "target_fps": 60,
  "enable_box": true,
  "enable_skeleton": false,
  "draw_snaplines": true,
  "snaplines_color_hex": "#FFFFFF",
  "box_line_thickness": 1.0,
  "box_color_hex": "#FFA500",
  "text_color_hex": "#FFFFFF",
  "draw_health_numbers": true,
  "use_transliteration": false,
  "draw_nicknames": true,
  "draw_teammates": false,
  "teammate_color_hex": "#00FFFF"
}