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

101 lines
4.2 KiB
YAML

Camera: "OpenMW Camera"
settingsPageDescription: "OpenMW camera settings."
thirdPersonSettings: "Third Person Mode"
maxDistance: "Maximum Camera Distance"
maxDistanceDescription: |
How far the camera can zoom out.
(default: 800 game units)
viewOverShoulder: "View Over the Shoulder"
viewOverShoulderDescription: |
Controls third person view mode.
No: view is centered on the character's head. Crosshair is hidden.
Yes: while weapon sheathed the camera is positioned behind the character's shoulder, crosshair is always visible.
shoulderOffsetX: "Shoulder View Horizontal Offset"
shoulderOffsetXDescription: >
Horizontal offset of the over-the-shoulder view.
For the left shoulder use a negative value.
shoulderOffsetY: "Shoulder View Vertical Offset"
shoulderOffsetYDescription: >
Vertical offset of the over-the-shoulder view.
autoSwitchShoulder: "Auto Switch Shoulder"
autoSwitchShoulderDescription: >
When there are obstacles that would push the camera close to the player character,
this setting makes the camera automatically switch to the shoulder farther away from the obstacles.
zoomOutWhenMoveCoef: "Zoom Out When Move Coef"
zoomOutWhenMoveCoefDescription: >
Moves the camera away (positive value) or towards (negative value) the player character while the character is moving.
Works only if "view over the shoulder" is enabled. Set this to zero to disable (default: 20.0).
previewIfStandStill: "Preview if Stand Still"
previewIfStandStillDescription: >
Prevents the player character from turning towards the camera direction while they're idle and have their weapon sheathed.
deferredPreviewRotation: "Deferred Preview Rotation"
deferredPreviewRotationDescription: |
If enabled then the character smoothly rotates to the view direction after exiting preview or vanity mode.
If disabled then the camera rotates rather than the character.
ignoreNC: "Ignore 'No Collision' Flag"
ignoreNCDescription: >
Prevents the camera from clipping through objects that have NC (No Collision) flag turned on in the NIF model.
move360: "Move 360"
move360Description: >
Makes the movement direction independent from the camera direction while the player character's weapon
is sheathed. For example, the player character will look at the camera while running backwards.
move360TurnSpeed: "Move 360 Turning Speed"
move360TurnSpeedDescription: "Turning speed multiplier (default: 5.0)."
slowViewChange: "Smooth View Change"
slowViewChangeDescription: "Makes the transition from 1st person to 3rd person view non-instantaneous."
povAutoSwitch: "First Person Auto Switch"
povAutoSwitchDescription: "Auto switch to the first person view if there is an obstacle right behind the player."
collisionEaseOut: "Ease Out After Collisions"
collisionEaseOutDescription: >
When a wall or another obstacle pulls the camera towards the player character and then clears, the camera eases
back out smoothly instead of jumping or moving back at a constant speed. Moving in is always immediate, so the
camera never clips through the obstacle.
collisionEaseOutTime: "Ease Out Half-Life"
collisionEaseOutTimeDescription: >
Seconds for the camera to cover half of the remaining distance while easing back out (default: 0.15).
aimMode: "Aim Mode"
aimModeDescription: >
While a ranged weapon or a spell is readied in third person, the camera stays over the shoulder, moves closer and
narrows the field of view slightly. Melee weapons keep the centred combat view.
aimDistance: "Aim Distance"
aimDistanceDescription: >
Camera distance while aiming, as a share of the normal distance (default: 0.7).
aimFieldOfView: "Aim Field of View"
aimFieldOfViewDescription: >
Field of view while aiming, as a share of the normal field of view (default: 0.9).
headBobbingSettings: "Head Bobbing in First Person View"
headBobbing_enabled: "Enabled"
headBobbing_enabledDescription: ""
headBobbing_step: "Base Step Length"
headBobbing_stepDescription: "The length of each step (default: 90.0)."
headBobbing_height: "Step Height"
headBobbing_heightDescription: "The amplitude of the head bobbing (default: 3.0)."
headBobbing_roll: "Max Roll Angle"
headBobbing_rollDescription: "The maximum roll angle in degrees (default: 0.2)."