YOLOv8 Aimbot is an AI-powered aim bot for first-person shooter games. It leverages the YOLOv8 model, PyTorch, and various other tools to automatically target and aim at enemies within the game. The AI model in repository has been trained on more than 17,000 images from popular first-person shooter games like Warface, Destiny 2, Battlefield 2042, CS:GO and CS2.
Warning
Use it at your own risk, we do not guarantee that you may be blocked!
Before you get started, make sure you have the following prerequisites installed and pay attention to the versions in Tested Environment
block, this may cause errors in launching the aimbot:
- Information in English:
- Информация на Русском языке:
- I advise you to check the environment by running
checks.py
, it will let you know what and where to fix or re-install. - To launch the aimbot after all installations, type
python run.py
orpy run.py
in cmd.
Operating Systems: | Windows 10-11 |
---|---|
NVIDIA CUDA Version: | 12.1 |
NVIDIA cuDNN Version: | 8.9.4.25 |
TensorRT Version: | 8.6.1 |
Python Version: | 3.11.6 |
PyTorch Version: | 2.1.1+cu121 |
Ultralytics Version: | YOLOv8.0.230 |
OpenCV Version: | 4.8.1 |
NumPy Version: | 1.26.0 |
Tested GPUs:
RTX 4080 | RTX 4070 | RTX 4060 | RTX 3090 | RTX 3080-ti | RTX 3070 | RTX 3060 | RTX 3050 | RTX 2080 | RTX 2060-super | GTX 1660-super | GTX 1660 | GTX 1650 | GTX 1080 | GTX 1060 | GTX 1050-ti | GTX 1050 | GTX 750-ti | GTX 750 |
The behavior of the aim bot can be configured via the config.ini
file. Here are the available options:
- detection_window_width
int
: Horizontal resolution of the object search window. - detection_window_height
int
: Vertical resolution of the object search window.
- Bettercam_capture
bool
: Use Bettercam to capture images from the screen. - bettercam_capture_fps
int
: Specific fps value for screen capture. - bettercam_monitor_id
int
: Id of the monitor from which the images will be captured. - bettercam_gpu_id
int
: Id of the GPU to be used for image capture
- Obs_capture
bool
: Use Obs to capture images from the screen. - Obs_camera_id
int
: Virtual Camera ID. - Obs_capture_fps
int
: Specific fps value for screen capture.
- body_y_offset
float
: Allows correction of y coordinates inside the body detected box if head is not detected. - hideout_targets
bool
: Allows shooting at targets on the range (for example in warface on the polygon or in aimlabs). - disable_headshot
bool
: Disable head targerting.
- Right mouse button
str
: Aiming at the target. - F2
str
: Exit. - F3
str
: Pause AIM. - F4
str
: Reload config.
- mouse_dpi
float
: Mouse DPI. - mouse_sensitivity
float
: Ingame sensitivity. - mouse_fov
float
: Ingame fov. - mouse_lock_target
bool
: Lock targeting. - mouse_auto_shoot
bool
: Automatic shooting. (For some games need arduino). - mouse_auto_aim
bool
: Automatic targeting. - mouse_native
bool
: Use windows native mouse input. - mouse_move_by_arduino
bool
: Sends a command to the arduino to move the mouse. - mouse_shoot_by_arduino
bool
: Sends a command to the arduino to fire with the mouse
- AI_model_path
str
: AI model path. - AI_image_size
int
: Model image size. - AI_conf
float
: How many percent is AI sure that this is the right goal. - AI_iou
float
: Intersection over union (IoU) threshold for NMS. - AI_device
int
orstr
: Device to run on, i.e. cuda AI_device=0/1/2/3 or AI_device='cpu'. - AI_max_det
int
: Maximum number of detections per frame.
- show_overlay_detector
bool
: Show the detector overlay. - show_overlay_boxes
bool
: Show goals inside the overlay. - show_overlay_line
bool
: Show line from crosshair to target.
- show_window
bool
: Shows the OpenCV2 window for visual feedback. - show_speed
bool
: Displays speed information inside the OpenCV2 window. - show_fps
bool
: Displays FPS in the corner. - show_boxes
bool
: Displays detectable objects. - show_labels
bool
: Displays the name of the detected object. - show_conf
bool
: Displays object confidence threshold for detection. - show_target_line
bool
: Shows the mouse finishing line. - debug_window_always_on_top
bool
: The debug window will always be on top of other windows. - debug_window_scale_percent
int
: Adjusts the size of the OpenCV2 window. - debug_window_name
str
: Specifies the title of the OpenCV2 window.
- *.pt: Default AI model.
- *.onnx: The model is optimized to run on processors.
- *.engine: Final exported model, which is faster than the previous two.
- My .engine model was exported using specification version 8.6 (on an rtx 3080-TI graphics card). So if you were to run my .engine model on a gtx 1080 graphics card, the model would not start. You need to export it yourself. See what specification your graphics card supports. So if your graphics card supports the 8.6 specification, then the model will start. The error may also occur due to the fact that I exported the model in a different version of TensorRT, it's better to just export the model yourself.
Run in console:
yolo export model="models/sunxds_0.2.9.6.pt" format=engine half=true device=0 imgsz=320
model="model_path/model_name.pt"
: Path to model.format=engine
: TensorRT model format.half=true
: Use Half-precision floating-point format.device=0
: GPU id.workspace=8
: GPU max video memory.imgsz=320
: Model image size.verbose=False
: Debug stuff. Convenient function, can show errors when exporting.
- Limit the maximum value of frames per second in the game in which you will use it. Do not overload the graphics card.
- Do not set high graphics settings in games.
- Limit the browser (try not to watch YouTube while playing and working AI at the same time, for example (of course if you don't have a super duper graphics card)) and so on, which loads the video card.
- Try to use TensorRT for acceleration.
.pt
model is good, but does not have as much speed as.engine
. - If the program is running, everything is detected, but the mouse itself is not aimed at the target, then try running the program as an administrator.
- Turn off the cv2 debug window, this saves system resources.
- Do not increase the object search window resolution, this may affect your search speed.
- If you have started the application and nothing happens, it may be working, close it with the F2 key and change the show_window setting to Yes in the file config.ini to make sure that the application is working.
I will post new models here.
This project is licensed under the MIT License. See LICENSE for details