mcpField
R
roblox-camera

roblox-camera

github.com/tabooharmonyDevelopment1381.9k installsUpdated 2w ago
Repository

About roblox-camera

Roblox Camera is a development skill for scripting client-side camera behavior, including custom views, CFrame transforms, and screen-based raycasting. It provides API guidance, implementation patterns, and pitfalls for common camera tasks.

Key features

  1. 01CameraType and camera property guidance
  2. 02CFrame positioning and rotation
  3. 03PreRender camera update loop
  4. 04Screen and viewport raycasting
  5. 05Recipes for custom camera effects

Use cases

  1. 01Creating cutscenes and third-person views
  2. 02Implementing custom camera rotation
  3. 03Casting rays from screen coordinates

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/tabooharmony/roblox-brain --skill roblox-camera

After installing, type/roblox-camerain Claude Code to confirm it loaded.

Bundled filesreferences/full.md

Details

From the project README

Roblox Camera

When to Load

Load when scripting custom camera behavior (cutscenes, third-person follow, custom rotation), manipulating CFrame for placement/rotation, raycasting from the screen, or building a non-default player view. Client-only.

Quick Reference

The Camera: workspace.CurrentCamera: one per client. Set CameraType = Scriptable to disable defaults and take full control. Without it, defaults overwrite your CFrame every frame.

CameraType: Fixed, Attach/Watch/Track/Follow (subject-following), Custom (default), Scriptable (no default), Orbital (fixed Y, rotates around player). CameraSubject cannot be nil: setting it reverts.

Key properties: CFrame, CameraSubject, FieldOfView (deg), FieldOfViewMode (Vertical/Diagonal), NearPlaneZ, ViewportSize, HeadLocked, HeadScale, Focus.

CFrame essentials:

OperationLuau
Position onlyCFrame.new(position)
Look at targetCFrame.lookAt(position, target, upVector)
XYZ rotationCFrame.Angles(rx, ry, rz)
Local to worldcf * Vector3.new(0, 0, 10)
Interpolatecf:Lerp(goal, alpha)
Unit axescf.LookVector, cf.RightVector, cf.UpVector

Custom camera loop: always PreRender, never Heartbeat:

camera.CameraType = Enum.CameraType.Scriptable
RunService.PreRender:Connect(function(dt)
    local desired = CFrame.lookAt(head.Position - offset, head.Position)
    camera.CFrame = camera.CFrame:Lerp(desired, math.min(dt * 10, 1))
end)

Raycasting from camera: camera:ScreenPointToRay(mx, my) (accounts for GUI inset) vs camera:ViewportPointToRay(mx, my) (raw, NO inset). ScreenPointToRay returns a unit Ray (1 stud); multiply Direction by length for the actual raycast.

Pitfalls:

  • Client-only. Server sets silently dropped.
  • Without Scriptable, defaults overwrite your CFrame every frame.
  • PreRender for camera (visual sync). Heartbeat adds 1-frame lag. RenderStepped still works but is superseded by PreRender.
  • Camera.CFrame lacks VR head rotation; use GetRenderCFrame() for the true view.
  • SetRoll is outdated; apply roll via CFrame.Angles(0, 0, roll) on CFrame.
  • CFrame.new(pos, lookAt) is legacy (back-compat only); use CFrame.lookAt(at, lookAt) for new code.

See references/full.md for first/third-person recipes, cutscenes, screen shake, mouse-look, full API.

Comments

Markdown supported