simulation done

docs/input.md

@@ -0,0 +1,67 @@
+# 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).
+```