ConditionSystemFramework

Native F4SE/CommonLibF4 durability, weapon-condition, armor-condition, and repair framework for Fallout 4.

Mod page and downloads: ConditionSystemFramework on Nexus Mods

Source scope

This repository contains the independently maintained C++ backend, public API headers, configuration examples, developer documentation, ActionScript UI integration source, the jury-rigging menu Animate project, and the Prisma UI condition widget.

It does not include:

• ESP/ESL/ESM plugin records
• compiled Papyrus scripts
• compiled DLL, PEX, or SWF files
• MCM package files
• fonts, icons, or other FallUI assets

Install the complete mod package from Nexus Mods for normal gameplay. The public source license applies only to files contained in this repository.

Features

• Weapon and armor durability tracking
• Condition-based damage and armor calculations
• Weapon jams and configurable wear behavior
• Loot condition initialization and over-repair support
• Repair kits and jury-rigging systems
• JSON-driven weapon, armor, ammo, modifier, exclusion, and repair rules
• Public durability interface for other F4SE plugins
• ItemIntegrationFramework integration and optional Prisma UI F4 integration
• Multiple Fallout 4 runtime generations through CommonLibF4

UI source

• ui/actionscript/jury-rigging-menu contains the CSF jury-rigging menu AS3, its earlier AS2 source, and the Adobe Animate FLA project.
• ui/actionscript/condition-widget contains the Scaleform condition widget AS3 classes and Adobe Animate FLA project.
• ui/actionscript/fallui-patches contains the four menu scripts modified for CSF workbench buttons, repair navigation, and condition display integration.
• ui/prisma/views contains the CSF-authored condition widget for Prisma UI 2.0.

The FallUI patch sources are separated from original CSF UI code so their provenance is explicit. They require the corresponding game/FallUI menu projects and assets; those third-party assets are not included here.

Requirements

• Windows 10 or later
• Visual Studio 2022 Build Tools with Desktop development with C++
• Git
• XMake 3.0 or later
• A CommonLibF4 checkout selected by the build environment
• Fallout 4 Script Extender
• ItemIntegrationFramework

ItemIntegrationFramework is a required runtime dependency. Prisma UI F4 is an optional integration and is discovered by the plugin at runtime.

Build

This project must be built against an existing CommonLibF4 checkout. When run inside the FO4 workspace, the build script resolves the workspace global CommonLibF4 profile. It also accepts COMMONLIBF4_PATH or an explicit -CommonLibF4Path; it never clones a project-local CommonLibF4:

.\scripts\build.ps1

To use an explicit CommonLibF4 checkout:

.\scripts\build.ps1 -CommonLibF4Path D:\path\to\commonlibf4

Manual build:

$env:COMMONLIBF4_PATH='D:\path\to\commonlibf4'
xmake f -P .-y -m releasedbg
xmake -P .-y ConditionSystemFramework

The dependency checkout must include its commonlib-shared submodule.

Configuration development

Default profile files are under config/ConditionSystemFramework. Annotated examples and bilingual configuration guides are under docs/. Runtime packages place the profile directory at:

Data/F4SE/Plugins/ConditionSystemFramework

The compiled plugin belongs at:

Data/F4SE/Plugins/ConditionSystemFramework.dll

License

Original CSF source is released under GPL-3.0-only. Built binaries also contain commonlib-shared code distributed under GPL-3.0 with the CommonLib Modding Exception. Vendored Xbyak files remain under their original BSD-3-Clause license. Third-party portions and compatibility patch bases remain subject to their respective terms. See COPYRIGHT, THIRD_PARTY_NOTICES.md, and licenses/commonlib-shared for details.