Addictol

An F4SE plugin that combines engine fixes, crash fixes, and performance patches for Fallout 4 into a single DLL.

Consolidates patches from Buffout 4, X-Cell, Mentats, Escape Freeze Fix, Baka MaxPapyrusOps, Interior NavCut Fix, and Faster Workshop, alongside fixes written for this project.

Crash logging is not included here. It ships separately as AddictolCrashLogger.

Supported runtimes

One DLL covers all three; there is no separate download per version.

Runtime	Version
OG	1.10.163
NG	1.10.984
AE	1.11.240

Features

• Memory Manager - Replaces the game's allocator with a selectable backend
• Faster Workshop - O(1) keyword lookups instead of scanning all constructible objects
• Zlib Decompression - Selectable stock/libdeflate backend
• Facegen - Validates NPC face textures before using preprocessed data
• Input Switch - Proper keyboard/gamepad device switching
• Scaleform Allocator - Replaces Scaleform's memory mapper with configurable page/heap sizes
• Archive Limits - Increases max BA2 archives the game can load
• Menu - In-game diagnostics window drawn over the game on a configurable key
• Papyrus GC Bug - Fixes a critical bug in garbage collection that causes premature loop termination
• ~80 modules in total, covering crash fixes, engine bug fixes and stability patches

Requirements

• Fallout 4, on one of the runtimes above
• F4SE
• The Address Library for your runtime. Addictol will refuse to load without it.

Installation

Install with a mod manager, or extract the release archive into your Fallout 4 Data directory so that the files land as:

Data/F4SE/Plugins/Addictol.dll
Data/F4SE/Plugins/Addictol.toml
Data/F4SE/Plugins/Addictol_FacegenExceptions.ini
Data/F4SE/Plugins/Addictol_SNCT.ini
Data/F4SE/Plugins/Addictol/Fonts/Inter-Regular.ttf
Data/F4SE/Plugins/Addictol/Fonts/JetBrainsMono-Regular.ttf
Data/F4SE/Plugins/Addictol/Fonts/JetBrainsMono-Bold.ttf
Data/Scripts/Addictol.pex
Data/Scripts/XCELL.pex

The archive also contains Addictol.pdb and the Papyrus script sources; neither is needed to play.

Configuration

Nearly every module can be individually toggled; a small number are mandatory and always run. Addictol.toml is the shipped configuration and documents each option inline.

Do not edit Addictol.toml directly, because it is overwritten on update. Instead create AddictolCustom.toml next to it, containing only the sections and keys you want to change:

[Fixes]
bUnalignedLoad = false

Options are grouped into [Patches] (subsystem replacements), [Fixes] (bug and crash fixes), [Warnings] (diagnostics for problems in your load order), [Others] (patches for specific third-party mods) and [Additional] (tunables belonging to another option).

Addictol writes Addictol.log to Documents\My Games\Fallout4\F4SE\, listing which modules loaded and any that disabled themselves. Check it first if something is not working.

Menu

[Additional] bMenu adds an in-game diagnostics window drawn over the game. sMenuToggleKey accepts F1-F12, Home, End, Insert, and Delete, and falls back to F11 when it does not recognize the name. uMenuRefreshMs sets how often the open tab copies fresh data, clamped to 100-2000 ms.

Tabs appear in module name order and Log Control is always last.

The menu always starts closed. The ImGui host installs its hook for external F4SE plugins regardless of bMenu; a disabled menu registers no setup, draw, or toggle sinks. Window geometry is kept in Data\F4SE\Plugins\Addictol\imgui.ini; the open state is not persisted.

Log Control changes the record and flush levels for the current session and shows the live output rate. The record level decides which lines are kept; the flush level forces a synchronous disk write at that level or higher. These overrides are not persisted; [Additional] sLogLevel and sLogFlushLevel are the persistent controls.

Building

Requires Visual Studio 2022 Build Tools (or VS 2022) with the v143 toolset.

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

Output: .Build/F4SE/Plugins/Addictol.dll

Contributing

See CONTRIBUTING.md for the development setup, the module model, the rules for handling game addresses across the three runtimes, and what a pull request needs to include.

License

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

The menu theme is adapted from Fallout 4 Community Shaders (src/Menu/Theme.h and src/Menu/Theme.cpp), which is GPL-3.0. The bundled Inter and JetBrains Mono fonts in Data\F4SE\Plugins\Addictol\Fonts ship under the SIL Open Font License; their license texts sit next to them.