Skip to main content

Plugins

The Interposer supports plugins — DLL or ASI files placed in .interposer\Plugins\ next to the main DLL. Plugins are loaded automatically after all built-in hooks are active, so they can rely on the full Interposer API from the moment they initialise.

How Plugins Are Loaded

On startup, after installing and enabling all built-in hooks, the Interposer scans .interposer\Plugins\ for files matching *.dll and *.asi and loads each one with LoadLibrary. Plugins are unloaded in reverse order when the process exits.

Each successful load is recorded in the session log:

2025-03-14 12:00:01  [PLUGIN LOAD]   C:\Games\MyGame\.interposer\Plugins\CDKey.dll

If a plugin fails to load, the error is logged with the Win32 error code and the remaining plugins continue loading:

2025-03-14 12:00:01  [PLUGIN ERROR]  C:\Games\MyGame\.interposer\Plugins\broken.dll  (error 126)

Available Plugins

PluginDescription
CD KeyGenerates a deterministic CD key from the player username and injects it into a registry value

Writing Your Own Plugin

See Creating a Plugin for the full API reference and a worked example.