Files
claudeandClaude Opus 5.5 53e3d92496
Ashlar checks / tooling (push) Successful in 5s
Modern third-person camera defaults, collision ease-out and aim mode
- Shoulder view, auto shoulder switch, standing preview, deferred preview
  rotation, move 360, smooth view change and [Game] smooth movement are
  on by default.
- Collision ease-out: the camera still snaps in on collision but eases
  back out (0.15 s half-life, 60 u/s minimum speed).
- Aim mode: with a ranged weapon or a spell readied in third person the
  view stays over the shoulder, moves closer and narrows the FOV. Camera
  interface v2 adds getAimWeight and enable/disable functions.
- Pure math in camera/ease.lua with unit tests; SCENARIO=camera with
  PASS/FAIL checks; docs in docs/ashlar/CAMERA.md.
- ashlar-run.sh deletes stored Lua settings before each run so changed
  defaults are tested.

Closes #29

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-16 15:45:11 -05:00

114 lines
4.3 KiB
Lua

local storage = require('openmw.storage')
local async = require('openmw.async')
local I = require('openmw.interfaces')
I.Settings.registerPage({
key = 'OMWCamera',
l10n = 'OMWCamera',
name = 'Camera',
description = 'settingsPageDescription',
})
local thirdPersonGroup = 'SettingsOMWCameraThirdPerson'
local headBobbingGroup = 'SettingsOMWCameraHeadBobbing'
local function boolSetting(prefix, key, default)
return {
key = key,
renderer = 'checkbox',
name = prefix .. key,
description = prefix .. key .. 'Description',
default = default,
}
end
local function floatSetting(prefix, key, default)
return {
key = key,
renderer = 'number',
name = prefix .. key,
description = prefix .. key .. 'Description',
default = default,
}
end
I.Settings.registerGroup({
key = thirdPersonGroup,
page = 'OMWCamera',
l10n = 'OMWCamera',
name = 'thirdPersonSettings',
permanentStorage = true,
order = 0,
settings = {
floatSetting('', 'maxDistance', 800),
boolSetting('', 'viewOverShoulder', true),
floatSetting('', 'shoulderOffsetX', 30),
floatSetting('', 'shoulderOffsetY', -10),
boolSetting('', 'autoSwitchShoulder', true),
floatSetting('', 'zoomOutWhenMoveCoef', 20),
boolSetting('', 'previewIfStandStill', true),
boolSetting('', 'deferredPreviewRotation', true),
boolSetting('', 'ignoreNC', false),
boolSetting('', 'move360', true),
floatSetting('', 'move360TurnSpeed', 5),
boolSetting('', 'slowViewChange', true),
boolSetting('', 'povAutoSwitch', false),
-- Ashlar: collision ease-out and aim mode (see third_person.lua and ease.lua).
boolSetting('', 'collisionEaseOut', true),
floatSetting('', 'collisionEaseOutTime', 0.15),
boolSetting('', 'aimMode', true),
floatSetting('', 'aimDistance', 0.7),
floatSetting('', 'aimFieldOfView', 0.9),
},
})
I.Settings.registerGroup({
key = headBobbingGroup,
page = 'OMWCamera',
l10n = 'OMWCamera',
name = 'headBobbingSettings',
permanentStorage = true,
order = 1,
settings = {
boolSetting('headBobbing_', 'enabled', false),
floatSetting('headBobbing_', 'step', 90),
floatSetting('headBobbing_', 'height', 3),
floatSetting('headBobbing_', 'roll', 0.2),
},
})
local thirdPerson = storage.playerSection(thirdPersonGroup)
local headBobbing = storage.playerSection(headBobbingGroup)
local function updateViewOverShoulderDisabled()
I.Settings.updateRendererArgument(thirdPersonGroup, 'maxDistance', { min = 30, max = 2400 })
local shoulderDisabled = not thirdPerson:get('viewOverShoulder')
I.Settings.updateRendererArgument(thirdPersonGroup, 'shoulderOffsetX', { disabled = shoulderDisabled })
I.Settings.updateRendererArgument(thirdPersonGroup, 'shoulderOffsetY', { disabled = shoulderDisabled })
I.Settings.updateRendererArgument(thirdPersonGroup, 'autoSwitchShoulder', { disabled = shoulderDisabled })
I.Settings.updateRendererArgument(thirdPersonGroup, 'zoomOutWhenMoveCoef', { disabled = shoulderDisabled })
local move360Disabled = not thirdPerson:get('move360')
I.Settings.updateRendererArgument(thirdPersonGroup, 'move360TurnSpeed', { disabled = move360Disabled })
I.Settings.updateRendererArgument(thirdPersonGroup, 'collisionEaseOutTime',
{ disabled = not thirdPerson:get('collisionEaseOut'), min = 0, max = 2 })
local aimDisabled = not thirdPerson:get('aimMode')
I.Settings.updateRendererArgument(thirdPersonGroup, 'aimDistance', { disabled = aimDisabled, min = 0.3, max = 1 })
I.Settings.updateRendererArgument(thirdPersonGroup, 'aimFieldOfView', { disabled = aimDisabled, min = 0.5, max = 1 })
end
local function updateHeadBobbingDisabled()
local disabled = not headBobbing:get('enabled')
I.Settings.updateRendererArgument(headBobbingGroup, 'step', { disabled = disabled, min = 1 })
I.Settings.updateRendererArgument(headBobbingGroup, 'height', { disabled = disabled })
I.Settings.updateRendererArgument(headBobbingGroup, 'roll', { disabled = disabled, min = 0, max = 90 })
end
updateViewOverShoulderDisabled()
updateHeadBobbingDisabled()
thirdPerson:subscribe(async:callback(updateViewOverShoulderDisabled))
headBobbing:subscribe(async:callback(updateHeadBobbingDisabled))