AutoHotkey v1 Script Not Working in v2

How to fix it

// try these in order, the most common fix is first

1. FIX 1Run it with v1 instead

   Copy steps
   1. 01Install AutoHotkey v1.1 alongside v2 (they coexist)
   2. 02Add `#Requires AutoHotkey v1.1` at the top of the old script
   3. 03Launch it again and let the launcher choose v1
   Did this fix it? Yes No

2. FIX 2Port the script to v2

   Copy steps
   1. 01Change `x = 5` to `x := 5`
   2. 02Change `Sleep, 1000` to `Sleep 1000`
   3. 03Replace `MsgBox, Hello %name%` with `MsgBox "Hello " name`
   4. 04Wrap hotkey bodies in `{ }` instead of ending with return
   5. 05Replace ErrorLevel checks with try/catch
   Did this fix it? Yes No

3. FIX 3Try the community converter

   Copy steps
   1. 01Run the community v1-to-v2 converter on a small script first
   2. 02Fix leftover errors by hand, since it has known gaps
   3. 03Add `#Requires AutoHotkey v2.0` to the converted file
   Did this fix it? Yes No

Symptoms

Double-clicking an old .ahk shows a load error, 'Function calls require a space or (', or the script does nothing.

Why it happens

• C-01Script written for v1 is being run by the v2 interpreter
• C-02v1 syntax such as `=` assignment, `%var%` and comma commands
• C-03Hotkeys ending with return instead of braces
• C-04Wrong version chosen by the launcher

// this guide also covers

• autohotkey v1 script not working v2
• autohotkey v1 to v2
• autohotkey script not running

Other AutoHotkey errors

• AutoHotkey Error: This Line Does Not Contain a Recognized Action
• AutoHotkey Hotkeys Not Working in Admin Windows
• AutoHotkey Flagged as Virus by Antivirus
• AutoHotkey Anti-Cheat Errors and Bans in Games
• AutoHotkey Send and Click Not Working in Games
• AutoHotkey Modifier Key Stuck (Ctrl, Alt, Shift, Win)
• AutoHotkey Hotkeys Not Working on Non-English Keyboard Layouts
• AutoHotkey Script Slow or Laggy Under High CPU