Skip to content

mission_task_store_any

Source: base/tealdef/mission/tasks/utility/mission_task_store_any.d.tl

Notes

Task that stores a value computed at runtime for other tasks to read.

MissionTaskStoreAny

record global base/tealdef/mission/tasks/utility/mission_task_store_any.d.tl:3

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

Load: local store_any = ug_require "::/mission/tasks/utility/store_any.tl" as MissionTaskStoreAny

Notes

Task (store_any) that stores the first non-nil result of storeFn in its state and then completes. Other tasks read it through getTaskState(key).specific.data.

Details

Use MissionTaskStoreEntity for entities: it survives the engine swapping entity ids.

MissionTaskStoreAny.Params

record base/tealdef/mission/tasks/utility/mission_task_store_any.d.tl:4

record Params

Notes

Params of the task.

Used in the base game: 8 times in 5 files

base/content/mission/mission/tasks/utility/store_any.tl:3 

local type P = MissionTaskStoreAny.Params
base/content/mission/mission/tutorial/tutorial_story_branch_a.tl:41 
local storeAny = task as MissionInterface.TaskState<MissionTaskStoreAny.State, MissionTaskStoreAny.Params>
base/content/mission/mission/tutorial/tutorial_story_branch_b.tl:41 
local storeAny = task as MissionInterface.TaskState<MissionTaskStoreAny.State, MissionTaskStoreAny.Params>
base/content/mission/mission/tutorial/tutorial_story_util.tl:176 
local storeAny = task as MissionInterface.TaskState<MissionTaskStoreAny.State, MissionTaskStoreAny.Params>
mods/release/urbangames_campaign_mission_01/content/mission/mission/mission_story.tl:1562 
local storeAny = getTaskState("store_decision") as MissionInterface.TaskState<MissionTaskStoreAny.State, MissionTaskStoreAny.Params>

Functions

storeFn(readOnlyApi : MissionInterface.MissionTaskReadOnlyApi) : any base/tealdef/mission/tasks/utility/mission_task_store_any.d.tl:5

Notes

Computes the value to store; called every update until it returns a value.

Parameter Type Description
readOnlyApi MissionInterface.MissionTaskReadOnlyApi Read-only mission API.

Returns any: Value to store, or nil to try again.

MissionTaskStoreAny.State

record base/tealdef/mission/tasks/utility/mission_task_store_any.d.tl:7

record State

Notes

State of the task.

Used in the base game: 12 times in 6 files

base/content/mission/mission/tasks/utility/store_any.tl:2 

local type S = MissionTaskStoreAny.State
base/content/mission/mission/tasks/utility/store_entity.tl:54 
if (ctx.state as MissionTaskStoreAny.State).data ~= nil and type((ctx.state as MissionTaskStoreAny.State).data) == "number" then
base/content/mission/mission/tutorial/tutorial_story_branch_a.tl:41 
local storeAny = task as MissionInterface.TaskState<MissionTaskStoreAny.State, MissionTaskStoreAny.Params>
base/content/mission/mission/tutorial/tutorial_story_branch_b.tl:41 
local storeAny = task as MissionInterface.TaskState<MissionTaskStoreAny.State, MissionTaskStoreAny.Params>
base/content/mission/mission/tutorial/tutorial_story_util.tl:176 
local storeAny = task as MissionInterface.TaskState<MissionTaskStoreAny.State, MissionTaskStoreAny.Params>
mods/release/urbangames_campaign_mission_01/content/mission/mission/mission_story.tl:1562 
local storeAny = getTaskState("store_decision") as MissionInterface.TaskState<MissionTaskStoreAny.State, MissionTaskStoreAny.Params>

Fields

Name Type Description
data any Stored value.
waitForEngineSwap boolean Delays completion by one update after the value was stored.