Base Object Swapper

F4SE framework for exchanging basic objects and references using configuration files.

Original address:

Prefix:

Address Library for F4SE Plugins:

Baka Framework:

AE will be updated on November 30, 2025, which is the anniversary update moderator file

The main files of the previous generation version (163) and the next generation version (984) have been packaged and uploaded together. You can choose to install them according to your own game version.

Basic object exchanger

Require

F4SE address library of F4SE plug-in

Visual C++ Redistributables 2019

BakaFramework

describe

F4SE utility plugin that allows mod authors to exchange base objects with others using configuration files.

This is a port of Skyrim Special Edition's Base Object Swapper.

With this mod you can...

Randomly assign different model variables to misc objects

And more!

Due to Fallout 4's pre-combination system, swapping static and static sets is not recommended.

How to use

Distributed logging should be written to an ini file in the Data folder that contains the suffix "_SWAP" (for example, MyMod_SWAP.ini).

They should follow the following general format:

[form]

origBaseID|swapBaseID|transformOverrides|chance

origBaseID|swapBaseID|swapBaseID，swapBase2ID，swapBase3ID|transformOverrides|ance

[References]

origRefID|swapBaseID|transformOverrides|ance

[Form|LocationEDID, CellEDID, KeywordEDID, RegionEDID]

origBaseID|swapBaseID|transformOverrides|chance

ID can be of an object

formID or editorID, origBase is the base object you are trying to replace (e.g. all farmhouse static objects).

origRef is the specific object reference you are trying to replace (i.e. the specific farmhouse in Riverwood).

swapBase is the replacement object you want to replace it with (e.g. your Farmhouse static with new model).

Position replacement

ObjectFormID~ModName.esp OR ObjectEditorID

Location-based form exchange

Requires location/cell editorID or keyword editorID (for location); this swaps all CoffeeCup01 misc objects in Diamond City for cracked variants

[Forms|DiamondCityLocation]

CoffeeCup01|CoffeeCupCracked01;this swaps all coffee cups with cleaned variants in locations with LocTypeBar keyword

[Forms|LocTypeBar]

CoffeeCup01|CoffeeCup01clean

Property Overrides

Convert

Change the position, rotation, and scale of swap objects

POS - Location

rot - rotate

scale - scaling

Units must be floats (20.0)

A/R suffix for setting relative and absolute transformations. for position/rotation

posR(1.0,5.0,100.0) will set the new position relative to the reference base position

posA(300.0,100.0,200.0) will overwrite the reference base position

scale is multiplicative/absolute.

Scale randomization is possible

scale(1.0/2.0) will multiply the existing scale by 1.0 to 2.0

scaleA(100/200) will override the reference scale

record flag

Set/clear logging flags on references (flags/flagsC))

See (same as FO4) for all possible record flags

flags (0x20000000) Set the Don't Havok Settle flag

flagsC (0x20000000) Clear the Don't Havok Settle flag

Leave NONE if you don't need property overrides; swaps CoffeeCup01 misc items to cracked variants with relative position + random Z position of 50 to 100, and random scale between 1.0 and 1.50.

[Forms]

CoffeeCup01|CoffeeCupCracked01|posR(10.0,5.0,50.0/100.0),scale(1.0/1.50)

Transform overrides can also be set directly without swapping objects. Requires [Transforms] or [Properties] section

[Transforms]

origBaseID|transformOverrides|chance

origRefID|transformOverrides|chance

[Transforms|LocationEDID,CellEDID,KeywordEDID,RegionEDID]

origBaseID|transformOverrides|chance

Objects that affect the exchange

[Transforms]

Bowl_05_Silver|rotR(-90,0,0),scale(2.0)

Chance

Percent chance of random swapping/no swapping at all between multiple swap objects

Odds (0 - 100)

Default value is 100

S/R/L suffix

chanceS(50) - Fixed random chance (persists across game sessions; object references will always be swapped or not)

chanceL …