Skip to content
/ b00m-h3adsh0t Public

Neural Network Aimbot for FPS games with custom training mode written in C++ providing a fast and efficient framework with scripting support ︻デ═一

lucylow.github.io/b00m-h3adsh0t/
6 stars 22 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

marcelopalacioabreu/b00m-h3adsh0t

BranchesTags

Repository files navigation

b00m-h3adsh0t! 🔷

Neural Network Configurable Aimbot for First-Person-Shooter Games in C/C++ Note: Aimbots are cheats and illegal in gaming leagues. This repo is solely for educational purposes only.

┬┴┬┴┬┴┤ (҂ ` ﾛ ´)︻デ═一______________________________＼(º □ º )/ ├┬┴┬┴┬┴┬┴┬┴┬┴┬┴┬┴┬┴┬┴┬┴

Status GitHub Issues GitHub Pull Requests License

Table_of_Contents 🔷

Motivation 🔷

  • B00m-h3adsh0t is a game bot software for first-person shooting (FPS) games where players need to constantly move, think, strategize, and shoot enemies all at once. Aimbot uses game data to automatically shoot at the heads of energy targets.

  • Personal motivation to learn C++ compiler programming language, object oriented programing, and how a FPS game executes on an operating system. B00m-H3adsh0t is 100% written in C++ with Visual Studio compiler providing a very fast, and efficient framework with scripting support such that the framework uses a consistent object-oriented design

    Image. “Turn off Lucy's b00m-h3adsh0t aimbot you noob K/D ratio hacker!"

Aimbot_Neural_Network 🔷

  • Trained by neural network (NN) with customizable predictions and dynamic speed settings

  • Select which FPS game you will use

  • Engine-Aim with colored models:

    • Hook into the FPS game engine to use actual game data to auto-aim without altering gaming files

    • Code won't work by itself because we need a handle to the game

    • Modifies memory of RAM half-life runs on

    • Gathers information from current game and pixel location

      Image. Custom training mode on the aimbot with a range of functionalities

  • Custom training mode

    • Leverage neural network to detect objects for object recognition using computer vision algorithms
    • Train with range of distances, lights, and angles for best possible recognition

Neural_Network_Model_Training_Recognization 🔷

Deep Reinforcement Learning

  • Allows bot to learn how to aim by interacting with its unknown 3D environment
  • Bot receives a reward if it correctly kills an enemy, hence the name b00m-h3adsh0. If the bot dies, it gets a penalty.
  • For each step, bot observes the current states Ot of the environment and decides of an action
  • Observes reward signal where the goal of the agent is to find a policy that maximizes the expected sum of discounted rewards
  • Game states are partially observable

Q-Learning Adaptation

  • Used a Q-Learning adaptation for Deep Learning to train the autonomous agent
  • Inputs are screenshots of the fps game (pixels)
  • Deep reinforcement learning allows bot to learn game features simultaneously along with minimizing a Q-learning objective

Dynamic Bayesian Network

  • Common for aimbot detections in FPS games
  • Used for probabilistic modeling and inference in discrete-time
  • Implementation options:
    • libDAI - A free and open source C++ library for Discrete Approximate Inference in graphical models (C++)
    • Mocapy++ (C++) - A toolkit for inference and learning in dynamic Bayesian networks

Technical_How_Aimbot_Works 🔷

  • Aimbot can be easily toggled on and off using the mouse or keyboard

  • Recognizes game objects in a certain range, then aims at the objects using game physics

  • Memory Searcher with Cheat Engine

    • Understand the memory storage structures within a game
    • Searching memory to find the values of the player classes such as player coordinates, health, mouse x,y coordinates, etc.
    • Use Cheat engine to find addresses (programs that scans memory depending on the search details you give it and returns the memory addresses)
    • Base address of "client.dll" (int or DWORD)
    • Read and write to the game memory
      • Call the functions ReadProcessMemory (RPM) and WriteProcessMemory (WPM)
      • Use multi-level pointers to access information to playerObjectAddress

  • CalcAngle

    • Needed to calculate angle functions for aimbot since everything is based on game coordinates
    • Takes two 3D positions in source and distance, and outputs the angle to distance in angles
    • Pass in the local player's eye position into src, the target's head in dst, and then set the view angles from angles

  • Call Game Functions

    • For internal hacks where we need to inject DLL
    • C++ programs call funtion by address via function pointers
    • Traceline and RayTrace commonly used in aimbots:
      • Draws a line between your player and another player
      • Checks if there are objects in the way
      • If there are no collisions between you and your target your aimbot should aim and shoot at that target

  • Game Player Detection

    • FPS game memory contains the (X,Y,Z) coordinates of each player for rendering
    • Aimbot scans memory locations for this information
    • Gain access to two key positions - the player and enemies coordinates
    • Subtracting the two positions as vectors == the vector between the two
    • Calculate the angle from the player's current vector to the desired angle vector

  • Aim Automatically

    • Inject information directly to the game
      • DLL injection
      • Overwriting current FPS game aim functions
      • Patching in-place the Direct3D or OpenGL DLL
    • Examining the functions calls to draw geometry
    • Insert own geometry functions (for things like wall-hacks or glitches)
    • Fine-tune with constants adjusting for any dynamic data structure moving players around on you

Technical_How_Aimbot_with_Neural_Network_Works 🔷

  • Neural Network

    • Program takes multiple screenshots to recognize objects
    • Different distances, lights, angles for best possible recognition
    • Output - program writes in cfg file
      • Batch = 1
      • Subdivision = 1 for testing
    • Graph of Training/Validation Set
      • Graph x vs y
      • Error Rate vs Number of Iterations in Training Set

  • Training Depenencies - Trained Files for Games

    • Use b00m-h3adsh0t.cfg file to change the resolution range for object recognition
    • Train Files Folder
      • Darknet folder/subfolders
      • Data or back up
      • GAME.names
      • GAME.cfg
      • GAME_last.weights
      • GAME.weights

Client-Server_Back-End_Implementation 🔷

  • Computer has to display the gameplay to the user by rendering the whole map and every player in it

  • Client–Server Model Method

    • Model instantaneously calculating/sending game results
    • Client sessions run synchronously with aimbot server with user input data
    • Run aimbot purely on game server
    • Run server mirrors client gameplay and continuously validates each game state

  • Modifying Game Rules World Method

    • Aimbot targets servers with no rule enforcement or data integrity
    • Synchronize all client data with information about all of the other clients
      • Reveals where all the players in the game are via (X,Y,Z) coordinates
      • Reveals user game states with information on player names, position, clip ammo, ammo count, health, class, weapons, frame rate and more.
    • Data from client will allow player to break game rules, manipulate server, or manipulate other clients

Security_and_Efficiency_Game_Server 🔷

  • Server responsible for information security and enforcing game rules

  • Sending Game World State needed for Immediate Display

    • Results in client lag under bandwidth constraints

  • Sending the Player the Entire World State

    • Results in faster display for player under the same bandwidth constraints
    • Exposes data to interception or manipulation
    • Trade-off between security and efficiency

Player_Behavior_Statistics 🔷

Refer to playerdata.h file

  • Aimbot Evaluation Metrics

    • Compare human player with b00m-h3eadsh0t agent
    • K/D Ratio to compare ratio of kills to deaths
    • Single player vs multi-player games

  • Pattern Detection Systems

    • Scan player's hard drives for known cheat code or programs
    • Scan player's system memory for known cheat code or programs
    • Labor-intensive to constantly track down cheats and update detection patterns

  • Anti–Cheat Method

    • Guaranteed to work on all end–user system configurations
    • Reduce the amount of false positives

  • Player Behavior Anomalie Detection

    • Detected by statistically analyzing game events

    • Data sent by client to server by statistical detection systems

    • Add human element of supervision system (community/admin team looks over player statistics)

      Image. Unusual player behavior leads to clientside creating then uploading a gamer report

User_Privacy 🔷

  • End–users concerned with privacy issues and "Never trust the client" is common saying with game developers
  • VAC (Valve Anti-Cheat) accessing browsing history
  • User privacy compromised with packet interception/manipulation
  • Man-in-the-Middle Attack
    • Reverse engineer the network packet formatting
    • Security of game circumvented by intercepting or manipulating data in real-time while transit from the client to the server or vice versa
    • Performed on client machine itself or via external communication proxy
    • Can provide player positions and other useful related information
    • Forged packets sent to server to move the player, shoot, or other game actions

Player_Attacks 🔷

  • Select button to attack and enable/disable training mode
  • Custom zooming control with scroll wheel
  • Custom crosshairs
  • Laser sight
  • Trigger bot
  • Move speed
  • Ammo count
  • Player radar
  • Name-tag display to detect players
  • Auto shoot/rapid fire
    • Most fps games limit the rate weapons are fired regardless of how fast a player presses buttons
    • Binding the firing button to the scroll wheel of a mouse
    • Macro setting that will simulate rapid key presses automatically
    • Set aiming speed and shooting delay
  • Auto clicker for semi automatic weapons
  • Dynamic recoil control
    • Remove gun revoil game element
    • Control bullet spread
    • Correcting for bullet drop

Glitches and Modifications 🔷

  • Wall hacks

    • Glitches with game surfaces
    • Graphics driver modifications that ignore depth checking
    • Draw all objects on the screen

  • Reduced flash

  • Correcting for ping/lag

  • Resolution range

  • Pixel memory hack

  • Transparent buildings, ceilings, obstacles, and trees

    • Remove visual elements of the game
    • Ex Replace opengl32.dll with one that would render polygons transparent

  • Display enemy lines

  • Extrasensory perception (ESP)

    • Display all the enemy positions on the map
    • Glowing or lighted players, weapons, and loot.
    • See all players at all times and plan ahead before making a kill
    • Show all information ex: player names, position, clip ammo, ammo count, health, class, weapons, frame rate and more

Conclusion 🔷

B00m-h3adsh0t! is a single architecture neural network configurable aimbot for first-person shooting (FPS) games. We introduced a method to augment a deep reinforcement q-learning model with high-level game information, and feature implementation. We showed that b00m-h3adsh0t! model is able to outperform built-in bots as well as human players and demonstrated the generalizability of our model to do game glitches and modifications.

References 🔷

About

Neural Network Aimbot for FPS games with custom training mode written in C++ providing a fast and efficient framework with scripting support ︻デ═一

lucylow.github.io/b00m-h3adsh0t/

Resources

Readme
Activity

Stars

6 stars

Watchers

1 watching

Forks

22 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages