Cinematics ships with sensible defaults — no manual plugin.yml editing is required. This page documents the built-in settings for server administrators who need to understand how the plugin integrates with Paper/Folia.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.
Plugin Metadata
The following values are baked into the plugin at build time via thepaper block in build.gradle.kts. They are exposed to the server through the generated plugin.yml.
| Field | Value |
|---|---|
| Name | Cinematics |
| Version | 0.1.0 |
| Main class | net.thenextlvl.cinematics.CinematicsPlugin |
| API version | 1.21 |
| Load order | STARTUP |
| Folia support | Yes |
| Authors | NonSwag |
| Website | https://thenextlvl.net |
Permissions
Cinematics exposes a single permission node that guards every/cinematic sub-command. Assign it to any role or player you want to grant recording and playback access.
| Permission node | Description |
|---|---|
cinematics.command.cinematic | Grants access to all /cinematic commands (record, stop, play, etc.) |
Granting the permission with LuckPerms
Use the commands below to assign the permission to a specific player or to an entire group:<player> with the player’s username and <group> with your desired LuckPerms group name (e.g. admin, moderator, vip).
Load Order
The plugin declares a load order ofSTARTUP, which means Cinematics is initialised before any world has finished loading. This guarantees that:
- All
/cinematiccommands are registered and tab-completable as soon as a player joins. - Internal data structures are ready before any world-specific events are fired.
- No timing race conditions occur between Cinematics and plugins that depend on world state.
No configuration files are generated by the plugin at runtime in the current version — all configuration is handled via plugin.yml defaults and the messages bundle.