Addictol

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 · Installation · Configuration · Menu · Building · Contributing · License}

---

Requirements

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	The standalone menu host is a separate mod installed independently. Addictol continues without an in-game menu when the host is absent.

---

Features

The 90 modules cover the following areas. Most 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.

---

Installation

Install with a mod manager, or extract the release archive into the Fallout 4 Data directory:

Data\
├─ F4SE\Plugins\
│  └─ Addictol.dll, Addictol.toml, Addictol_*.ini
└─ Scripts\{Addictol,XCELL}.pex

The archive also contains Addictol.pdb and Papyrus source files; neither is required to play.

---

Configuration

The central registry exposes 112 settings through [Patches], [Fixes], [Warnings], [Telemetry], and [Additional]. The shipped Addictol.toml documents every option inline.

Warning

Do not edit Addictol.toml; updates overwrite it. Put only your overrides in AddictolCustom.toml beside it.

[Fixes]
bUnalignedLoad = false

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.

---

Menu

DearModdingUI owns the shared menu. Press F11 to open it, or set [Additional] sMenuToggleKey in DearModdingUI.toml to F1-F12, Home, End, Insert, or Delete.

Addictol no longer reads its former bMenu or sMenuToggleKey settings. Existing custom keys are not migrated; copy them to DearModdingUI.toml or change them through the host settings page.

Page	Contents
Home	Runtime, live module summary, project links, and common answers.
Settings	All 112 Addictol settings under Stability, Performance, Visuals, Audio, Gameplay, Interface, and Diagnostics.
Modules	Every registration outcome, with search, outcome filters, skip reasons, and the config key for disabled modules.
Telemetry	Overview, Memory, Decompression, Stability, and Audio panels.
Log Control	Session-only record and flush levels with the live output rate.

Note

Telemetry panels appear only when [Telemetry] bEnabled is true; it defaults to false.

Shared appearance, accessibility, and toggle-key controls live behind the footer gear. Addictol's refresh interval remains under Settings > Interface.

---

Building

Use Visual Studio 2022 or its Build Tools with the pinned v143 toolset; newer Visual Studio releases ship v145, so install v143 or override PlatformToolset on the command line as described in CONTRIBUTING.md.

git clone --recurse-submodules https://github.com/Dear-Modding-FO4/Addictol.git
cd Addictol
MSBuild VC/Addictol.sln -p:Configuration=Release -p:Platform=x64

Both build systems stage Addictol's DLL and authored payload under .Build. Addictol builds and ships only its own files; install DearModdingUI separately for the in-game menu. With FO4_DEV_MODS set, xmake install Addictol deploys to its Addictol - Dev mod folder.

---

Contributing

See CONTRIBUTING.md for development setup, the module model, cross-runtime address rules, and pull request requirements.

---

License

GPL-3.0 with a Modding Exception. See LICENSE and EXCEPTIONS.