Moonlight AI Configuration Overview
A practical guide to configuring Moonlight AI from first launch to daily use.
First Launch
On your first launch, Moonlight AI opens a 7-step setup wizard that handles all required configuration. This takes about one minute.
Step 1: Capture Setup
Select how Moonlight AI receives video input from your game.
Capture Card is the most common choice for dual-PC or console setups
Screenshot works for single-PC setups without a capture card
UDP is for network streaming configurations
The wizard automatically scans for available devices and formats. Select your device and the highest resolution/frame rate it supports (typically 1920x1080).
Step 2: Input Device
Select the hardware device that controls your mouse.
MAKCU and Ferrum are the most common USB HID devices
Titan Two is for controller-based setups
Moonlink devices connect via USB
If your device uses a serial connection (Ferrum, KMBox), the wizard detects the COM port automatically.
Step 3: Game and FOV
Select your game from the preset list. This sets the correct field of view value for accurate sensitivity scaling. If your game isn't listed, choose Custom and enter your FOV manually.
Verify this matches your actual in-game FOV setting.
Step 4: Detection Model
Select the AI model for target detection.
Universal models work across all games — start here
Game-specific models are more accurate but only work for one game
Leave the backend as ONNX (GPU) unless you have a specific reason to change it.
Step 5: DPI and Sensitivity
Enter your mouse DPI and your game's sensitivity setting. These values are used to normalize aim speed so movement feels consistent regardless of your hardware setup.
Common DPI values: 400, 800, 1600, 3200.
Step 6: Aim Style
Choose an aim preset. Legit is recommended for most users — it provides natural-looking aim assist that's effective without being obvious.
You can change this at any time from the Aim page.
After the Wizard
The wizard applies your settings and opens the main window on the Aim page. A brief hint explains the two remaining steps:
Check Aim Enabled
Click Start Moonlight in the sidebar
Make sure your game is visible on the capture device before starting.
What to Configure First
After completing the wizard, most settings have sensible defaults. Here's what actually matters in order of priority.
Required (Cannot Work Without These)
These are handled by the wizard. Verify they're correct if anything seems wrong.
Capture device and format
Detection model
Input device
DPI and in-game sensitivity
Worth Adjusting Early
Aim FOV — Default is 35 pixels. Increase if targets at the edge of your screen aren't detected. Decrease if aim is snapping to distant targets you didn't intend.
Aim Key — Default is Back Button. Change to whatever mouse button you prefer.
Confidence (Settings > Detection) — Default is 50%. Lower it if targets aren't being detected. Raise it if you're getting false detections.
Adjust After First Success
Once aim is working in-game, fine-tune these based on feel:
P-Gain — Increase for faster corrections, decrease if aim overshoots
D-Gain — Increase if aim oscillates around the target
Activation Delay — Add reaction time delay if movement starts too instantly
X/Y Offset — Shift aim point toward head or body
Trigger settings — Enable and configure automatic fire
Advanced (Only If Needed)
Humanizer — Enable and select a preset if you want more natural-looking movement
Weapon Classes — Set up per-weapon configurations
RCS — Configure recoil compensation for specific weapons
Prediction — Enable latency compensation for moving targets
Smooth Modifiers — Define distance-based smoothing zones (Aim V2 mode)
GAN / Human aim — Train an ML mouse model for the most natural movement (requires data recording)
Configuration Styles
Safe / Legit
Use the Legit aim preset, Subtle humanization preset, and Safe & Legit trigger preset. Keep FOV small (20-35). Enable Activation Delay at 60-100ms. This configuration prioritizes natural appearance.
Key settings:
Aim Type: PID
P-Gain: low-moderate (0.30-0.50)
D-Gain: moderate (0.15-0.25)
Output Smooth: high (0.50-0.70)
FOV: 20-35
Trigger 1st Shot Delay: 100-200ms
Balanced
Use the Competitive aim preset with Medium humanization. Moderate FOV (30-50). Activation Delay at 30-60ms.
Key settings:
Aim Type: PID or Aim V2
P-Gain: moderate (0.40-0.60)
FOV: 30-50
Humanizer: Medium preset with Speed Variance and Path Curvature enabled
Aggressive
Use the Aggressive aim preset with Subtle or Off humanization. Larger FOV (40-75). Minimal delay.
Key settings:
Aim Type: PID
P-Gain: high (0.60-0.80)
D-Gain: low (0.10-0.15)
Output Smooth: low (0.20-0.40)
FOV: 40-75
Activation Delay: 0-20ms
Common Mistakes
1. Not enabling aim
The wizard configures everything but does not enable the aim system. You must check Aim Enabled on the Aim page before clicking Start.
2. Wrong capture device or format
If detection isn't finding targets, verify your capture device is outputting video. Check Settings > Capture and make sure the correct device and format are selected.
3. Confidence too high
Default confidence is 50%. If targets aren't being detected, lower it to 30-40%. You can monitor detection performance in the debug view.
4. FOV too small
If aim only works when your crosshair is almost on the target already, increase FOV. Start at 35 and increase by 10 until it feels responsive.
5. Using GAN or Human aim without a trained model
GAN and Human aim types are advanced modes that require a trained ML mouse model. If you haven't trained one, use PID, Aim V2, or WindMouse instead — they work immediately with no setup.
If you want to try GAN/Human: Settings > ML Mouse > Record Training Data > Train Model. A warning on the Aim page indicates when no model is loaded.
6. Adjusting humanizer controls with humanizer off
All humanizer sub-controls are grayed out when the master switch is off. The settings save but have no effect until you enable the humanizer.
7. Ignoring presets
Each page has a preset selector at the top. Presets apply a complete, tested set of values. Start with a preset, then fine-tune individual settings. This is much faster than configuring everything from scratch.
8. Too many humanization features at once
Start with the Subtle preset. If you want more natural movement, step up to Light or Medium. Enabling every humanization feature simultaneously can make aim feel sluggish or unpredictable.
Per-Game Configuration
Moonlight AI supports multiple game profiles. Each profile saves all settings independently.
Creating a Profile
Go to Settings > Game Profiles
Enter a name for your configuration
Adjust settings for that specific game
The profile saves automatically
Switching Profiles
Select a different profile from the Game Profiles dropdown. All settings update immediately.
Weapon Classes
Within a profile, you can create weapon-specific configurations (Rifles, Shotguns, Pistols, etc.) that use different aim speeds, FOV, and smoothing values.
Weapon classes can switch automatically using:
OCR Weapon Detection — Reads weapon name text on screen
Template Matching — Matches weapon icon images on screen
Both are configured in the Settings page under their respective tabs.
Troubleshooting Configuration Issues
"Start Moonlight" shows a warning icon
The button displays a warning triangle when pre-start validation detects a problem. Click it to see what's wrong — typically a missing model file or unconfigured capture device.
Settings don't seem to save
Changes save automatically with a short delay. If a setting reverts after restart, it may have been changed during the first few seconds of launch when the config system is still initializing. Wait a moment after launch before making changes.
Profile switch doesn't update all controls
All controls — including OCR, template matching, capture, and humanizer settings — update when you switch profiles. If something appears stale, switch away and back.
Aim works but feels wrong
Verify your DPI and in-game sensitivity are correct (Settings > Game Profiles)
Try a different aim preset
For PID: adjust P-Gain (higher = faster), D-Gain (higher = more braking), Output Smooth
For Aim V2: adjust Smooth X/Y values and Speed
Increase or decrease FOV based on whether aim feels too wide or too narrow
Settings Reference by Tab
Quick reference for which settings live where.
Enable/disable aim
Aim page
Change aim speed or behavior
Aim page > Aim Controls
Configure flick shots
Flick + Trigger page
Set up auto-fire
Flick + Trigger page > Trigger Controls
Make movement look natural
Humanizer page
Configure recoil compensation
Recoil Control page
Change capture device
Settings > Capture
Select detection model
Settings > Detection
Configure mouse device
Settings > Input Device
Adjust tracking smoothing
Settings > Smoothing
Manage game profiles
Settings > Game Profiles
Set up weapon detection
Settings > Game Profiles > OCR / Template Matching
Train ML mouse model
Settings > ML Mouse
View logs
Settings > Logs
Last updated