Kinematic 🎬

Film-grade virtual cinematography and AFK choreography for Minecraft 26.3 on Fabric.

Kinematic replaces boring turntable AFK orbits with an intelligent virtual cinematography director. Built natively for Minecraft 26.3 on Fabric, it dynamically directs your game with Dutch camera tilts, telephoto compression, curated atmospheric music, and zero-jitter mathematical camera choreography.

Inspired by professional film rigs and automotive videography, Kinematic choreographs sweeping low-angle passes, overhead canopy drifts, and stylized Dutch tilts that make your character and surroundings look like a movie trailer.

✨ Key Features

🎥 18 Curated Cinematic Choreographies

A complete library of 18 distinct shots modeled after real-world camera rigs:

• Dutch Helmet Close-Up: Extreme 36° to 44° Dutch tilt with telephoto compression framing the player's helmet.
• Low Canopy Upward Sweep: Ground-level slider tracking forward while tilting up into the trees and sky.
• Car Roller Pass: Automotive tarmac roller tracking beside the player with a 24° banked tilt.
• Russian Arm Crane: Parabolic crane dive with smooth inverted roll from -18° to +22°.
• Elevated 360° Orbit: High 40° downward orbital sweep with constant cinematic velocity.
• Automotive Hero Stance: Supercar-style low bumper push-in with -16.5° Dutch angle.
• FPV Inward Drift Orbit: Fast banked inward curve hugging the player's profile.
• Foliage Peeker: Chest-level linear dolly looking past foreground leaves and grass.
• Landscape Establishing Dolly: Distant lateral tracking shot emphasizing terrain depth.
• Vertical Canopy Reveal: Upward skyward jib tilt showcasing towering structures and skies.
• Over-the-Shoulder Narrative: Horizon-facing rule-of-thirds narrative composition.
• Slow Dramatic Push-In: 50mm cinematic hero push with subtle leveling.
• High Overhead Crane Drift: Bird's-eye architectural drift angling downward.
• Dynamic Whip Pan: High-speed counter-banking flyby.
• Ground Horizon Pan: 0.35m ground-level lateral dolly tracking the silhouette against the horizon.
• Telephoto Parallax Track: 34° narrow-lens distant tracking creating intense background depth parallax.
• Vertical Jib Pedestal: Pure vertical crane rising from boots (0.15m) to above helmet (2.35m) with roll inversion.
• Low Swoop Curve: Commercial-style parabolic curve banking dynamically (up to 24° roll) around the front corner.

🎲 Non-Repeating Random Director

Shots are queued using a non-repeating shuffled deck algorithm. Every shot in the library is played in randomized order, ensuring fresh perspectives and zero back-to-back duplicates.

✂️ Instant Hard Cuts ("Teleport Transitions")

Features instant hard cuts between shots (default 0.0s transition) just like professional music and cinematic video edits, eliminating awkward cross-blends and whip kicks.

🎵 Curated Atmospheric Music Fade-In

When cinematic mode begins, Kinematic smoothly fades in Minecraft's top atmospheric soundtrack pieces using a cubic volume curve over 2.5 seconds:

• Available tracks: relic, creator, otherside, strad, wait, far, creative, precipice, or random (picks a different atmospheric track each time).
• Easily toggled on/off or customized directly via in-game commands.

🚫 Automatic Hand & HUD Suppression (Auto-F1)

• Automatically hides all HUD elements (hotbar, crosshairs, chat, status icons) without altering your vanilla F1 state.
• Suppresses first-person hands and held items while the cinematic camera is rolling.
• Everything is instantly restored the moment you move your mouse or press a key.

🧱 Smart Clearance Engine

Built-in voxel raycasting analyzes surrounding blocks in real-time. Kinematic never clips into walls, avoids tight indoor ceilings, and ignores non-solid foliage so camera motion stays glass-smooth.

⚡ Instant Wake & Combat Safety

• Zero Input Delay: Touching any key, moving your mouse, or scrolling instantly returns you to normal first-person gameplay with zero latency.
• Damage Abort: Automatically cancels cinematic mode immediately if your character takes damage from mobs, players, or the environment.

🎮 Controls & Shortcuts

• F8: Toggle Cinematic Mode on/off manually anytime
• N: Skip directly to the next random shot
• /kinematic help: Display full in-game command reference and current settings
• /kinematic start: Immediately start cinematic mode
• /kinematic stop: Exit cinematic mode back to normal gameplay
• /kinematic toggle: Toggle cinematic mode on/off
• /kinematic next: Switch to the next shot angle
• /kinematic time <seconds>: Set AFK trigger delay (Default: 300s / 5 minutes)
• /kinematic shotduration <seconds>: Set duration for each shot (Default: 15.0s)
• /kinematic transition <seconds>: Set transition mode (0 = instant hard cut)
• /kinematic music: Toggle background music fade-in on/off
• /kinematic track <name>: Select active music track (random, relic, otherside, etc.)
• /kinematic reload: Reload configuration from disk

⚙️ Configuration

Settings are saved in .minecraft/config/kinematic.json:

{
  "enabled": true,
  "afkTimeoutSeconds": 300,
  "shotDurationSeconds": 15.0,
  "transitionDurationSeconds": 0.0,
  "exitTransitionDurationSeconds": 0.0,
  "cinematicLetterbox": true,
  "letterboxAspect": 2.39,
  "hideHud": true,
  "cameraRoll": true,
  "dynamicFov": true,
  "cameraSpeed": 1.0,
  "cancelOnDamage": true,
  "safeClearance": true,
  "showTitle": true,
  "playMusic": true,
  "musicTrack": "random",
  "stopMusicOnExit": false
}