Guide
From the first launch to applying changes and adding your own files, plus backup and undo.
First launch
- Run the installer, then open Aimloom from the Start menu (or its desktop shortcut). For the portable version, get the ZIP from GitHub Releases, unpack it anywhere (not inside the game folder) and double-click Aimloom.exe.
- If Windows shows "Windows protected your PC", choose More info → Run anyway: Aimloom has no code-signing certificate yet.
- Aimloom's window needs WebView2: Windows 11 has it built in; on Windows 10 the installer adds it if it is missing. With the portable ZIP, if the window does not open, install the Microsoft Edge WebView2 Runtime.
- Aimloom finds KovaaK by itself. If it cannot, choose the folder that holds FPSAimTrainer (Steam → Manage → Browse local files).
- From 0.1.6 the left side has Explore and Customize: Customize holds Profile, Theme, Sounds, Crosshair and Enemy look; Explore holds Quick import and Backup and restore. In 0.1.5 the five pages are listed directly, and "Quick import" at the bottom left installs packs and restores backups.
Select, preview, apply
On the Theme, Sounds and Enemy look pages, selecting only previews. "Apply background", "Apply sound" and "Apply skin" write to the game, after a backup. Quit KovaaK first: while it runs, Aimloom refuses to write, because the game overwrites the change when it exits. The change shows the next time it starts. The Crosshair page has no apply button: it writes from the sheet you open, and the crosshair in use is chosen in the game.
Adding your own files
On the Theme page use "Add theme…", on the Sounds page "Add sound…", or drag the file into the window; a crosshair PNG goes onto the Crosshair page. Nothing is written until you confirm with "Add to game" in the sheet that opens: the file is copied as it is, never over an existing one, and can be undone. After adding, the page's apply button is still what puts it to use; the crosshair is chosen in the game's settings. Enemy skins come only from the game's own skins and cannot be added.
Choose the crosshair in the game
The crosshair page replaces or adds PNG files in the crosshairs folder. Which crosshair you use is chosen in the game's crosshair settings; replacing changes an existing file's image and keeps its name.
Backup and undo
Every write is backed up first, and the state before your first change is kept for good (the first-protection state). "Backup and restore" on the Explore page (in 0.1.5, "Quick import" at the bottom left) undoes a particular write or returns to that state. Backups live in %LOCALAPPDATA%\Aimloom\backups, apart from the game folder.
Common problems
- Aimloom's background engine did not start (0.1.5 says PowerShell 7 was not found): antivirus software may have blocked it, or the install is incomplete. Run the installer again to repair it, then reopen Aimloom.
- The game is running: quit KovaaK completely and retry. Aimloom never force-closes the game.
- Anything else: email feedback@aimloom.dev with a screenshot, VERSION.txt from the app folder and %LOCALAPPDATA%\Aimloom\logs\worker.log.