Skip to content

Configuration Guide

This guide provides a comprehensive explanation of all configuration options available in the Visual Aim Assist Tool.

Table of Contents

Configuration File Location

The configuration file (config.json) is located at:

  • Windows: %APPDATA%/aimbot/config.json
  • Linux: ~/.config/aimbot/config.json

You can also place a config.json file in the same directory as the executable for portable mode.

Configuration Options Reference

Core Settings

window (string)

  • Description: The title (or partial match) of the game window to capture
  • Default: "Roblox"
  • Example: "Sober", "Phantom Forces", "Counter-Strike"
  • Affects: Which window the tool captures frames from
{
    "window": "Sober"
}

colors (array of strings)

  • Description: Hex color codes to detect on screen
  • Default: ["#ff00ff"]
  • Format: Hex color strings with # prefix
  • Affects: What colors the tool will track and aim toward
  • Tip: You can specify multiple colors to detect
{
    "colors": ["#ff00ff", "#ff00fe", "#ff00fd"]
}

color_space (string)

  • Description: Color space used for detection
  • Options: "bgr", "rgb", "hsv"
  • Default: "bgr"
  • Affects: How colors are interpreted and matched
  • Note: BGR is typically used for OpenCV screen captures
{
    "color_space": "bgr"
}

Detection Settings

fov (integer)

  • Description: Field of View radius in pixels from the center of the screen
  • Default: 250
  • Range: 1-1000+
  • Affects: The circular area where the tool searches for target colors
  • Tip: Smaller values = more precise, Larger values = wider search area
{
    "fov": 250
}

tolerance (float)

  • Description: Color tolerance for BGR/RGB color spaces (0-255)
  • Default: 75.0
  • Range: 0-255
  • Affects: How closely colors must match to be detected
  • Tip: Higher values = more lenient matching, Lower values = stricter matching
{
    "tolerance": 75.0
}

tolerance_h (float)

  • Description: Hue tolerance for HSV color space (0-90)
  • Default: 10.0
  • Range: 0-90
  • Affects: Hue matching sensitivity in HSV mode
{
    "tolerance_h": 10.0
}

tolerance_s (float)

  • Description: Saturation tolerance for HSV color space (0-255)
  • Default: 60.0
  • Range: 0-255
  • Affects: Saturation matching sensitivity in HSV mode
{
    "tolerance_s": 60.0
}

tolerance_v (float)

  • Description: Value tolerance for HSV color space (0-255)
  • Default: 60.0
  • Range: 0-255
  • Affects: Brightness matching sensitivity in HSV mode
{
    "tolerance_v": 60.0
}

min_area (integer)

  • Description: Minimum contour area to consider as a valid target
  • Default: 15
  • Range: 1-9999
  • Affects: Filters out small noise/detections
  • Tip: Increase if you're getting false positives from small objects
{
    "min_area": 15
}

max_area (integer)

  • Description: Maximum contour area to consider as a valid target
  • Default: 9999
  • Range: 1-99999
  • Affects: Filters out very large detections
  • Tip: Decrease if large objects are being incorrectly tracked
{
    "max_area": 9999
}

Aiming Settings

lead (float)

  • Description: Velocity prediction factor for leading moving targets
  • Default: 0.35
  • Range: 0.0-2.0
  • Affects: How much the tool predicts target movement
  • Tip: Higher values for faster-moving targets, 0 disables prediction
{
    "lead": 0.35
}

smoothness (float)

  • Description: Smoothing factor for mouse movement (0.0-1.0)
  • Default: 0.65
  • Range: 0.0-1.0
  • Affects: How smooth/jerky the mouse movement appears
  • Tip: Lower values = smoother but slower, Higher values = more responsive but jittery
{
    "smoothness": 0.65
}

min_strength (float)

  • Description: Minimum movement strength multiplier
  • Default: 0.01
  • Range: 0.0-1.0
  • Affects: Minimum amount of mouse movement applied
{
    "min_strength": 0.01
}

max_strength (float)

  • Description: Maximum movement strength multiplier
  • Default: 0.044
  • Range: 0.0-1.0
  • Affects: Maximum amount of mouse movement applied
  • Tip: Lower values for more subtle movements, higher for aggressive aiming
{
    "max_strength": 0.044
}

offset_x (float)

  • Description: Horizontal offset from the detected target
  • Default: 0.0
  • Range: -100.0 to 100.0
  • Affects: Where the crosshair aims relative to the target horizontally
  • Tip: Use for specific hit zones (e.g., head vs body)
{
    "offset_x": 0.0
}

offset_y (float)

  • Description: Vertical offset from the detected target
  • Default: 0.15
  • Range: -100.0 to 100.0
  • Affects: Where the crosshair aims relative to the target vertically
  • Tip: Positive values aim lower, negative values aim higher
{
    "offset_y": 0.15
}

Trigger Settings

trigger (string)

  • Description: Mouse button that activates the aim assist
  • Options: "left", "right", "both"
  • Default: "right"
  • Affects: Which mouse button must be held for the tool to work
{
    "trigger": "right"
}

target_fps (integer)

  • Description: Target capture frames per second (0 = unlimited)
  • Default: 120
  • Range: 0-240
  • Affects: Performance and responsiveness
  • Tip: Higher values = more responsive but more CPU usage, 0 = max FPS
{
    "target_fps": 120
}

Triggerbot Settings

triggerbot (boolean)

  • Description: Enable/disable automatic firing when target is acquired
  • Default: true
  • Affects: Whether the tool automatically clicks when a target is in range
{
    "triggerbot": true
}

trigger_dist (float)

  • Description: Distance threshold (in pixels) for triggerbot activation
  • Default: 15.5
  • Range: 1.0-100.0
  • Affects: How close the crosshair must be to the target before auto-firing
  • Tip: Lower values = more precise, Higher values = fires sooner
{
    "trigger_dist": 15.5
}

trigger_delay (integer)

  • Description: Delay between triggerbot clicks in milliseconds
  • Default: 15
  • Range: 0-1000
  • Affects: Fire rate when triggerbot is active
  • Tip: Adjust based on weapon fire rate in your game
{
    "trigger_delay": 15
}

Steady Aim Settings

steady_aim (boolean)

  • Description: Enable/disable steady aim feature
  • Default: true (when available)
  • Affects: Whether holding a key reduces aim movement when target is in range
{
    "steady_aim": true
}

steady_dist (float)

  • Description: Distance threshold for steady aim activation
  • Default: 24.0
  • Range: 1.0-100.0
  • Affects: When steady aim engages based on crosshair proximity to target
{
    "steady_dist": 24.0
}

steady_key (string)

  • Description: Key to hold for steady aim (not in current config but may be added)
  • Default: "left_shift"
  • Options: Various key names
  • Affects: Which key activates steady aim mode
{
    "steady_key": "left_shift"
}

Debug & Miscellaneous Settings

debug (boolean)

  • Description: Enable/disable debug overlay visualization
  • Default: true
  • Affects: Shows real-time detection boxes, FOV circle, and tracking info
  • Tip: Disable for better performance or less screen clutter
{
    "debug": true
}

enabled (boolean)

  • Description: Master enable/disable switch for the tool
  • Default: true
  • Affects: Whether the tool is active at all
{
    "enabled": true
}

lost_frames_thresh (integer)

  • Description: Number of frames before target history is reset
  • Default: 4 (may vary)
  • Range: 1-60
  • Affects: How long the tool remembers a lost target
  • Tip: Higher values help with brief occlusions
{
    "lost_frames_thresh": 4
}

Phantom Forces Pre-configured Settings

The included config.json is pre-tuned for Phantom Forces on Roblox via the Ballistic Tracker. Here's what makes it optimized:

{
    "colors": ["#ff00ff"],
    "color_space": "bgr",
    "tolerance": 75.0,
    "fov": 250,
    "lead": 0.35,
    "smoothness": 0.65,
    "min_strength": 0.01,
    "max_strength": 0.044,
    "offset_y": 0.15,
    "trigger": "right",
    "target_fps": 120,
    "triggerbot": true,
    "trigger_dist": 15.5,
    "trigger_delay": 15,
    "min_area": 15,
    "max_area": 9999,
    "window": "Sober",
    "debug": true,
    "enabled": true
}

Why These Settings Work for Phantom Forces:

  1. Color Detection: Magenta (#ff00ff) matches the ballistic tracker highlight
  2. Moderate FOV: 250px provides good coverage without excessive searching
  3. Balanced Smoothness: 0.65 offers responsive yet controlled movement
  4. Low Strength Values: Prevents over-correction and jittery aim
  5. Fast Triggerbot: 15ms delay matches high fire-rate weapons
  6. Lead Prediction: 0.35 accounts for target movement in fast-paced combat

Tuning Tips

For Better Accuracy:

  • Decrease fov for more focused targeting
  • Lower tolerance for stricter color matching
  • Reduce max_strength for finer control
  • Increase min_area to ignore small distractions

For Faster Response:

  • Increase target_fps for more frequent updates
  • Raise smoothness for more direct movement
  • Increase max_strength for quicker snaps
  • Lower trigger_dist for earlier triggerbot activation

For Specific Games:

  • Sniper rifles: Lower lead, higher smoothness, smaller fov
  • SMGs/Auto rifles: Higher lead, moderate smoothness, larger fov
  • Shotguns: Minimal lead, high max_strength, very small offset_y

Next Steps

After configuring the tool, proceed to the Usage Guide to learn about hotkeys and features.