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.
Cinematics uses a properties-file i18n system (the net.thenextlvl:i18n library). All player-facing messages are defined in cinematics.properties and can be overridden per language by providing an appropriately named properties file alongside the plugin’s data folder.
Default Message Keys
The table below lists every key shipped in the default English bundle (cinematics.properties).
| Key | Default (English) | Description |
|---|
prefix | <blue>Cinematics</blue> <dark_gray>»</dark_gray> | Prefix prepended to all plugin messages |
record-not-found | <gray><prefix> A record with this name does not exist</gray> | Shown when a named recording does not exist |
recording-error | <red><prefix> An error has occurred while recording</red> | Shown when recording fails unexpectedly |
recording-saved | <gray><prefix> Saved recording <green><recording></green></gray> | Shown when a recording is saved; <recording> is replaced with the name |
recording-stopped | <gray><prefix> Stopped the recording</gray> | Shown when recording stops without saving |
Included Locales
Cinematics ships with two locale bundles out of the box:
- English (
cinematics.properties) — the default fallback locale used when no matching locale file is found.
- German (
cinematics_german.properties) — a full German translation of every message key.
German bundle (cinematics_german.properties)
# cinematics_german.properties
record-not-found=<gray><prefix> Es existiert keine Aufnahme mit diesem Namen</gray>
recording-error=<red><prefix> Während der Aufnahme ist ein Fehler aufgetreten</red>
recording-saved=<gray><prefix> Die Aufnahme <green><recording></green> wurde gespeichert</gray>
recording-stopped=<gray><prefix> Die Aufnahme wurde gestoppt</gray>
| Tag | Effect |
|---|
<blue> | Renders text in blue |
<gray> | Renders text in gray |
<red> | Renders text in red |
<green> | Renders text in green |
<dark_gray> | Renders text in dark gray |
<prefix> tag is not a standard MiniMessage tag — it is a placeholder that the plugin resolves at runtime by substituting the value of the prefix key before parsing the final component tree. This means any changes you make to the prefix key are automatically reflected in every other message.
For the full MiniMessage syntax reference, see the official Adventure documentation.
Placeholders
Some messages contain dynamic placeholders that the plugin replaces with runtime values before displaying the message to the player.
| Placeholder | Replaced with | Used in |
|---|
<recording> | The name of the recording being saved | recording-saved |
<prefix> | The fully-rendered value of the prefix key | All non-prefix keys |
To customise messages without modifying the JAR, place an overriding cinematics.properties file in the plugin’s data folder on the server and restart. Only the keys you include in the override file will change — any key you omit will continue to use the built-in default.