Documentation / Effect Reference
PROPOSED API
API specification — not a released addon. SkCine-specific syntax shown here is proposed and must be implemented and server-tested before use.

Effect Reference

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.

Catalog

65 proposed effect patterns. Patterns use placeholder types, not literal Skript source code.

ID Proposed syntax Purpose Return / notes
SKC-001 play cine scene %cinescene% for %players% Start independent or group playback Return instance using expression alternative
SKC-002 stop cine scene %cineinstance% Stop one playback and restore owned state Idempotent
SKC-003 skip cine scene %cineinstance% Skip to safe completion path Skippable policy
SKC-004 pause cine scene %cineinstance% Pause logical scene clock Preserve queued cues
SKC-005 resume cine scene %cineinstance% Resume paused playback No duplicate callbacks
SKC-006 restart cine scene %cineinstance% Restart from tick 0 Re-arm cosmetic cues only
SKC-007 seek cine scene %cineinstance% to %timespan% Jump to timestamp Cue skip policy
SKC-008 set cine duration of %cinescene% to %timespan% Set blueprint duration Mutable before registration/play
SKC-009 set cine skippable of %cinescene% to %boolean% Configure skip permission Boolean changer
SKC-010 set cine playback speed of %cineinstance% to %number% Slow/speed up playback Positive finite bounded
SKC-011 set cine scene variable %string% of %cineinstance% to %object% Per-instance typed variable Serializability constraints
SKC-012 clear cine scene variable %string% of %cineinstance% Unset instance variable No global storage effect
SKC-013 register cine scene %cinescene% Register named reusable blueprint Script ownership, duplicate checks
SKC-014 unregister cine scene %cinescene% Unregister script-owned definition Existing instances policy
SKC-044 set cine camera of %cinescene% to %cinecamera% Set scene camera track Build-time
SKC-045 add cine camera keyframe at %location% to %cinecamera% at %timespan% Add positional keyframe Interpolated
SKC-046 add cine look keyframe toward %location% to %cinecamera% at %timespan% Set look-at track keyframe Rotation independently interpolated
SKC-047 set cine easing of %cinecamera% to %string% Set path easing name Validate easing registry
SKC-048 set cine camera mode of %cinecamera% to %string% Select supported camera rig Capability check
SKC-049 set cine look target of %cinecamera% to %object% Track entity or location Track target validity
SKC-050 set cine orbit radius of %cinecamera% to %number% Set camera orbital radius Finite positive
SKC-051 set cine orbit angular speed of %cinecamera% to %number% Set angular degrees/sec Configured cap
SKC-052 attach cine camera %cinecamera% to %player% Take viewer camera ownership Preserve player state
SKC-053 restore cine camera of %player% Return vanilla camera Ownership-aware
SKC-054 shake cine camera of %cineinstance% with intensity %number% for %timespan% Add controlled camera shake Motion reduction support
SKC-055 transition cine camera of %cineinstance% to %cinecamera% over %timespan% Blend/route to another rig Backend aware
SKC-066 add cine marker %string% at %timespan% to %cinescene% Add timeline marker One-shot event
SKC-067 add cine timeline %cinetimeline% to %cinescene% Attach reusable timeline Validate cycles
SKC-068 add cine track %cinetrack% to %cinetimeline% Append typed track Type validation
SKC-069 set cine loop count of %cinetimeline% to %integer% Set bounded loop iterations >=0 config limit
SKC-070 set cine speed of %cinetimeline% to %number% Set timeline speed Positive finite
SKC-071 remove cine marker %string% from %cinescene% Delete a cue from blueprint Pre-play mutation only
SKC-078 add cine actor %cineactor% to %cinescene% Bind actor to scene Ownership check
SKC-079 add cine actor keyframe at %location% to %cineactor% at %timespan% Animate actor travel Interpolation
SKC-080 set cine actor name of %cineactor% to %string% Label actor Visual only
SKC-081 make cine actor %cineactor% face %location% Update look direction Rotational interpolation optional
SKC-082 show cine actor %cineactor% to %players% Audience visibility Backend aware
SKC-083 hide cine actor %cineactor% from %players% Hide for specified viewers Does not remove entity
SKC-084 remove cine actor %cineactor% Despawn owned actors only Borrowed entity never deleted
SKC-085 attach cine actor %cineactor% to %cineactor% Parent one actor to another Reject cycles
SKC-093 set cine scale of %cinedisplay% to %vector% Set display scale Finite components
SKC-094 animate cine scale of %cinedisplay% to %vector% over %timespan% using %string% Scale with easing Segment if needed
SKC-095 animate cine rotation of %cinedisplay% by %number% degrees over %timespan% Rotational animation Specify axis policy
SKC-096 add %cinedisplay% to cine display group %cinedisplaygroup% Add child display Detect duplicates
SKC-097 set cine pivot of %cinedisplaygroup% to %location% Pivot transform World consistency
SKC-098 animate cine group %cinedisplaygroup% to %location% over %timespan% Translate group Preserve relative offsets
SKC-104 play cine effect %string% at %location% for %players% Play named preset Budgeted output
SKC-105 set cine emitter radius of %cineemitter% to %number% Configure geometry Finite >=0
SKC-106 set cine emitter density of %cineemitter% to %integer% Configure count Resource cap
SKC-107 set cine emitter duration of %cineemitter% to %timespan% Duration Positive bounded
SKC-108 set cine particle type of %cineemitter% to %particle% Choose particle Alias version aware
SKC-109 add cine emitter %cineemitter% to %cinescene% at %timespan% Time-scheduled effect Owned emitter
SKC-110 stop cine emitter %cineemitter% Stop only this emitter Idempotent
SKC-111 add cine sound %string% at %timespan% to %cinescene% Schedule sound cue Namespaced ID
SKC-112 play cine sound %string% at %location% for %players% Play positioned sound Viewer filter
SKC-113 stop cine sounds of %cineinstance% Stop instance-owned audio Not unrelated server audio
SKC-114 set cine sound volume of %cinesound% to %number% Volume for cue Client limit
SKC-115 set cine sound pitch of %cinesound% to %number% Pitch for cue Client limit
SKC-116 add cine dialogue %string% at %timespan% to %cinescene% Subtitle/message cue Adventure formatting
SKC-117 set cine dialogue mode of %cinescene% to %string% Chat/title/actionbar/textdisplay Backend policy
SKC-118 set cine dialogue typing speed of %cinescene% to %integer% Typewriter chars per tick Rate cap
SKC-119 add cine choice %string% named %string% to %cinescene% at %timespan% Timed interactive choice ID + label
SKC-120 set cine choice timeout of %cinescene% to %timespan% Deadline for choice Defined default
SKC-121 advance cine dialogue of %cineinstance% Advance waiting dialogue Access control
SKC-122 cancel cine dialogue of %cineinstance% Stop waiting choice/dialogue Clear UI and timer

Placeholder convention

%cinescene%, %cineinstance%, %location%, etc. are documentation-level type placeholders. The implementation must translate them to real Skript parsers/types and test for collisions. See Syntax Conventions.

© 2026 DHeaven · SkCine documentation design · All scene authoring happens in Skript (.sk).