Skip to content

Usage Guide

This guide explains how to use the Visual Aim Assist Tool, including hotkeys, features, and best practices.

Table of Contents

Getting Started

  1. Launch the Application
  2. Run the executable (Windows pre-built or compiled binary)

  3. The tool will start in the background

  4. Load Configuration

  5. The tool automatically loads config.json from:

    • Same directory as executable (portable mode), OR
    • %APPDATA%/aimbot/config.json (Windows)
    • ~/.config/aimbot/config.json (Linux)

  6. Start Your Game

  7. Launch your game (e.g., Phantom Forces via Roblox)
  8. Ensure the game window title matches the window setting in config

Hotkeys Reference

The following global hotkeys are available while the application is running:

Hotkey Action Description
F1 Toggle Aim Assist Enable/disable the main aim assist feature
F2 Toggle Triggerbot Enable/disable automatic firing when target is acquired
F3 Toggle Steady Aim Enable/disable steady aim mode (if configured)
F4 Exit Application Close the tool completely
Ctrl+C Exit Application Alternative way to close (in console)

Hotkey Status Indicators

When the debug overlay is enabled (debug: true), you'll see visual indicators showing which features are currently active:

  • 🟢 Aim Assist: ON/OFF status displayed
  • 🔫 Triggerbot: ON/OFF status displayed
  • 🎯 Steady Aim: ON/OFF status displayed

Features Overview

1. Aim Assist (Main Feature)

What it does: Automatically moves your mouse toward detected targets based on color recognition.

How to use: 1. Hold the configured trigger button (default: right mouse button) 2. The tool will detect colors within your FOV 3. Mouse will smoothly move toward the detected target 4. Release the trigger button to disable temporarily

Toggle: Press F1 to enable/disable globally

2. Triggerbot

What it does: Automatically fires (clicks) when a target is within the configured distance threshold.

How to use: 1. Enable triggerbot with F2 2. When your crosshair is close enough to a detected target, it auto-clicks 3. Fire rate is controlled by trigger_delay setting

Toggle: Press F2 to enable/disable

Note: Works independently of the main aim assist - you can use triggerbot alone or with aim assist.

3. Steady Aim

What it does: Reduces mouse movement sensitivity when a target is within range, providing finer control for precise shots.

How to use: 1. Enable steady aim with F3 2. When a target is within steady_dist, hold the configured key (if implemented) 3. Mouse movement becomes more subtle for precision aiming

Toggle: Press F3 to enable/disable

4. Debug Overlay

What it shows: Real-time visualization of what the tool is detecting and tracking.

Visual elements: - 🟦 FOV Circle: Shows your field of view boundary - 🟩 Detection Boxes: Rectangles around detected color contours - 🎯 Target Marker: Indicates the primary target being tracked - 📊 Status Text: Shows FPS, target count, and feature status

Toggle: Set debug: true/false in config file (requires restart)

Step-by-Step Usage

Basic Setup for Phantom Forces

  1. Prepare Configuration 

    # Copy the pre-configured config.json to the appropriate location
# Windows: %APPDATA%/aimbot/config.json
# Or place it next to the executable

  2. Launch the Tool

  3. Double-click the executable

  4. A console window may appear showing initialization status

  5. Start Phantom Forces

  6. Launch Roblox and enter Phantom Forces

  7. Ensure the window is active and visible

  8. Verify Detection

  9. Enable debug overlay (should be on by default)
  10. Look for the FOV circle and detection boxes

  11. You should see magenta highlights being detected

  12. Test Aim Assist

  13. Press and hold right mouse button (or configured trigger)
  14. Move your crosshair near an enemy with the ballistic tracker

  15. The mouse should smoothly move toward the target

  16. Adjust Settings (If Needed)

  17. If detection is poor, adjust tolerance or colors
  18. If aim is too jumpy, lower max_strength or increase smoothness

  19. If missing shots, adjust offset_y for better hit placement

  20. Enable Triggerbot (Optional)

  21. Press F2 to enable
  22. Test that it fires automatically when on target
  23. Adjust trigger_delay to match your weapon's fire rate

Advanced Usage

Using with Different Weapons

Different weapons may require different settings:

Assault Rifles / SMGs: 

{
    "lead": 0.35,
    "smoothness": 0.65,
    "trigger_delay": 15,
    "max_strength": 0.044
}

Sniper Rifles: 

{
    "lead": 0.1,
    "smoothness": 0.8,
    "trigger_delay": 500,
    "max_strength": 0.02,
    "offset_y": 0.0
}

Shotguns: 

{
    "lead": 0.0,
    "smoothness": 0.5,
    "max_strength": 0.08,
    "fov": 150
}

Multi-Color Detection

You can detect multiple colors simultaneously:

{
    "colors": [
        "#ff00ff",
        "#ff00fe",
        "#ff00fd",
        "#00ffff"
    ],
    "tolerance": 75.0
}

This is useful for: - Different enemy teams - Various highlight effects - Backup colors if primary isn't detected

Best Practices

⚡ Performance Optimization

  1. Set Appropriate FPS
  2. target_fps: 120 is good balance
  3. Lower to 60 if experiencing lag

  4. Set to 0 for maximum (uses more CPU)

  5. Optimize FOV

  6. Smaller FOV = better performance
  7. Only make it as large as needed

  8. Typical range: 150-300 pixels

  9. Disable Debug When Not Needed

  10. Debug overlay uses extra resources
  11. Set debug: false once you're configured

🎯 Accuracy Tips

  1. Calibrate Colors
  2. Use screenshot tools to find exact color values
  3. Test tolerance values incrementally

  4. Start strict (low tolerance), then loosen if needed

  5. Fine-Tune Aim

  6. Adjust offset_y for head vs body shots
  7. Use min_strength to prevent micro-jitters

  8. Balance smoothness for your playstyle

  9. Positioning

  10. Keep enemies within your FOV circle
  11. Don't rely solely on the tool - use good positioning
  12. Practice tracking manually as backup

⚠️ Important Reminders

  1. Terms of Service
  2. Using aim assist may violate game ToS
  3. Use at your own risk

  4. Consider using only in single-player or permitted environments

  5. Antivirus Exceptions

  6. Add the tool to your antivirus whitelist

  7. See Security Information for details

  8. Updates

  9. Game updates may change colors/UI
  10. Re-calibrate if detection stops working
  11. Check for tool updates periodically

Troubleshooting Quick Reference

Issue Possible Solution
Tool doesn't detect colors Check window setting, verify colors, increase tolerance
Aim is too jumpy Lower max_strength, increase smoothness
Aim is too slow Increase max_strength, decrease smoothness
Triggerbot not firing Check trigger_dist, ensure triggerbot is enabled (F2)
Tool feels laggy Lower target_fps, reduce fov, disable debug
Wrong targets selected Adjust min_area/max_area, fine-tune colors

For more detailed troubleshooting, see the Troubleshooting Guide.

Next Steps