SkCine Documentation
Bring Your Skripts to Life.
Universal cinematic, animation, camera and storytelling capabilities designed as native-feeling extensions to Skript.
By DHeaven · API Design Specification v1.0 · Updated 2026-10-20
API status — PROPOSED, NOT IMPLEMENTED. SkCine is currently a design specification in this conversation; no built SkCine.jar or syntax registry was supplied. All SkCine-specific examples are intended API contracts, not verified runnable
.sk. Do not advertise these as tested until each example passes a real Skript reload and runtime test.
What is SkCine?
SkCine is the proposed Kotlin / Java 21 / Gradle Paper plugin that adds typed effects, expressions, conditions, events, and optional custom sections/structures to Minecraft Skript. Every scene is authored in .sk, never in a SkCine scene editor, YAML scene asset, or plugin command.
The complete intended workflow is install Skript + SkCine → create plugins/Skript/scripts/intro.sk → use SkCine syntax → /sk reload intro.
Feature coverage
| Engine | Author from Skript | Details |
|---|---|---|
| Scene lifecycle | Create, play, pause, resume, seek, skip, stop | Scenes and timelines |
| Cameras | Rail, orbit, look-at, track, shake | Camera guide |
| Actors | Existing mobs, temporary actors, audiences | Actors |
| Display entities | Transforms, scaling, rotations, groups | Display animation |
| Visual effects | Emitters, shapes, presets, budgets | Effects guide |
| Sound | Timeline cues, vanilla and custom IDs | Audio |
| Dialogue | Subtitle tracks, choices, branches | Dialogue |
| Multiplayer | Shared clocks and per-viewer output | Multiplayer |
| API contract | 100+ proposed syntax patterns | Effects reference and Syntax Index |
Start here
- Installation and compatibility
- Create your first cinematic
- Understand the object model
- Read the syntax conventions
- Browse the
.skexamples
Fundamental contract
A scene definition contains reusable tracks and configuration. A scene instance is one playback; variables, viewer state, and temporary entities belong to the instance. Never store temporary actor handles as permanent server data.
Verified upstream references
- Skript 2.17.0 release — Paper 1.21.5–26.3.
- Skript 2.16.2 release — Paper 1.21.4–26.2.
- Skript addon API and AddonModule.
- SyntaxRegistry.
- Paper Display API 1.21.11.
- PacketEvents dependency guidance.
These links verify upstream capabilities and version declarations, not the existence of SkCine syntax.