blushneybusiness-glitch/roblox-omniskills/rbx-camera-controllers

rbx-camera-controllers

Laws

1. Client-only, always. Camera writes from a server Script are silently dropped. Every

rig lives in one LocalScript-driven module. Any gameplay value derived from the camera that reaches the server (aim direction, look target) is re-validated there — dot-product and range checks per rbx-security-anticheat; the client's camera is a claim, not a fact.

1. Scriptable only while you own it. Set CameraType = Enum.CameraType.Scriptable on

rig start, restore Custom in a teardown that runs on every exit path. A player stuck in a dead camera is a session killer.

1. One rig at a time. A single controller module with a setMode(name) switch. Two

scripts writing camera.CFrame produce the classic one-frame flicker war.

1. RenderStepped, never Heartbeat. Heartbeat runs after render — one full frame of lag.

Use RunService:BindToRenderStep("Rig", Enum.RenderPriority.Camera.Value - 1, fn).

1. Rebind on respawn. Cache HumanoidRootPart/Head inside CharacterAdded, never at

module top level. Stale references after death are the #1 camera bug report.

Recipes

• Third-person follow — pivot = root position + 2 studs up; offset Vector3.new(0, 4, 12);

desired = CFrame.lookAt(pivot + offset, pivot); smooth with camera.CFrame:Lerp(desired, math.min(dt * 8, 1)). Mouse-wheel zoom: 2 studs per notch, clamped 2–30 (InputChanged only — wheel never fires InputBegan).

• Over-shoulder — MouseBehavior = LockCenter while active; yaw/pitch accumulate from

input.Delta * 0.003 rad/px, pitch clamped ±math.rad(80); offset (right 2.5, up 2, back 8) rotated into yaw space. Wall clip: raycast pivot→camera each frame, on hit pull camera to hitDistance - 0.5.

• First person — `CFrame.new(head.Position) CFrame.Angles(0, yaw, 0)

CFrame.Angles(pitch, 0, 0), pitch clamped ±math.rad(89). Hide the head with LocalTransparencyModifier = 1 — never Transparency`, which replicates to everyone.

• Top-down — camera at root.Position + Vector3.new(0, 35, 18) looking at the root;

lerp position only (alpha dt * 6), keep rotation fixed so the world never swims.

• Locked-axis (side-scroller) — freeze one world axis of the follow position; the

player moves in a plane, the camera tracks the other two axes at alpha dt * 8.

Sensitivity, zoom limits, and invert-Y are CONFIG-top values wired to a settings screen via rbx-ui-settings, never hardcoded mid-function (contract in luau-contract.md).

Performance budget

One render-step connection for the whole rig; zero table allocations per frame (reuse locals, no closures created in the loop); camera math ≤ 0.1 ms/frame; wall-clip raycast is one ray with a cached RaycastParams; connection disconnected the moment the mode exits.

Load with

rbx-camera-shake — all impact motion composes through its trauma layer, never raw offsets here. rbx-input-bindings when the rig changes what keys do (aim toggle, shoulder swap). rbx-input-mobile for touch-drag look on phones — don't ask, include it. rbx-ui-settings for the sensitivity slider.

AI-tells

• ☐ Camera code in a server Script (silently does nothing)
• ☐ CFrame written without CameraType = Scriptable first (default controller fights it — jitter)
• ☐ No pitch clamp — camera flips over the pole
• ☐ Legacy CFrame.new(pos, lookAt) constructor instead of CFrame.lookAt
• ☐ Heartbeat-driven camera (one frame of drag on every motion)
• ☐ No CharacterAdded rebind — camera dies on first respawn
• ☐ Third-person rig with no wall-clip raycast
• ☐ Head hidden with Transparency instead of LocalTransparencyModifier

Memory

Read: preferences.md (camera-feel likes/dislikes — smoothing, invert-Y, FOV taste) and the game's projects.md block (existing rig module path, chosen offsets). Write: the shipped controller's module path into module-library.md; final offset/sensitivity values into the game's projects.md block once the user approves the feel.