actools

AcTools (and Content Manager)

Set of utils and apps designed for Assetto Corsa. Some obsolete projects are moved here.

Common libraries

• AcTools

  Main library, used by any other project (including Cars Manager and even modded KsEditor). Contains methods to work with common AC files, launches game and stuff.

• AcTools.GenericMods

  Small library for managing JSGME mods, fully compatible, but with optional hard links support.

• AcTools.LapTimes

  Thing for reading best lap times from different sources. Uses LevelDb for reading from the original launcher (which saves times using Chromium’s IndexedDB).

• AcTools.LapTimes.LevelDb

  Small “spin-off” which loads times from old AC database. It was made using IndexedDB in Chromium, which uses LevelDB underneath. Quite a mess if you want to read it. Thankfully, now it’s completely redundant, I’m going to remove it for good.

• AcTools.Render

  A replacement for AcTools.Kn5Render. Has a much more thoughtful architecture and thereby contains two different renderers: Lite (very simple skins-editing DX10-compatible version) and Dark (extended variation of Lite, with lighting, skinning and a lot of effects such as SSLR, SSAO, PCSS). Both use forward rendering. There was also deferred renderer, but it was quite poor and got moved away.

  Apart from simple rendering, has a bunch of special modes, allowing to update ambient shadows, AO maps, recalculate tracks’ maps and outlines.

  

  

  

  

• LicensePlates

  Fully independent from AcTools.* library which generates number plates using Lua to interpret style files and Magick.NET to create and save textures. In action.

• StringBasedFilter

  Small library for filtering objects by queries like *ca & !(country:c* | year<1990).

Content Manager

• AcManager.Tools

  Library with logic, almost without any UI parts (like CarsManager and CarObject, for instance).

• AcManager.AcSound

  Wrapper for AcTools.SoundbankPlayer, which is, in its turn, just a very small thing built around FMOD library to play FMOD soundbanks.

• AcManager.LargeFilesSharing

  Small sub-library for uploading big files into various clouds. Could weight more than 2 MB with only official Google library, but self-written takes much less.

• AcManager.ContentRepair

  Contains a bunch of diagnostics and repairs for common custom cars’ issues in AC.

• AcManager.Controls

  Library with common UI components (like AcListPage).

• FirstFloor.ModernUI

  Main UI library. Slightly modified version of Modern UI for WPF (MUI).

  

• AcManager

  App itself.

  

Other apps

• CustomPreviewUpdater

  Generates previews using AcTools.Render.

• CustomShowroom

  Small wrapper for AcTools.Render library, for standalone use without Content Manager.

• LicensePlatesGenerator

  Small console wrapper for LicensePlates library.

Build notes

• For now, only x86 platform is supported. Projects can be built in x64, but, most likely, it won’t work. It should be fixable, all referenced libraries have both x86 and x64 version. Going to solve it later.

• If you need a support for new Windows 8, 8.1 and 10 notifications, make sure this path is correct. If it’s not, or you don’t have that library, no problem, dependant piece of code will be disabled, and fallback notifications will be used.

• I use a couple of small tools (mostly Cygwin shell scripts) to increment version number and auto-build T4 templates automatically, but they are disabled by default unless you have ACTOOLS_BUILD_SCRIPTS=On environment variable set. So… Don’t set it, or make sure you have something compatible in your system. If needed, I’d be glad to send my scripts to you.

• You might need to install DirectX SDK to rebuild AcTools.Render/Shaders/Shaders.tt. But, just in case, built Shaders.cs and Shaders.resources are already included. Also, it takes quite a long time to rebuild those shaders, up to 5–10 minutes on my PC.

• Feel free to contact me anytime. I don’t have any experience with open-source projects, but I’d be glad to learn.