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.

This page walks you through downloading Cinematics from its official Hangar page and dropping it into your Paper or Folia server. The entire process takes just a few minutes and requires no configuration editing — sensible defaults ship out of the box.
Cinematics requires Paper API 1.21 or newer. It will not load on Spigot or CraftBukkit because it relies on Paper-specific lifecycle events for command registration. Make sure your server software is Paper or Folia before proceeding.

​
Installation Steps

1

Check Requirements

Before downloading, confirm your environment meets the following requirements:
RequirementMinimum version
Server softwarePaper or Folia
Minecraft1.21.5 (1.21+ supported)
Java21 or newer
You can verify your Java version from the terminal:
java -version
And check your server version by running /version in-game or in the server console.
2

Download the JAR

Head to the official Hangar page for Cinematics:https://hangar.papermc.io/TheNextLvl-net/Cinematics
  1. Select the latest release from the version list.
  2. Under the Paper platform tab, click Download to save the cinematics-<version>.jar file to your computer.
Always download from the official Hangar page to ensure you get a verified, unmodified build.
3

Add to the Plugins Folder

Copy the downloaded .jar file into your server’s plugins/ directory:
# Example — adjust the path to match your server layout
cp cinematics-0.1.0.jar /path/to/your/server/plugins/
Your plugins/ folder should now contain the Cinematics JAR alongside any other installed plugins.
4

Start (or Restart) the Server

Cinematics registers itself during server startup (load order: STARTUP), so you need to start or fully restart your server — a /reload is not sufficient and may cause unexpected behaviour with Paper lifecycle events.
# Hard restart example (stop then start)
# In the server console:
stop
Then start the server again using your normal launch script or service manager. Watch the startup log for a confirmation line indicating the plugin loaded successfully.
5

Verify the Installation

Once the server is running, join and run the root command in-game:
/cinematic
If Cinematics is active, the command will be recognised by the server and you will see the command’s usage or help output. If the command is unknown, double-check that:
  • The JAR is present in plugins/ and was not corrupt during download.
  • Your server is running Paper or Folia 1.21+.
  • The server console did not log any errors for the Cinematics plugin during startup.
You can also confirm the plugin is loaded by running /plugins and looking for Cinematics in the list (shown in green when active).

​
No Additional Configuration Needed

Cinematics is designed to work immediately after installation. There are no mandatory configuration files to edit and no API keys to set up — just install the JAR and start recording. As the plugin matures, optional configuration options will be documented in the Plugin Configuration page.

​
Folia Support

Cinematics officially supports Folia, PaperMC’s regionised multi-threading fork. The installation process is identical — drop the same JAR into your Folia server’s plugins/ folder. No separate Folia build is required.

Build docs developers (and LLMs) love

Get started for freeTalk to us