After spending a lot of time debugging my mod, I realized that it is false. Cancelling a cue with <cancel_cue> also cancels all its sub-cues with all their instances.Cancelling a cue with <cancel_cue> also cancels all its sub-cues, and cancelling a static cue stops it from instantiating more cues - but it does not cancel its instances.
Question: Is this by design or is there another use case (if the documentation is correct)?
I wrote following test example:
Code: Select all
<cue name="Demo1">
<delay exact="1ms" />
<actions>
<signal_cue cue="Demo2" />
</actions>
<delay exact="1s" />
<actions>
<cancel_cue cue="this" />
</actions>
<cues>
<cue name="Demo2" instantiate="true">
<conditions>
<event_cue_signalled />
</conditions>
<actions>
<debug_text text="'Active Demo2'" />
</actions>
<delay exact="10s" />
<actions>
<signal_cue cue="Demo3" />
</actions>
<cues>
<cue name="Demo3">
<conditions>
<event_cue_signalled />
</conditions>
<actions>
<debug_text text="'Active Demo3'" />
</actions>
</cue>
</cues>
</cue>
</cues>
</cue>
Code: Select all
[Scripts] 73920.78 *** Context:md.TFDronesLogic.Demo2<inst:4855b1b>: Active Demo2
Code: Select all
<cue id="68368" name="Demo1" state="cancelled" index="1">
<cue id="68369" name="Demo2" state="cancelled">
<cue id="68370" name="Demo3" state="cancelled" />
</cue>
</cue>
I commented out the <cancel_cue> action and ran example again.
Debug log and savegame after 2 sec (before activation of Demo3).
Code: Select all
[Scripts] 73920.73 *** Context:md.TFDronesLogic.Demo2<inst:601f11d>: Active Demo2
Code: Select all
<cue id="68380" name="Demo1" state="complete" time="73920.732" index="1">
<cue id="68381" name="Demo2" state="waiting">
<cue id="68382" name="Demo3" />
<instances>
<cue id="68431" state="active" time="73920.732" index="1">
<event name="event_cue_signalled">
<object type="cue" value="68381" />
</event>
<cue id="68432" base="68382" state="waiting" />
</cue>
</instances>
</cue>
</cue>
Code: Select all
[Scripts] 73920.73 *** Context:md.TFDronesLogic.Demo2<inst:601f11d>: Active Demo2
[Scripts] 73930.77 *** Context:md.TFDronesLogic.Demo3<inst:601ed13>: Active Demo3
Code: Select all
<cue id="68374" name="Demo1" state="complete" time="73920.732" index="1">
<cue id="68375" name="Demo2" state="waiting">
<cue id="68376" name="Demo3" />
</cue>
</cue>