GTA V Online AHK-Macros

Provides hotkeys for many parts of the Interaction and Settings menus.

GTAO 1.69 NOTE: This is a nearly complete re-write of 2called-chaos' script for GTA Online v1.69 (Bottom Dollar Bounties DLC).

Requirements

• AutoHotkey
• pssuspend.exe and pskill.exe in your path (for force disconnect and process killing, see instructions below). This is only required for the Force Disconnect and Kill Game keys.

Installation

• Download the .ahk files
• Open config.ahk in a text editor (e.g. notepad++ with AutoIT syntax highlighting)
• Change the hotkeys (key list) and other options as you desire.

Optional Installation (pssuspend.exe / pskill.exe)

pssuspend.exe and pskill.exe are tools from the sysinternals collection. You can download the whole package (~3MB) directly from Microsoft. You can copy them all but we only need pssuspend and pskill, so go ahead and extract/copy pssuspend.exe pskill.exe to ANY of the following:

• into the same location where the .ahk file is
• C:\Windows
• C:\Windows\system32

NOTE: Start the pssuspend.exe AND pskill.exe once by double clicking on it and accept the license agreement or it will silently fail.

Usage

• Start GTA V before starting this script.
• On Windows 10/11 you have to start the GTA V Online Macros.ahk script as administrator (Right-click -> Run as administator).
• You should run the game in window(ed fullscreen) or some functions will switch windows and not work properly.
• You will have to toggle In Building mode (*) manually since the interaction menu will be changed and most functions need to be aware of that. When you go into a building, toggle this setting for the functions to work correctly. If you start in a building, toggle In Building mode before using any of the functions. As a quick reference, if the Interaction Menu has 11 options, In Building should be deactivated; if it has 12, activate it. This also needs to be toggled for some missions (i.e. Auto Shop Contracts).
• The interaction menu is often delayed the first time it's opened after loading screens or cutscenes. Make sure to briefly open the interaction menu (m) from time to time, especially after loading/cutscenes. Alternatively you can increase the IntMenuDelay setting for more accuracy but making the process slower in general.
• If you start the game as CEO/President, you need to use the ResignOrDisband key (F9) and then become CEO/President again for the CEO/President functions to work correctly the first time.
• Needless to say, don't give inputs while a macro is running.
• Sometimes you might find that the script doesn't appear to do anything. This might happen if you start the game after the AHK script. Reloading the script (Right-click on AHK systray icon -> Reload Script) fixes that usually.

Custom additions

You can (optionally) create a file custom.ahk in the same location as the main script to add custom macros without needing to change the main file making updates easier.

; directly bind onto a key with double-colons
^F3::
  ; do something
  return

; AHK hotstring (typing ll<tab> will trigger this example)
::ex::
  goto ExampleMacro
  return

; target macro for the hotstring above
ExampleMacro:
  SplashTextOn 250, 20, Foo, Bar
  Sleep 1000
  SplashTextOff
  return

; hotstring an existing macro from the main file
::lester::
  goto CallLester
  return

; handy for when you modifying or adding stuff
::rel::
  SplashTextOn 250, 20, Reloading, Reloading script...
  Sleep 1000
  Reload
  return

Updates

Since v1.2.0 the script includes a simple auto updater. By default it will check for a new version on GitHub every time you launch the script. If a new (or actually different) version is found it will prompt you to proceed or cancel. Use config.ahk if you plan on changing settings as the update will replace the main script file!

You can disable the automatic check and/or bind a manual check to a hotkey in the configuration (DoCheckForUpdates and CheckForUpdatesKey). Note that the update check hotkey still only works when GTA is active.

Will I get banned?

I'm not aware of any bans issued by Rockstar following the usage of AHK-scripts. I have personally used AHK-scripts within GTA:O since 2014 and did not get banned. This is also not the only AHK-script available, I'm sure many are using them. At the end, it's your call but I'm 99% certain that it won't get you banned.

Available macros

I might forget to update so just check available keybinds in config.ahk :)

• SnackMenu – Opens the snack menu

• AutoHealth – Consumes 2 snacks (from position 2) and closes menu

• ArmorMenu – Opens the armor menu

• AutoArmor – Consumes one super heavy armor and closes menu

• RetrieveCar – Retrieve your current active personal vehicle

• ReturnCar - Return the currently active personal vehicle

• CEOBuzzard – Spawn a free CEO Buzzard

• RequestSparrow – Call in your Sparrow (or whatever you last requested moon pool vehicle was)

• ReturnSparrow – Return your Sparrow to the Kosatka

• RequestKosatka - Call in your Kosatka Submarine

• RequestOppressor - Call in your Oppressor Mk II

• ForceDisconnect – Force disconnect the game by freezing the process for 10 seconds (requires pssuspend.exe)

• KillGame – Kill the game process immediately (requires pskill.exe)

• ToggleInBuilding – Toggle In a Building mode

• ToggleAFK – Toggle AFK mode

• TurnOnCEO - Makes you CEO of an Organization and toggles VIP mode

• TurnOnPres - Makes you President of a MC Club and toggles VIP mode

• ResignOrDisband - Resigns your CEO position or Disbands your MC Club and toggles VIP mode

• TogglePassive – Toggle passive mode

• ToggleRadar – Toggle extended radar

• ToggleClicker – Toggle auto clicker

• ToggleAutoHeli – Keeps throttle and pitch forward pressed, poor mans autopilot

• ToggleAutoPlane - Keeps throttle at max for plane autopilot

• ChatSnippets – Select a sentence from a configurable list which will get typed out in the game (chat should already be open)

• CreateManualSave - Use the outfit selection to create a manual save (doesn't change outfits)

• CycleOutfit – Cycle through your saved outfits

• EquipScarf – Equip scarf (heist outfit speed, see miscellaneous)

• NewPublicSession - Join a New Public Session

• NewInviteSession - Join a New Invite Only Session

• NewCrewSession - Join a New Crew Only Session

• NewFriendSession - Join a New Friend Only Session

• RandomHeist – Join a random heist (on-call) solo aka don't invite friends in session

• DialDialog – Select a number from a list and call it automatically (add items, change order or remove entries in config)

The following calls can be directly bound to a hotkey (adding more is trivial):

• CallMechanic
• CallPegasus
• CallMerryweather
• CallInsurance
• CallLester
• RemoveWantedLevel - Calls Lester and has him remove wanted level
• CallAssistant

You can reach more (useful or useless contacts) by binding DialDialog

• CheckForUpdates – Manually check for updates

Miscellaneous

modifier keys for hotkeys

If it's not clear enough from the key list. You can use these symbols in combination with keys. For example F1 to equip armor and +F1 (shift+F1) to just open the menu.

"cheat codes"

With AHK's hotstrings you could achieve something like the good old cheat codes to trigger macros. The issue is just to find words that won't trigger things like chat or the interaction menu.

::lester::
  GoTo CallLester
  return

This would allow you (in theory) to type "lester" followed by a TAB to trigger the macro. But again, t would open the chat usually and break the macro.

Scarf / Heist outfit

Yo, what's up with the scarf macro? Well if you have played normal heists with the heavy outfit once you know that you are slower but take less damage with them. Given that you play with a player saved heist outfit and own a scarf you can get rid of the armor and its speed effect while still keeping the protective aspects of it.

Just beware: Some cutscenes may remove the protective effect, quick-restart most certainly will remove the effect and some checkpoints will give you the armor back (visibly) and some wont. If you get the armor back you can repeat the scarf equip, otherwise no heist outfit for the rest of the mission.

I use it for example for the Pacific finale and equip the scarf after leaving the bank.

Contributing

Contributions are very welcome! Either report errors, bugs and propose features or directly submit code:

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Added some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

Please use spaces for indentation and try to mimic the style of existing code :)

Legal

This repository is licensed under the MIT license.