Expression 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

55 proposed expression patterns. Patterns use placeholder types, not literal Skript source code.

ID	Proposed syntax	Purpose	Return / notes
`SKC-015`	`new cine scene named %string%`	Construct a mutable definition	cinescene
`SKC-016`	`cine scene named %string%`	Lookup registered definition	cinescene or null
`SKC-017`	`play cine scene %cinescene% for %players%`	Start playback and obtain handle	cineinstance
`SKC-018`	`cine scene id of %cinescene%`	Read definition ID	string
`SKC-019`	`cine state of %cineinstance%`	Read lifecycle state	string/enum
`SKC-020`	`cine duration of %cinescene%`	Read authored duration	timespan
`SKC-021`	`cine elapsed time of %cineinstance%`	Current timeline tick/time	timespan
`SKC-022`	`cine remaining time of %cineinstance%`	Time to logical end	timespan
`SKC-023`	`cine progress of %cineinstance%`	Normalized playback 0..1	number
`SKC-024`	`cine playback speed of %cineinstance%`	Get playback speed	number
`SKC-025`	`cine viewers of %cineinstance%`	Current resolved viewers	players
`SKC-026`	`cine scene variable %string% of %cineinstance%`	Get instance state value	object
`SKC-027`	`current cine scene of %player%`	Current owned playback	cineinstance/null
`SKC-028`	`all running cine scenes`	Enumerate active instances	cineinstances
`SKC-034`	`new cine camera at %location%`	Construct camera definition	cinecamera
`SKC-035`	`cine camera of %cinescene%`	Get attached camera rig	cinecamera
`SKC-036`	`cine camera of %cineinstance%`	Get active instance camera	cinecamera
`SKC-037`	`cine camera position of %cinecamera%`	Camera path current/base position	location
`SKC-038`	`cine camera mode of %cinecamera%`	Camera backend style	string/enum
`SKC-039`	`cine look target of %cinecamera%`	Look-at location/entity	object
`SKC-040`	`cine camera path of %cinecamera%`	Read sorted keyframes	cinekeyframes
`SKC-041`	`cine easing of %cinecamera%`	Read interpolation curve	string/enum
`SKC-042`	`current cine camera of %player%`	Get viewer camera handle	cinecamera/null
`SKC-043`	`cine camera backend of %player%`	Active backend label	string
`SKC-059`	`new cine timeline named %string%`	Construct reusable timeline	cinetimeline
`SKC-060`	`cine timeline of %cinescene%`	Get scene timeline	cinetimeline
`SKC-061`	`cine markers of %cinescene%`	Enumerate cue markers	strings
`SKC-062`	`cine current marker of %cineinstance%`	Last reached marker	string/null
`SKC-063`	`cine keyframes of %cinetrack%`	Sorted track keyframes	cinekeyframes
`SKC-064`	`cine tracks of %cinescene%`	Read tracks	cinetracks
`SKC-065`	`cine easing value %number% using %string%`	Evaluate named normalized curve	number
`SKC-072`	`new cine actor from %entity%`	Wrap an existing entity	cineactor borrowed owner
`SKC-073`	`new temporary cine actor of type %entitytype% at %location%`	Spawn owned actor	cineactor
`SKC-074`	`cine actor named %string% in %cineinstance%`	Lookup owned actor	cineactor/null
`SKC-075`	`cine actor entity of %cineactor%`	Underlying Bukkit entity, if any	entity/null
`SKC-076`	`cine actor location of %cineactor%`	Position at current timeline	location
`SKC-077`	`cine actor owner of %cineactor%`	Ownership category	string/enum
`SKC-088`	`new cine display actor from %displayentity%`	Wrap block/item/text display	cinedisplay
`SKC-089`	`new cine display group named %string%`	New group of displays	cinedisplaygroup
`SKC-090`	`cine pivot of %cinedisplaygroup%`	Get group pivot	location
`SKC-091`	`cine scale of %cinedisplay%`	Read current display scale	vector
`SKC-092`	`cine display children of %cinedisplaygroup%`	Group members	cinedisplays
`SKC-099`	`new cine particle emitter %string% at %location%`	Create named shape emitter	cineemitter
`SKC-100`	`cine emitter radius of %cineemitter%`	Read geometry radius	number
`SKC-101`	`cine emitter density of %cineemitter%`	Read particle count setting	integer
`SKC-102`	`cine emitter audience of %cineemitter%`	Read audience	cineaudience
`SKC-103`	`cine effect preset %string%`	Lookup preset definition	cineeffect/null
`SKC-123`	`cine current dialogue of %cineinstance%`	Currently visible line	cinedialogue/null
`SKC-124`	`cine dialogue mode of %cinescene%`	Presentation mode	string/enum
`SKC-125`	`cine pending choices of %cineinstance%`	Outstanding choices	cinechoices
`SKC-126`	`skcine version`	Plugin version string	string
`SKC-127`	`skcine capabilities`	Supported feature identifiers	strings
`SKC-128`	`skcine active scene count`	Number of active instances	integer
`SKC-129`	`skcine camera backend of %player%`	Resolved camera backend	string
`SKC-130`	`skcine profiler update time`	Last measured scheduler cost	timespan/number

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.