Camera Mode: Collision

Filter camera that prevents the camera from clipping through walls and terrain. Uses raycasting from target to camera with near-clip plane corner checks.

Class API

Properties

Collision Detection

1. Near-clip plane corners: 4 parallel raycasts from target towards camera, offset by near-clip half-width/height
2. Obstacle-in-front check: Tests if geometry intersects the near-clip plane rectangle
3. Wall pass-through detection: Raycasts between previous and current near-clip center positions

Two Modes

• Raycast mode: Active when collisions detected; casts 4 rays from target to camera corners
• Passive mode: Only checks if obstacles appear in front of camera; re-enables raycast mode when found

Smoothing

• Camera pulls in instantly when hitting an obstacle
• Camera returns to normal distance gradually using TemporalSmoothingNonLinear(1, 7)

Constants

Usage Examples

-- Used internally by orbit/chase cameras
local collision = require('core/cameraModes/collision')()
collision:init()
-- Called each frame after main camera position is computed:
collision:update(data) -- modifies data.res.pos if collision detected

Notes

• Respects settings.cameraCollision toggle - does nothing when disabled
• Minimum collision distance is clamped to 0.5m to prevent camera inside vehicle

See Also

• Camera Mode: Autopoint - Related reference
• Camera Mode: Autozoom - Related reference
• Camera Mode: Big Map - Related reference
• Core Systems Guide - Guide