# Nexus.Input — Input Controllers & Humanization

## IInputController Implementations

### SendInputController (Default, No Driver)

Uses Win32 `SendInput` API with **KEYEVENTF_SCANCODE** flag. Games read hardware scan codes, not virtual key codes.

- **KeyDown/KeyUp**: Raw keyboard scan code via SendInput struct
- **KeyPress**: Down → Sleep(holdMs) → Up with humanization
- **SmoothMoveTo**: Cubic Bézier curve interpolation (10-40 steps) with random perpendicular spread
- **MouseMoveTo**: Direct `SetCursorPos()` (instant teleport)
- **Clicks**: Smooth move to target → humanized delay → click

### InterceptionInputController (Driver-Based)

Uses Interception keyboard/mouse driver for lower-level control:
- Delegates to `KeyboardHook` and `MouseHook` via InputInterceptor COM library
- Same smooth movement and humanization as SendInput
- Returns false from `Initialize()` if driver not installed (graceful fallback)

### SimInputController (Simulator)

Implements `IInputController` but doesn't make Win32 calls. Instead:
- **WASD** → Tracks held state, converts to direction vector with 45° isometric rotation
- **Skills** → Queues skill casts to SimWorld via `QueueSkill()`
- **Mouse** → Tracks screen position, converts to world coords via inverse camera matrix
- **Visualization** → Maintains flash timers (0.15s) for InputOverlayRenderer

## Scan Codes

```
Movement:  W=0x11  A=0x1E  S=0x1F  D=0x20
Skills:    Q=0x10  E=0x12  R=0x13  T=0x14
Numbers:   1=0x02  2=0x03  3=0x04  4=0x05  5=0x06
Modifiers: LShift=0x2A  LCtrl=0x1D  LAlt=0x38
Other:     Space=0x39  Enter=0x1C  Escape=0x01  Slash=0x35
```

## Humanizer

Anti-detection layer applied to all input operations.

| Method | Purpose |
|--------|---------|
| GaussianDelay(baseMs) | Adds gaussian noise (Box-Muller transform), clamped to [50ms, 150ms] |
| JitterPosition(x, y) | Random pixel offset within ClickJitterRadius (3px) |
| ShouldThrottle() | Tracks actions in 60-second rolling window, blocks if APM > MaxApm (250) |
| RecordAction() | Enqueues timestamp for APM tracking |
| RandomizedInterval(baseMs) | Adds ±20% jitter to poll intervals |

## MovementKeyTracker

Converts normalized direction vectors to WASD key state for isometric camera:

```
Rotate direction 45°:
  sx = dir.X * cos(45°) - dir.Y * sin(45°)
  sy = dir.X * sin(45°) + dir.Y * cos(45°)

Key mapping:
  W if sy > 0.3,  S if sy < -0.3
  D if sx > 0.3,  A if sx < -0.3

Delta-based: only sends KeyDown/KeyUp when state changes.
Supports holding multiple keys (W+D for diagonal).
```