Lumiera

Lumiera is a cinematic camera and cutscene mod for Minecraft. Build camera shots from keyframes in an in-game timeline, add cues like fades, sound, and screen shake, then play the whole thing back from a key, a command, or a datapack.

Features

• Keyframe camera shots in a timeline editor and scrub or preview them live.
• Several ways to move between keyframes: straight lines, Catmull-Rom, Bezier with handles, cosine, and stepped holds. Centripetal Catmull-Rom is the safe pick for most shots since it won't loop on sharp turns.
• Per-segment easing, from plain ease in/out to the quad, cubic, sine, expo, back, elastic, and bounce curves, for control over timing.
• Animate FOV and roll per keyframe, bank the camera into turns, or have it follow an entity or a fixed point.
• A per-world library for saving, renaming, duplicating, and deleting your paths and cutscenes.

Cutscene cues

Camera paths can carry timed events that fire as they play:

• Fades and letterbox bars
• On-screen text and action bar messages
• Sound and particle cues, placed in the world or pinned to the camera
• Screen shake with adjustable intensity, frequency, and decay
• Hide or show the HUD, lock or restore the time of day
• Run a command at any point on the timeline

On 1.21.1 you can also stage actors: entities, players, items, blocks, armor stands, or particles. Each gets its own pose keyframes and a track of timed actions like swinging, jumping, attacking, breaking a block, dying, or playing a sound.

Creating shots in-game

Open the timeline with G. Move your camera and press = to drop a keyframe, scrub the timeline, then press [ to preview. Every key is listed under Controls and can be rebound:

• G timeline, . edit mode, , view mode
• = add keyframe, Delete remove, K duplicate
• [ play, End reset, M library

Commands cover the same ground for servers and command blocks:

• /lumiera play <name> [speed] [loop] [target]
• /lumiera stop and /lumiera reset
• /lumiera list and /lumiera info <name>
• /lumiera save <name> and /lumiera load_here <name>
• /lumiera import and /lumiera export

On NeoForge, /cutscene play <id> [targets] [anchor] runs cutscenes loaded from datapacks.

Datapacks

Map makers can ship cutscenes as JSON under data/<namespace>/cutscenes/. A short one:

{
  "schema": 1,
  "id": "intro",
  "duration_ticks": 40,
  "fov": { "mode": "keyframed", "default": 90.0 },
  "keyframes": [
    { "time": 0.0, "pos": { "x": 0, "y": 65, "z": 0 }, "rot": { "yaw": 0, "pitch": 0 }, "fov": 90.0, "path_type": "linear" },
    { "time": 2.0, "pos": { "x": 8, "y": 67, "z": 4 }, "rot": { "yaw": -30, "pitch": 10 }, "fov": 70.0, "path_type": "smooth" }
  ],
  "camera_position_mode": "absolute"
}

Camera paths under data/<namespace>/camera_paths/ take an events list for the cues above. Times can be given as tick, time, or at (seconds), and event types accept namespaced ids like lumiera:shake_camera.

For developers

Lumiera exposes a camera modifier API so other mods can drive the camera without fighting over it. Modifiers stack by priority with a separate background layer, so one mod's cutscene won't stomp another's. A small runtime API starts and stops cutscenes by id.

Supported versions

• Minecraft 1.21.1 on NeoForge

Other Minecraft versions are in progress.