T4rg3t5Docs
settings

Settings

T4rg3t5's player-backed settings and their PLAYER and MENU access contract.

Settings live in SettingsPlayerT4rg3t5. PLAYER scripts should normally use the Manager; MENU scripts can access the player section directly. LOAD scripts can't access it—they don't get a vote here.

---@omw-context menu
local Settings = require 'openmw.storage'.playerSection('SettingsPlayerT4rg3t5')

local checkLOS = Settings:get('CheckLOS')
Settings:set('CheckLOS', true)

Fields

FieldTypeDefaultMeaning
S3TargetLockBindinginput bindingT4TargetLockBindingKeyBinding for the S3TargetLock trigger.
TargetLockTogglebooleantrueEnables target locking.
SwitchOnDeadTargetbooleantrueSelects another target when the locked target dies.
CheckLOSbooleanfalseContinues checking line of sight after acquisition. Initial acquisition always checks visibility.
ThirdPersonLockCamerabooleantrueEnables T4rg3t5's third-person lock camera.
EnableFlickSwitchbooleantrueEnables mouse-flick target switching.
FlickSwitchDistanceinteger64Mouse distance required for flick switching.
EnableHitBouncebooleantrueEnables hit feedback on the target marker.
HitBounceSizeinteger16Additional marker size at the bounce peak.
DisableLockWhenSheathingbooleanfalseClears the lock when the player sheathes.
LockOnCombatStartbooleanfalseAutomatically locks onto an actor that starts combat with the player.
CameraDistanceinteger120Base camera distance from the player.
CameraHeightinteger25Camera height offset.
CameraSideOffsetinteger90Horizontal shoulder offset.
CameraPreferredShoulderstringRightShoulder preferred when a new target lock begins; collision and visibility can still switch sides.
CameraFOVinteger0Vertical lock-camera field of view in degrees; 0 inherits the current FOV. T4rg3t5 restores the previous FOV when its camera ends unless another camera has changed it.
CameraMinDistanceinteger30Minimum collision-pinned camera distance.
CameraResponsivenessinteger6Third-person camera spring responsiveness.
CameraLookResponsivenessinteger8Look-target spring responsiveness.
CameraLookBiasinteger80Percentage bias from player center toward the target.
TargetFramingHeightinteger80Height on the target that the lock camera looks toward, from feet (0) to head (100).
LockLossDelaynumber0.25Seconds a temporarily invalid target remains locked before the lock breaks.
TargetMinSizeinteger32Marker size at or below TargetMinDistance.
TargetMinDistanceinteger256Distance at which the marker reaches minimum size.
TargetMaxSizeinteger128Marker size at TargetMaxDistance.
TargetMaxDistanceinteger3564Maximum lock-on distance; the marker reaches its maximum configured size here.
TargetLockIconstringStarburstBase name of the marker texture.
TargetColorFcolor#0df8ccMarker color at 100% health or above.
TargetColorVHcolor#069e00Marker color at 80–100% health.
TargetColorHcolor#047a00Marker color at 60–80% health.
TargetColorWcolor#9e7100Marker color at 40–60% health.
TargetColorVWcolor#4c3700Marker color at 20–40% health.
TargetColorDcolor#4c0000Marker color at 0–20% health or below.

The settings menu watches the same section, so external writes update its controls.