SuperAPI AI Directory

skyrim-base-object-swapper

Coding & development

View repository

Updated 10-30 16:18

About this skill

Base Object Swapper

This skill owns Skyrim BOS 3.4.1 sectioned pipe grammar, re-verified unchanged in 3.5.0.

Sections and entries

[Forms]
OriginalBase|SwapBase|PropertyOverrides|Chance

[References]
OriginalReference|SwapBase|PropertyOverrides|Chance

[Transforms]
OriginalBaseOrReference|PropertyOverrides|Chance

[Properties]
OriginalBaseOrReference|PropertyOverrides|Chance

Condition-qualified section headers are supported. Do not introduce a competing Base = Swap dialect.

Transform grammar

Function invocations must remain contiguous:

rotR(147.9,355.9,82.7)       valid
rotR(147.9, 355.9, 82.7)     parser-breaking in the locked grammar

The second shape can be split into tokens, producing log messages such as failed to process rotR(147.9, 355.9, and 82.7).

Conflict law

The last config alphabetically wins. That identifies priority, not semantic correctness. Resolve the actual reference, cell/worldspace, qualifiers, patch intent, and expected transform before renaming or deleting a config.

Mandatory validation

Run both tools:

python ..\skyrim-distr-kid-validation\scripts\lint_framework_configs.py <directory>
python scripts\audit_bos_configs.py <directory>

audit_bos_configs.py must report both duplicate targets and whitespace-split transform/property invocations. Its self-test includes the production-shaped rotR(147.9, 355.9, 82.7) failure.