14.5.0 • Public • Published


CameraStackService provides a camera stack of objects that can report a camera state. This allows a composable camera system for a variety of situations that arise, and lets systems interop with each other


npm install @quenty/camera --save


  • Minor VR support
  • Support for composable camera types
  • Support for interpolation between camera nodes
  • Support for touch and gamepad support and controls
  • Support for camera shake

Camera State

CameraState is an immutable camera system used for camera interpolation. Designed to make camera effects easy, it trades some efficiency and speed for making a not confusing camera system.

Camera state stores internal state of Coordinate frames as quaternions. This means that the classic lerp equation. Operations have been overridden to make this easier to work with.

Ok. It's not entirely immutable. They are kind of lazy, that is, reading data doesn't affect the state of them. There are no required update loops or anything for the most part.

Camera effect API

Current Camera Effects have the following API available. Adding new effects means that these two should follow the same API specifications

Add + operator

Returns a new Summed camera and adds the two effects together. This is used for combining effects


Indexing the CameraEffect should return the current camera state. This means that state is easy to index.

In previous versions, the following will also work. However, this is no longer true.

  • .State
  • .CameraState
  • .Camera

This will return a CameraState

!!! warning Note that eventually we plan to deprecate everything but .CameraState


This class tracks the current camera ROBLOX uses and lets it maintain how it operates using a BindToRenderStep trick.

  • Should call BindToRenderStep during construction
  • Only one should exist at once per client (not enforced in code, however)


This class takes two arguments and returns the summation of the two

  • Arguments can be either CameraState or a CameraEffect, assuming the effect has a CameraState member


This classes allows the effects of a camera to be faded / varied based upon a spring

  • Starts at 0 percent effect


Here is sample usage of using just a subcomponent. Recommendation is to use full camera stack service.

local RunService = game:GetService("RunService")
local Workspace = game:GetService("Workspace")

local FadeBetweenCamera3 = require(modules.FadeBetweenCamera3)
local CustomCameraEffect = require(modules.CustomCameraEffect)
local CameraState = require(modules.CameraState)

local defaultCamera = require(modules.DefaultCamera).new()
defaultCamera:BindToRenderStep() -- capture roblox camera automatically

local targetCamera = CustomCameraEffect.new(function()
  local target = CameraState.new()
  target.CFrame = CFrame.new(0, 100, 0)
  target.FieldOfView = 70

  return target

local faded = FadeBetweenCamera3.new(defaultCamera, targetCamera)
faded.Speed = 5

RunService:BindToRenderStep("CameraStackUpdateInternal", Enum.RenderPriority.Camera.Value + 75, function()

-- Input
local mouse = game.Players.LocalPlayer:GetMouse()
local visible = false
  visible = not visible
  if visible then
    faded.Target = 1
    faded.Target = 0

Package Sidebar


npm i @quenty/camera

Weekly Downloads






Unpacked Size

140 kB

Total Files


Last publish


  • quenty