# Create Cutscene at Position

Grammar — Create cutscene inFilePath|Cutscene at pos facing inFacing|Facing or players players|Player Group with autoplaying inAutoPlay
Flags — Native | Action

Cutscenes are built using the Cutscene Editor and saved to .SC2Cutscene files. They can describe a complicated cinematic or a simple conversation. This action allows you to play a cutscene at a specific position and facing. If you want the defaults, use Create Cutscene.WARNING: The Sound action Play Sound Scene File also accepts .SC2Cutscene files, but old-style scene files are not compatible with this action.

# Arguments

• string [ filepath ] — File Path
• point — Position
• fixed — Facing
• playergroup — Players
• bool — AutoPlay

Returns — int [ preset::Cutscene ]

native int CutsceneCreateNew(
	string inFilePath,
	point pos,
	fixed inFacing,
	playergroup players,
	bool inAutoPlay,
);

# Related

Category: Cutscene / Cutscenes

• [F] — int [ preset::Cutscene ] — Create Cutscene — ( CutsceneCreateNoPosition )
• [F] — int [ preset::Cutscene ] — Create Cutscene at Position — ( CutsceneCreateNew )
• [F] — void — Go To Next Cutscene Bookmark — ( CutsceneGoToNextBookmark )
• [F] — void — Cutscene EndScene Fired — ( TriggerAddEventCutsceneEndSceneFired )
• [F] — int [ preset::Cutscene ] — Create Cutscene — ( CutsceneCreate )
• [F] — int [ preset::Cutscene ] — Last Created Cutscene — ( CutsceneLastCreated )
• [F] — void — Play Cutscene — ( CutscenePlay )
• [F] — void — Pause Cutscene — ( CutscenePause )
• [F] — void — Stop Cutscene — ( CutsceneStop )
• [F] — void — Set Cutscene Time — ( CutsceneSetTime )
• [F] — void — Go To Cutscene Bookmark — ( CutsceneGoToBookmark )
• [F] — void — Show/Hide Cutscene — ( CutsceneShow )
• [F] — void — Play Cutscene Range Over Time — ( CutscenePlayCutsceneRangeOverTime )
• [F] — void — Cutscene Fade — ( CutsceneFade )
• [F] — int [ preset::Cutscene ] — Dialog Item Cutscene — ( CutsceneGetTriggerControl )
• [F] — void — Cutscene Bookmark Fired — ( TriggerAddEventCutsceneBookmarkFired )
• [F] — int [ preset::Cutscene ] — Triggering Cutscene — ( EventCutsceneId )
• [F] — string — Triggering Cutscene Bookmark — ( EventCutsceneBookmark )
• [F] — void — Wait For Cutscene To End — ( WaitForCutsceneToEnd )

# Examples

# campaigns/swarm.sc2campaign

— MapScript.galaxy

// L1000
CutsceneCreateNew("Cutscenes\\ZChar02CruiserLaunch.SC2Cutscene", libNtve_gf_PointFromXYZ(168.29, 65.25, 10.02), 0.0, PlayerGroupAll(), false)

// L1000
CutsceneCreateNew("Cutscenes\\ZChar02CruiserLaunch.SC2Cutscene", libNtve_gf_PointFromXYZ(168.29, 65.25, 10.02), 0.0, PlayerGroupAll(), false)

# campaigns/swarmstory.sc2campaign

— SwarmCampaignLib.galaxy

// L6698
CutsceneCreateNew(lp_file, lp_position, 0.0, PlayerGroupAll(), true)

// L8177
CutsceneCreateNew("Cutscenes\\StorymodeSet_EggRoom.SC2Cutscene", UnitGetPosition(libSwaC_gv_zS_ArmyCustomEggRoom), 0.0, PlayerGroupAll(), false)

// L8198
CutsceneCreateNew("Cutscenes\\StorymodeSet_EggRoom.SC2Cutscene", Point(50.0, 50.0), 0.0, PlayerGroupAll(), false)

// L8216
CutsceneCreateNew("Cutscenes\\StorymodeSet_EggRoom.SC2Cutscene", Point(50.0, 50.0), 0.0, PlayerGroupAll(), false)

// L9274
CutsceneCreateNew("Cutscenes\\Z_UI_SplitScreen.SC2Cutscene", libNtve_gf_PointWithZOffset(libSwaC_gv_center, libSwaC_gv_zSC_ARMYEVOLUTIONSETHEIGHT), 0.0, PlayerGroupAll(), false)

// L9304
CutsceneCreateNew("Cutscenes\\Z_UI_SplitScreenVictory.SC2Cutscene", libNtve_gf_PointWithZOffset(libSwaC_gv_center, libSwaC_gv_zSC_ARMYEVOLUTIONSETHEIGHT), 0.0, PlayerGroupAll(), false)

// L23541
CutsceneCreateNew(lv_file, lv_position, 0.0, PlayerGroupAll(), true)

# campaigns/swarmstoryutil.sc2mod

— Lib281DEC45.galaxy

// L2852
CutsceneCreateNew(lib281DEC45_gf_ZSS_SetLightingCutsceneFile(), lib281DEC45_gv_zSS_ConversationCutscenePosition, 0.0, PlayerGroupAll(), false)

// L2870
CutsceneCreateNew(lib281DEC45_gf_ZSS_SetLightingCutsceneFile(), lib281DEC45_gv_zSS_ConversationCutscenePosition, 0.0, PlayerGroupAll(), false)

// L3632
CutsceneCreateNew(UserDataGetString("AmbientScenes",lv_sceneinstance,"CutsceneFile",1), lib281DEC45_gv_zSS_ConversationCutscenePosition, 0.0, PlayerGroupAll(), false)

// L3911
CutsceneCreateNew("Cutscenes\\Conversations_EggRoom.SC2Cutscene", lib281DEC45_gv_zSS_EggRoomCutscenePosition, 0.0, PlayerGroupAll(), false)

// L3916
CutsceneCreateNew("Cutscenes\\Conversations_Char.SC2Cutscene", lib281DEC45_gv_zSS_ConversationCutscenePosition, 0.0, PlayerGroupAll(), false)

// L3919
CutsceneCreateNew("Cutscenes\\Conversations_Ice.SC2Cutscene", lib281DEC45_gv_zSS_ConversationCutscenePosition, 0.0, PlayerGroupAll(), false)

// L3922
CutsceneCreateNew("Cutscenes\\Conversations_Zerus.SC2Cutscene", lib281DEC45_gv_zSS_ConversationCutscenePosition, 0.0, PlayerGroupAll(), false)

// L3926
CutsceneCreateNew("Cutscenes\\Conversations_HybridB.SC2Cutscene", lib281DEC45_gv_zSS_ConversationCutscenePosition, 0.0, PlayerGroupAll(), false)

// L3929
CutsceneCreateNew("Cutscenes\\Conversations_Hybrid.SC2Cutscene", lib281DEC45_gv_zSS_ConversationCutscenePosition, 0.0, PlayerGroupAll(), false)

// L3934
CutsceneCreateNew("Cutscenes\\Conversations_Korhal.SC2Cutscene", lib281DEC45_gv_zSS_ConversationCutscenePosition, 0.0, PlayerGroupAll(), false)

# campaigns/voidstory.sc2campaign

— VoidCampaignLib.galaxy

// L4052
CutsceneCreateNew(lp_file, lp_position, 0.0, PlayerGroupAll(), true)

// L10036
CutsceneCreateNew(lv_file, lv_position, 0.0, PlayerGroupAll(), true)

# campaigns/voidstory.sc2campaign

— VoidCampaignStoryLib.galaxy

// L1328
CutsceneCreateNew(libVCST_gf_PS_SetLightingCutsceneFile(), libVCST_gv_pS_ConversationCutscenePosition, 0.0, PlayerGroupAll(), false)

// L1345
CutsceneCreateNew(libVCST_gf_PS_SetLightingCutsceneFile(), libVCST_gv_pS_ConversationCutscenePosition, 0.0, PlayerGroupAll(), false)

// L1907
CutsceneCreateNew(libVCST_gv_pS_RoomUISceneFiles[(libVCST_gf_CurrentRoom())], libVCST_gf_StoryModeDefaultPosition(), 0.0, PlayerGroupAll(), true)

// L2543
CutsceneCreateNew(lv_backgroundCutscene, libVCST_gf_StoryModeDefaultPosition(), 0.0, PlayerGroupAll(), true)

// L2916
CutsceneCreateNew(UserDataGetString("AmbientEvents",lp_ambientEvent,"CutsceneFile",1), libVCST_gv_pS_ConversationCutscenePosition, 0.0, PlayerGroupAll(), false)

// L3331
CutsceneCreateNew(libVCST_gv_pS_RoomConvoSceneFiles[(libVCST_gv_pS_CurrentRoom)], libVCST_gv_pS_ConversationCutscenePosition, 0.0, PlayerGroupAll(), false)

// L4552
CutsceneCreateNew(lp_cutscene, Point(64.0, 64.0), 0.0, PlayerGroupAll(), true)

# campaigns/voidstory.sc2campaign

— VoidCampaignUILib.galaxy

// L661
CutsceneCreateNew("Cutscenes\\UI_ArmyUnits.SC2Cutscene", libNtve_gf_PointFromXYZ(16.0, 16.0, 8.0), 0.0, PlayerGroupAll(), true)

// L2292
CutsceneCreateNew("Cutscenes\\UI_ShipUpgrade.SC2Cutscene", libNtve_gf_PointFromXYZ(16.0, 16.0, 8.0), 0.0, PlayerGroupAll(), true)

// L7350
CutsceneCreateNew("Cutscenes\\UI_MissionLaunch.SC2Cutscene", libNtve_gf_PointFromXYZ(16.0, 16.0, 32.0), 0.0, PlayerGroupAll(), false)

// L8616
CutsceneCreateNew("Cutscenes\\UI_Starmap.SC2Cutscene", libNtve_gf_PointFromXYZ(16.0, 16.0, 32.0), 0.0, PlayerGroupAll(), true)

# mods/heroesmapmods/battlegroundmapmods/battlefieldofeternity.stormmod

— LibMLBD.galaxy

// L140
CutsceneCreateNew("Cutscenes\\Storm_HvH_CS_EventStart.StormCutscene", libMLBD_gv_mMBOEBossSpawnLocationCenter, 0.0, PlayerGroupAll(), true)

// L146
CutsceneCreateNew("Cutscenes\\Storm_HvH_CS_EventMid.StormCutscene", libMLBD_gv_mMBOEBossSpawnLocationCenter, 0.0, PlayerGroupAll(), true)

// L152
CutsceneCreateNew("Cutscenes\\Storm_HvH_CS_EventEndHeaven.StormCutscene", lp_point, 45.0, PlayerGroupAll(), true)

// L158
CutsceneCreateNew("Cutscenes\\Storm_HvH_CS_EventEndHell.StormCutscene", lp_point, 315.0, PlayerGroupAll(), true)

# mods/missionpacks/campaigncommon.sc2mod

— LibComC.galaxy

// L1694
CutsceneCreateNew(lp_file, lp_position, 0.0, PlayerGroupAll(), true)

# mods/missionpacks/novacampaign.sc2mod

— LibNCST.galaxy

// L1214
CutsceneCreateNew(libNCST_gf_NS_SetLightingCutsceneFile(), libNCST_gv_nS_ConversationCutscenePosition, 0.0, PlayerGroupAll(), false)

// L1230
CutsceneCreateNew(libNCST_gf_NS_SetLightingCutsceneFile(), libNCST_gv_nS_ConversationCutscenePosition, 0.0, PlayerGroupAll(), false)

// L1713
CutsceneCreateNew(libNCST_gv_nS_RoomUISceneFiles[(libNCST_gf_CurrentRoom())], libNCST_gf_StoryModeDefaultPosition(), 0.0, PlayerGroupAll(), true)

// L2186
CutsceneCreateNew(lv_backgroundCutscene, libNCST_gf_StoryModeDefaultPosition(), 0.0, PlayerGroupAll(), true)

// L2564
CutsceneCreateNew(UserDataGetString("AmbientEvents",lp_ambientEvent,"CutsceneFile",1), libNCST_gv_nS_ConversationCutscenePosition, 0.0, PlayerGroupAll(), false)

// L2888
CutsceneCreateNew(libNCST_gv_nS_RoomConvoSceneFiles[(libNCST_gv_nS_CurrentRoom)], libNCST_gv_nS_ConversationCutscenePosition, 0.0, PlayerGroupAll(), false)

// L3899
CutsceneCreateNew(lp_cutscene, Point(64.0, 64.0), 0.0, PlayerGroupAll(), true)

# mods/voidprologue.sc2mod

— LibA3DDD02B.galaxy

// L5033
CutsceneCreateNew(lp_file, lp_position, 0.0, PlayerGroupAll(), true)