Overlay troubleshooting

"Premium required" panel after sign-in

The overlay calls GET /api/overlay/entitlement on launch and on every server switch. You'll see this panel if:

• You don't have an active Operator or Overlord subscription.
• You're a guest, but the owner of the server you picked doesn't have an eligible sub.

Either upgrade (Settings → Subscription) or ask the host to upgrade.

The overlay is invisible in-game

• Cause: Rust is running in exclusive fullscreen, which blocks every overlay (Discord, CrosshairX, OBS).
• Fix: Switch to Fullscreen Borderless or Windowed in Rust's display settings.

F8/F9 don't do anything

• Cause: Another global hotkey app (Streamdeck, AutoHotkey, etc) registered F8/F9 first.
• Fix: Unbind F8/F9 in the conflicting app, restart the overlay.

Markers appear in the wrong place

• The overlay reads worldSize from Rust+. If your server is custom-map-served, worldSize might not match the rendered map. v2 ships a relay-normalised map tile to fix this.
• Workaround: re-pair the server (Settings → server picker → unpair → re-pair).

Overlay window doesn't move when I drag it

• Click-through is on. Press F9 to flip to interactive mode, drag, then F9 again to flip back.

SmartScreen / Gatekeeper warning on install

Unsigned beta builds will warn. Right-click → Open (macOS) or More info → Run anyway (Windows). Retail builds are signed and won't warn.

High CPU when not playing Rust

• The overlay holds a WebSocket. If the relay is throttled (rate-limited by Facepunch), the overlay's reconnect logic backs off and CPU should drop. If it stays high, file a bug with the latest log from %APPDATA%/Rust Pulse Overlay/logs/ (Windows) or ~/Library/Logs/Rust Pulse Overlay/ (macOS).