Automation for League of Legends' Teamfight Tactics game mode
© 2019–2020 T.D. Stoneheart. All rights reserved. Source code available under GPLv3 license.
Important: The script is no longer in active development and no longer supported by the author. Either use the software at your own risk or find an alternative.
The author does not assume any responsibility when you use this automation script, as it is not related to, endorsed by, or affiliated with Riot Games by any way.
While this automation script affects only the account it is run on, it might slightly affect other players' competitive gameplay experience negatively.
The script is created to assist in completing as many games as possible while you are AFK, by quitting and finding a new match as soon as you are eliminated. Keep in mind that the script cannot play for you, so do not expect ending up in high places with this automation.
A demonstration video can be found here.
This automation script is a companion of the (somewhat unethical) LOL Vs. Bots Assist project, from which this project takes the codebase. It focuses on simplicity in order not to clutter the source code; no configuration GUIs are created, and number of games are not tracked. Also, the script is designed to work with any game client size without having to adjust to a fixed size.
Before launching the script, create a Teamfight Tactics lobby first. The Find Match button should be visible on the game client.
Prior to automation, you will be able to choose to enable Fast Finish mode or not to. When Fast Finish is enabled, the script attempts to forfeit (or surrender, or finish fast) games as soon as possible. Surrendering is available when the game has elapsed for at least 10 minutes, typically from round 3-1 onward.
At any time during automation, press Shift+Esc to pause automation. Switching to another window during the game is required to use this hotkey. You will be prompted to either resume or quit automation.
The script attempts to quit the game as soon as possible when you are eliminated from the game, and then finds a new match when you are back to the client. If you wish to find a new match when the winner is found and all other players are eliminated, use LOL Vs. Bots Assist. Uncheck the moving only option and start automation from a Teamfight Tactics lobby; all other settings (even the number of games limit setting!) have no effect.
You can also start or resume automation during a Teamfight Tactics game in progress.
Command line switches are designed with flexibility in mind, by removing hyphens and slashes upon parsing. Both /noff and --no-ff can be used to disable Fast Finish mode without being prompted with a message box. The table below shows all configurable settings as bare switches (having "syntactic sugar" hyphens and slashes removed).
| Bare Switch | Description |
|---|---|
ff, fastfinish |
Enable Fast Finish: Surrender as soon as possible. |
noff, nofastfinish |
Disable Fast Finish: Quit when the player is eliminated. |
move, moving |
Enable Moving: Occasionally move around the map. |
nomove, nomoving |
Disable Moving: Stay stationary throughout the game; do not move the player. (Default option) |
emote, emotes |
Enable Emotes: Occasionally use emotes. This feature uses default key bindings for emotes: Ctrl+1, Ctrl+2, Ctrl+3, T. The automation script might not function properly if these key bindings are altered. |
noemote, noemotes |
Disable Emotes: Stay emotionless throughout the game; do not use any emote commands. (Default option) |
Note that Moving and Emotes settings are considered "hidden" because they can only be explicitly adjusted via the command line so as to avoid creating too many message boxes at launch time.
Switches are parsed from left to right; that is, if there are mutually exclusive options occuring in the command line, the rightmost option is applied. For example, assuming that the path of the executable script is D:\LOL-TeamfightTactics.exe, this command line disables Fast Finish, enables Moving, and enables Emotes.
"D:\LOL-TeamfightTactics.exe" /ff --move --no-emote --no-fast-finish emotes
- The
/FFchat message (for forfeiting) is not really reliable, often leaving an empty chat box without recognizing any keystrokes as message text. To deal with this issue, Shift+F is used instead of F to avoid unexpectedly buying experience points. - Networking issues might soft-lock the automation, leaving the game stuck in "Attempting to connect".