Engine fixes, crash fixes, and performance patches for Fallout 4 in one F4SE plugin.
Addictol consolidates proven work from Buffout 4, X-Cell, Mentats, Escape Freeze Fix, Baka MaxPapyrusOps, Interior NavCut Fix, and Faster Workshop alongside fixes developed here.
Requirements · Features · Changelog · Installation · Configuration · Menu · Building · Contributing · License
| Fallout 4 | OG 1.10.163, NG 1.10.984, or AE 1.11.240. One DLL supports all three. |
| Fallout 4 Script Extender (F4SE) | Required for the matching game runtime. |
| Address Library for F4SE | Required for the matching game runtime. Addictol will refuse to load without it. |
| DearModdingUI | Install an ABI 2 standalone host separately. Addictol continues without an in-game menu when the host is absent. |
Most modules can be toggled independently; a small set of core modules is mandatory.
| Capability | Implementation |
|---|---|
| Stability and crash fixes | Guards invalid engine state, repairs shutdown and loading faults, and fixes known crashes across gameplay, rendering, animation, and UI paths. |
| Memory, I/O, and compression | Replaces game allocators, accelerates zlib and save compression, and reduces file and co-save overhead. |
| Performance and limits | Optimizes workshop and configuration lookups, raises archive and handle limits, and removes avoidable engine bottlenecks. |
| Engine and gameplay correctness | Fixes Papyrus GC, navmesh cuts, input switching, audio state, encounter zones, crafting, and other engine behavior. |
| Visuals and display | Corrects facegen, viewmodel shading and depth of field, high-DPI behavior, bloom, local maps, and fullscreen transitions. |
| Diagnostics and telemetry | Reports load-order hazards and module outcomes, with optional sampled memory, frame, decompression, stability, and audio telemetry. |
Note
Crash logging is separate: use AddictolCrashLogger.
Install with a mod manager, or extract the release archive into the Fallout 4 Data directory:
Data\
├─ F4SE\Plugins\
│ └─ Addictol.dll, Addictol_*.ini
└─ Scripts\{Addictol,XCELL}.pex
The archive also contains Addictol.pdb and Papyrus source files; neither is required to play.
Use the latest stable release for
normal installations. Development prereleases are published from master as
vMAJOR.MINOR.PATCH-dev.RUN; they contain newer unpromoted changes and are available from the
full releases list.
Addictol ships Data\F4SE\Plugins\Addictol.toml with every setting documented and
commented out at its default. Uncomment a line to change it, or use the in-game menu:
[Fixes]
bUnalignedLoad = falseIf AddictolCustom.toml exists in the same folder, it is used instead of Addictol.toml.
Most changes take effect on the next launch.
Addictol writes Addictol.log to Documents\My Games\Fallout4\F4SE\. It records which modules
loaded, were disabled, or skipped; check it first when something is not working.
Press End to open the DearModdingUI menu (rebindable in its settings).
| Page | Contents |
|---|---|
| Home | Runtime, live module summary, project links, FAQ, and mod evaluation guide. |
| Settings | All Addictol settings, grouped by area. |
| Modules | Every registration outcome, with search, outcome filters, skip reasons, and the config key for disabled modules. |
| Changelog | Released versions and their notes from the canonical changelog. |
| Telemetry | Overview, Memory, Decompression, Stability, and Audio panels when telemetry or operation profiling is enabled. |
| Facegen Exceptions | Facegen exception coverage, configuration state, and resolution failures. |
| Log Control | Session-only record and flush levels with the live output rate. |
Clone recursively to initialize dependencies:
git clone --recurse-submodules https://github.com/Dear-Modding-FO4/Addictol.git
cd Addictolxmake build AddictolTo build and run tests:
xmake build vmm-tests
.\.Build\Tests\vmm-tests.exeBuild with Visual Studio 2022 or standalone Build Tools using the pinned v143 toolset:
MSBuild VC/Addictol.sln -p:Configuration=Release -p:Platform=x64Both build systems stage Addictol's DLL and authored payload under .Build\. Install DearModdingUI
separately for the in-game menu.
See CONTRIBUTING.md for development setup, the module model, cross-runtime address rules, and pull request requirements.
GPL-3.0 with a Modding Exception. See LICENSE and EXCEPTIONS.