Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/TheNextLvl-net/cinematics/llms.txt

Use this file to discover all available pages before exploring further.

In this guide you will record a camera path, confirm it saved correctly, and play it back as a smooth cinematic transition — all without leaving Minecraft. By the end you will have a working recording you can trigger whenever you like.
Record in a Creative or Spectator world for the smoothest, most cinematic paths. You will be free from block collisions and gravity, letting you glide through the air and frame every angle exactly as you want it.

​
Steps

1

Grant the Required Permission

All /cinematic subcommands are gated behind the cinematics.command.cinematic permission node. Grant it to yourself before proceeding.Using LuckPerms (recommended):
/lp user <yourUsername> permission set cinematics.command.cinematic true
Using OP (quick test only):
/op <yourUsername>
Operators have all permissions by default, so this works for quick testing on a private server. For production environments, use a dedicated permissions plugin like LuckPerms.
2

Start Recording

Choose a name for your recording — something descriptive works best (no spaces). Then run:
/cinematic record my-intro
Once the command is accepted, Cinematics begins capturing your position and view angle as a sequence of frames. Move naturally — walk, fly, pan the camera left and right, look up and down. Every position and orientation you pass through becomes part of the recorded path.Some tips for great recordings:
  • Move at a consistent, deliberate pace — sudden sprints create jarring jumps.
  • Use Spectator mode to fly through walls or hover above builds for dramatic establishing shots.
  • Plan your path before recording: walk it once without recording to get a feel for the flow.
3

Stop Recording

When you have finished tracing your path, run the same command again to stop:
/cinematic record my-intro
Cinematics will stop capturing frames, serialise the recording, and save it to disk. A confirmation message will appear in chat indicating the recording was saved successfully.
4

Verify the Recording

Confirm the recording was persisted correctly with two commands:
/cinematic list
This prints all saved recordings. You should see my-intro in the list.
/cinematic info my-intro
This displays metadata for the recording, including the name, frame count (the number of captured positions), and file size on disk. Use this to sanity-check that the recording captured the full path — a very low frame count may indicate you stopped too soon.
5

Play It Back

You are ready to experience the cinematic. Run:
/cinematic play my-intro
The camera will smoothly transition along your recorded path. Sit back and enjoy the result — if anything feels off, simply delete the recording and try again:
/cinematic delete my-intro

​
Full Command Sequence

Here is the complete sequence from start to finish for quick reference: 
/cinematic record my-intro
# ... walk and look around to capture the path ...
/cinematic record my-intro   # run again to stop recording
/cinematic list
/cinematic info my-intro
/cinematic play my-intro

​
What’s Next?

Now that you have your first recording, explore the full command reference and learn how to fine-tune the plugin’s behaviour.

Commands Overview

A full reference for every /cinematic subcommand, its arguments, and permission nodes.

Plugin Configuration

Explore the plugin.yml settings and understand how Cinematics registers itself on your server.

Build docs developers (and LLMs) love

Get started for freeTalk to us