ACE UI App Loader v0.24.0

Assetto Corsa EVO UI App Loader

Support for custom UI Apps in Assetto Corsa EVO.

Assetto Corsa EVO builds its interface out of web pages. The ACE UI App Loader lets custom ui apps live in there alongside the game's own screens, and gives you one place to switch them on and off.

---

Why this exists

AC EVO currently has no mod support for its UI, so the only way in is to replace one of its files — and only one mod can hold a file. Two mods that both want the HUD overwrite each other, and installing the second one silently breaks the first.

This UI App Loader is that one mod. It does the replacing once and then loads apps on top, so apps are added alongside each other instead of fighting over the same file.

---

Installing ACE UI App Loader

1	Download the ACEUIAppLoader-….zip from the latest release and open it. Inside is one folder, mods. (The release also has an …-alternate.zip. Ignore it unless the help section below sends you to it.)
2	Press Win + R, paste this in, press Enter: %USERPROFILE%\Saved Games\ACE
3	Drag the mods folder out of the zip into that window. If Windows asks, choose to merge with the mods folder already there. No installer, nothing to run. You end up with mods\ACEUIAppLoader.kspkg and an empty mods\uiresources\ACEUIAppLoader folder, which is where apps will go. Every app is installed the same way: extract its zip into Saved Games\ACE, merge.

---

Why there are two zips (normal and alternate)

Every release has ACEUIAppLoader-….zip and ACEUIAppLoader-…-alternate.zip. Almost everyone wants the first. Here is what the second is for, in plain terms.

The loader works by giving the game a replacement for two of its own HUD files. When the game starts it gathers the files of every mod in mods into one list, and where two mods offer the same file, the order of that list decides which one is used. With only the loader installed, ours always comes first. With several other mods installed, once in a few thousand combinations the game's own file lands ahead of ours instead, and the loader silently does nothing: no drawer, no apps, and no ACEUIAppLoader lines in the game's log. Which combinations do this cannot be told from outside; it depends on the exact set of mod files on your machine.

The alternate zip contains the same loader, packed a different way, so that it sorts differently in that list. In testing over eight housand mod folders, the two zips never both lost in the same folder. So the rule is simple:

1. Install the normal zip.
2. If the drawer never appears and the newest log in Saved Games\ACE\Logs has no ACEUIAppLoader lines, delete mods\ACEUIAppLoader.kspkg` and install the alternate zip the same way.
3. If the drawer disappears again after you install another mod, swap back.

The loader's first log line tells you which one you have: loader 0.24.0 on /hud.html (64 records) is the normal zip, (32 records) the alternate. Nothing else differs; apps, settings and everything on this page work the same with either.

---

The app drawer

Move your mouse to the right edge of the screen and the drawer slides in. Every ui app you have installed is listed there with its own switch — flick one on and it appears straight away, flick it off and it's gone.

---

Apps using the ACE UI App Loader

Pedal Graph Inputs represented as a graph	DOOM DOOM running natively inside EVO's HUD

---

If something isn't right

Important

Each release is built for one version of the game — this one for 0.9.1+release.6.
After the game updates, come back here for the matching release.

The game updated and the HUD is blank, missing, or the menus misbehave

The file carries two of the game's own pages from the version it was built for. After an
update those are the old game's, and if they still get used the HUD can come up empty or
wrong. The loader tells you when this has happened: a red strip across the top of the HUD
reading ACE UI App Loader was built for game … but this is ….

Delete ACEUIAppLoader.kspkg from the mods folder, start the game once to confirm it
is back to normal, then install the release built for the new version. Whenever the game
misbehaves right after an update, removing this file is the first thing to try.

The drawer doesn't appear

First, open the newest file in %USERPROFILE%\Saved Games\ACE\Logs and search it for
ACEUIAppLoader. Lines found means the loader ran and the problem is with an app: see the
next section. No lines at all means the game never used the file, for one of these reasons:

1. The game updated. By far the most common cause. See above.
2. The file is in the wrong place. It must be exactly Saved Games\ACE\mods\ACEUIAppLoader.kspkg,
   with that name. The usual way this goes wrong is Windows' Extract All, which puts
   everything in a folder named after the zip (ACE\ACEUIAppLoader-0.24.0-…\mods\…); drag the
   mods folder itself into Saved Games\ACE instead.
3. Two copies. Exactly one ACEUIAppLoader…kspkg in mods — an older copy left beside
   the new one (ACEUIAppLoader (1).kspkg, say) can win instead of it.
4. Your other mods. With several other .kspkg mods installed, the game very occasionally
   picks its own file over ours; which folders that happens in is a coin toss we cannot see
   from outside. That is what the …-alternate.zip on the release page is for: it is the
   same loader packed so that the toss lands differently. Delete ACEUIAppLoader.kspkg and
   install the alternate zip the same way. If installing another mod later brings the problem
   back, swap again.

An app isn't in the drawer

Check that app's own instructions. Most are two pieces — a folder and a small marker file —
and it's easy to install one and miss the other. The marker file must be completely
empty (0 bytes): the game tries to read every file in that folder as a preset, and one
it cannot read stops the whole list from arriving.

Anything else

Open an issue and say what you saw. If you can, attach the newest file from
%USERPROFILE%\Saved Games\ACE\Logs — it records what loaded and usually answers the
question on its own.

---

Uninstalling

Delete ACEUIAppLoader.kspkg. That's the whole procedure — nothing runs, nothing to undo.
The only trace left is a few small settings records (which apps were switched on, where you put them) inside the game's own UI settings file, which the game ignores.

---

Is it safe?

Nothing runs	No executable, no installer, nothing in the background. It's a data file the game reads.
Your game folder is untouched	Everything lives in Saved Games, where your settings and setups already are.
It doesn't go online	No account, no telemetry, no update check.
Works in multiplayer	Everything is done client-side so nothing is related to the server.
Not anti-cheat evasion	It changes the interface you look at — nothing about how the car drives.
You can read all of it	Every line is in this repository.