CutsceneManger 2.0 ━ Create and manage cutscenes in a clean and organised way

rugg3344 · May 2, 2025, 11:17pm

v2.1
Github • Model

Previous version:

Testing

Demo place

Info

What is `CutsceneManager`?

CutsceneManager is a module designed to make your cutscenes easier to make and more organised. It can:

Make your cutscene code look cleaner!
Organise your cutscene logic by a big amount.
And so much more!

Why use `CutsceneManager`?

This module contains a lot of advanced methods which can be useful while creating cutscenes. It also has an uniq way to make a cutscene which makes it easy to customise to how you like to organise it.

What scenario can you use this?

Start/End cutscenes
Fighting scenes
Dialogs
Intros
To show something

How can i see what version im on?

If your 2.0 and over, you can see this by doing this:

Submit your own preset!

To submit your own preset, you have to fill out this forum here!

Versions:

Versions

v2.1

CutsceneManger 2.0 ━ Create and manage cutscenes in a clean and organised way - #5 by rugg3344

What’s new?

New features

CutsceneCustomisable is now called Editor
Cutscene is now called Scene
Tons of new method to make it easier to create cutscenes and making them more uniq
More signals added.
New demo place.
Module is completly revamped.
Types is much better.
Github page is open to check out the previous version.

Important changes!

The new version has renamed its create method to CreateScene and added a category argument!
CutsceneCustomisable is now called Editor
Cutscene is now called Scene

How to use it

Example script:

local CutsceneManager = require(script.CutsceneManager) -- Or wherever you store it

--// Presets
local CinemaBars = CutsceneManager.Presets.CinemaBars
local CameraShake = CutsceneManager.Presets.CameraShake

local scene = CutsceneManager:CreateScene("MyTopic", "MyCategory", function(Editor: CutsceneManager.Editor, message: string)
	Editor:Start()
	Editor:LockMovement()
	CinemaBars.moveIn()
	
	--// Camera
	local camera = Editor:CreateCamera({
		Destination = CFrame.new(20, 5, 20),
		CameraType = "Tween"
	})
	camera:Play()
	camera.Completed:Wait()
	
	--// Move the player
	Editor:MoveCharacterToLocation(vector.create(10, 10, 10)):Wait()
	CameraShake.shakeScreen(3, 2.5)
	for i = 1,3 do
		print(message)
		Editor:Jump()
		task.wait(1)
	end
	
	Editor:Finalise("Fade")
	CinemaBars.moveOut()
	Editor:UnLockMovement()
end)

scene.OnCutsceneEnded:Connect(function(result: CutsceneManager.Result, duration: number)
	print(result, duration)
end)

task.wait(5)

scene:Execute("Cutscene manager!!")

Guide

To start of, we need to know what a Scene is and how we can use it in our cutscenes.
A Scene is the main cutscene handler which we can Execute, or just Close. The way you make one is by calling the method inside of CutsceneManager called CreateScene like this:

local scene = CutsceneManager:CreateScene()

This method takes in 3 arguments. the Topic, Category and Callback. The topic is what the cutscene shall be saved and used as, the category is where the cutscene shall be saved and the callback is where we create the main logic of a cutscne. the callback recives an Editor and a thing i like to call Custom arguments. This is arguments which has to be passed in when executed.

local scene = CutsceneManager:CreateScene("MyTopic", "MyCategory", function(Editor : CutsceneManager.Editor, message : string --[[Custom argument]])
	
end)

To execute the cutscene, all you have to do is to call the Execute method in the scene. There are 2 main ways to do this. You can ether do it like this:

local scene = CutsceneManager:CreateScene("MyTopic", "MyCategory", function(Editor : CutsceneManager.Editor, message : string --[[Custom argument]])
	
end)

scene:Execute("Hi")

Or like this:

local scene = CutsceneManager:CreateScene("MyTopic", "MyCategory", function(Editor : CutsceneManager.Editor, message : string --[[Custom argument]])
	
end):Execute("Hi")

For this guide, ill use the first example because its more flexeble then the other one. Now that we know how to execute it, we can learn how the Editor works.

The editor has some methods which can help you create your cutscenes a lot quicker. The main one you’ll be using is the CreateCamera. This creates a basic camera object which can be played or stopped. When you call the method you have to create a configuration table which consists of a few componets. There are 2 of them which has to be filled in. the other ones are optinal.

local scene = CutsceneManager:CreateScene("MyTopic", "MyCategory", function(Editor : CutsceneManager.Editor, message : string --[[Custom argument]])
	local camera = Editor:CreateCamera({
		Destination = CFrame.new(0, 100, 0),
		CameraType = "Tween"
	})
end)

scene:Execute("Hi")

The Camera has 2 methods, but we will be using the Play function to play the camera transition and a signal called completed which will fire off when it finishes the transition.

local scene = CutsceneManager:CreateScene("MyTopic", "MyCategory", function(Editor : CutsceneManager.Editor, message : string --[[Custom argument]])
	local camera = Editor:CreateCamera({
		Destination = CFrame.new(0, 100, 0),
		CameraType = "Tween"
	})
	
	camera:Play()
	camera.Completed:Wait()
end)

scene:Execute("Hi")

You need to know to create a basic cutscene is the Start and Finalize methods. These two is essential for switching the CameraType on the CurrentCamera to Scriptable and Custom. The finalize function has different feature from what the Start function has. It has a feature to have a transition at the end or not to switch from The cutsom camera to the normal player camera.

local scene = CutsceneManager:CreateScene("MyTopic", "MyCategory", function(Editor : CutsceneManager.Editor, message : string --[[Custom argument]])
	Editor:Start()
	
	local camera = Editor:CreateCamera({
		Destination = CFrame.new(0, 100, 0),
		CameraType = "Tween"
	})
	
	camera:Play()
	
	Editor:Finalise("Tween")
end)

scene:Execute("Hi")

Now the last thing you should know is how you can lock the player to the position. The way you can do this is by using the two methods called LockCharacter and UnLockCharacter. These we can implement like this:

local scene = CutsceneManager:CreateScene("MyTopic", "MyCategory", function(Editor : CutsceneManager.Editor, message : string --[[Custom argument]])
	Editor:Start()
	Editor:LockCharacter()
	
	local camera = Editor:CreateCamera({
		Destination = CFrame.new(0, 100, 0),
		CameraType = "Tween"
	})
	
	camera:Play()
	
	Editor:Finalise("Tween")
	Editor:UnLockCharacter()
end)

scene:Execute("Hi")

There is a lot of things i havent covered which the 2.0 got to offer, but it would get too long to read. If you want to know them, you can find them in the Documentation

Documentation

Every argument with a questionmark behind it, is an optinal arguemnt,
which means its not necessary to fill it in.

Methods

CutsceneManager

:CreateScene _{CutsceneManager}

:CreateScene(topic, category, callback) -> (scene)

Creates a cutscene and stores it in the specified category as the specified topic.
The callback expects a Editor and cutstom arguments if needed.

:Eliminate _{CutsceneManager}

:Eliminate(topic, category?) -> (none)

Closes the cutscene and removes it from CutsceneManager’s storage container.

:GetCutscene _{CutsceneManager}

:GetCutscene(topic) -> (scene)

Gets a cutscene from the topic above.

:GetCutscenes _{CutsceneManager}

:GetCutscenes() -> ( {[topic] : scene} )

Returns a dictionary of all the cutscenes saved in CutsceneManager.

:GetCutscenesFromCategory _{CutsceneManager}

:GetCutscenesFromCategory(category) -> ( {[topic] : scene} )

Returns a dictionary of all the cutscenes in the specified
category.

:GetCutsceneFromCategory _{CutsceneManager}

:GetCutsceneFromCategory(topic, category) -> (scene)

Gets the cutscene in the specified category.

:WaitForCutscene _{CutsceneManager}

:WaitForCutscene(topic, category?, timeout?, checksPerSecond) -> (scene)

Waits to see if it can find the cutscene specified.

:GetRunningCutscene _{CutsceneManager}

:GetRunningCutscene() -> (scene)

Returns the current running cutscene.

:Interrupt _{CutsceneManager}

:Interrupt(topic) -> ( {[topic] : cutscene} )

Stops the cutscene attached to the topic specified.

Scene

:Execute _Scene

:Execute(...) -> ()

Executes the cutscenes and gives the cutscene the arguments
given.

:Stop _Scene

:Stop() -> ()

Stops the cutscene if its playing.

:Close _Scene

:Close() -> ()

Closes the cutscene(this means that it cant get used again). It also removes
it from the storage container.

:IsClosed _Scene

:IsClosed() -> (bool)

Checks if the cutscene is closed or not.

Editor

:CreateCamera _Editor

:CreateCamera(cameraConfigurations) -> (Camera)

Creates a camera object with the specified camera configurations.
Here are all the configurations

local configurations : CutsceneManager.CameraConfigurations = {
	--// Required to fill in
	Destination = CFrame.new(0, 100, 0),
	CameraType = "Tween",
	
	--// Optinal to fill in
	Properties = {
		Duration = 5,
		RotateWithMove = false,
		EasingStyle = Enum.EasingStyle.Sine,
		EasingDirection = Enum.EasingDirection.In
	}
}

Learn about EasingStyle and EasingDirection here(click me)

:LockCharacter _Editor

:LockCharacter() -> ()

Anchored the player to the ground.

:UnLockCharacter _Editor

:UnLockCharacter() -> ()

UnAnchored the player.

LockMovement _Editor

:LockMovement() -> ()

Locks the player’s movement!

UnLockMovement _Editor

:UnLockMovement() -> ()

Unlocks the player’s movement!

MoveCharacterToLocation _Editor

:MoveCharacterToLocation(location) -> (RBXScriptSignal)

Forces the player to move to the specified location.

Jump _Editor

:Jump() -> ()

Forces the player to jump.

AjustFocus _Editor

:AjustFocus(object, focus) -> ()

Adds a blur behind the object making for a stylish effect.

:Start _Editor

:Start() -> ()

Makes the camera able to be modified.

:Finalise _Editor

:Finalise(cameraType, properties) -> ()

Finishes the cutscene and makes the camera not able to be modified

Camera

:Play _Camera

:Play(cameraType, properties) -> ()

Plays the camera and applies the properties.

:Stop _Camera

:Stop(cameraType, properties) -> ()

Stops the camera from completing.

Signals

Scene

.Stopped:Connect() _Scene

.Stopped:Connect(function()
	
end)

Fires when the cutscene is being stopped.

.Closing:Connect() _Scene

.Closing:Connect(function()
	
end)

Fires when the cutscene is closing.

.OnCutsceneEnded:Connect() _Scene

.OnCutsceneEnded:Connect(function(result, duration)
	
end)

Fires when the cutscene ends and returns a result and the duration

Camera

.Completed:Connect() _Camera

.Completed:Connect(function()
	
end

Fires when the camera completes.

BertNB · July 7, 2025, 8:03pm

Fantastic module! Thanks for making it lol, I was looking for a module that would assist with creating cutscenes and this fit the bill perfectly. Makes things a BUNCH easier.

rugg3344 · July 8, 2025, 6:55am

Thank you! If you have any issues or ideas — please leave a comment here! I will try to make the v2.1 better with hopefully new features and bug fixes — if needed!

BertNB · July 10, 2025, 8:51pm

Perhaps if it’s possible, add a variant of LockCharacter() that instead of anchoring the HumanoidRootPart, make it so that the player can’t move themselves but the script/cutscene manages where they go. E.g. For a cutscene where the player is walking into an elevator, the script can move the player but the player can’t move or anything to mess with the cutscene itself.

rugg3344 · July 11, 2025, 9:11pm

News

I’m excited to introduce version 2.1—possibly the biggest update in the 2.0 series of the module. This version brings several key features designed to help you with your cutscene development. Many of these features are just the beginning and will likely be refined and expanded in future updates.

Whats new?

Two new functions to lock and unlock player movement, giving you greater control and flexibility in your cutscenes.
New move and jump functions to make the player move and jump during scenes!
Presets have been added as a handy utility for your cutscenes. You can even submit your own here!
Added a new function called AdjustFocus in the Editor, allowing you to add or remove focus on a part. This adds a blur effect behind the part, creating a stylish look for your scene.
The OnCutsceneEnded signal now includes a duration argument, showing how long the cutscene lasted—potentially very useful during development.
Various bug fixes and improvements.

Note

As always, feedback is greatly appreciated so I know what to improve or add next!

Have a lovely day!

CutsceneManger 2.0 ━ Create and manage cutscenes in a clean and organised way

Previous version:

Testing

Demo place

Info

What is CutsceneManager?

Why use CutsceneManager?

What scenario can you use this?

How can i see what version im on?

Submit your own preset!

Versions:

What’s new?

New features

Important changes!

How to use it

Example script:

Methods

:CreateScene CutsceneManager

:Eliminate CutsceneManager

:GetCutscene CutsceneManager

:GetCutscenes CutsceneManager

:GetCutscenesFromCategory CutsceneManager

:GetCutsceneFromCategory CutsceneManager

:WaitForCutscene CutsceneManager

:GetRunningCutscene CutsceneManager

:Interrupt CutsceneManager

:Execute Scene

:Stop Scene

:Close Scene

:IsClosed Scene

:CreateCamera Editor

:LockCharacter Editor

:UnLockCharacter Editor

LockMovement Editor

UnLockMovement Editor

MoveCharacterToLocation Editor

Jump Editor

AjustFocus Editor

:Start Editor

:Finalise Editor

:Play Camera

:Stop Camera