Skip to content

mission_task_cutscene

Source: base/tealdef/mission/tasks/cutscene/mission_task_cutscene.d.tl

Notes

Task that plays a camera cutscene.

MissionTaskCutscene

record global base/tealdef/mission/tasks/cutscene/mission_task_cutscene.d.tl:3

global record MissionTaskCutscene is MissionInterface.TaskScript<MissionTaskCutscene.State, MissionTaskCutscene.Params>

Load: local cutscene = ug_require "::/mission/tasks/cutscene/cutscene.tl"

Notes

Task (cutscene) that plays a cutscene file when it starts (api.gui.mission.playCutscene) and completes when the cutscene ends or is skipped. Tool actions are disabled meanwhile; afterwards the game speed is set to gameSpeed.

Example

-- urbangames_campaign_mission_01
if taskKey == "build_path_task_cutscene" then
    return {
        taskScript = cutscene as MissionInterface.TaskScript<any, any>,
        taskParams = { filePath = "urbangames_campaign_mission_01::/mission/keyframes/MISSION_01_CUTSCENE_BUILD_PATH.lua" },
        allowSimultaneousUiTasks = {
            mission_task_util.makeTaskKey("build_path_task", "urbangames_campaign_mission_01::/mission/mission.script")
        },
    }
end

MissionTaskCutscene.Params

record base/tealdef/mission/tasks/cutscene/mission_task_cutscene.d.tl:4

record Params

Notes

Params of the task.

Used in the base game: 2 times in 1 file

base/content/mission/mission/tasks/cutscene/cutscene.tl:3

local type P = MissionTaskCutscene.Params

Fields

Name Type Description
filePath string Keyframe file of the cutscene.
gameSpeed integer Game speed set when the cutscene is over (default 1).

Functions

getEntityToEntityMap(getTaskState : function(uniqueTaskKey : string) : MissionInterface.TaskState<any, any>) : {Engine.Entity : Engine.Entity} base/tealdef/mission/tasks/cutscene/mission_task_cutscene.d.tl:7

Notes

Returns a map that replaces entities of the cutscene file with runtime entities.

Parameter Type Description
getTaskState function(uniqueTaskKey : string) : MissionInterface.TaskState<any, any> Looks up a task by its unique key.

Returns {Engine.Entity : Engine.Entity}: Entity in the file -> entity to use.

MissionTaskCutscene.State

enum base/tealdef/mission/tasks/cutscene/mission_task_cutscene.d.tl:9

enum State

Notes

Playback state.

Used in the base game: 3 times in 1 file

base/content/mission/mission/tasks/cutscene/cutscene.tl:2

local type S = MissionTaskCutscene.State

Value Description
"Initial" Not started.
"Playing" Playing.
"Complete" Ended or skipped.