BIS fnc endMission: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "<code>(\[?[^\[]+\]?) *(\[\[)?(call|spawn)(\]\])? *(\[\[)?(BI(N|S)_fnc_[a-zA-Z0-9_]+)(\]\])?;?<\/code>" to "<sqf>$1 $3 $6;</sqf>")
m (Some wiki formatting)
Line 31: Line 31:
|r1= [[Boolean]]
|r1= [[Boolean]]


|x1= <code>["mission2", 1, "You won"] [[call]] [[BIS_fnc_endMission]]; {{cc|[[endMission]] "mission2_1"}}</code>
|x1= <sqf>["mission2", 1, "You won"] call BIS_fnc_endMission; // endMission "mission2_1"</sqf>


|x2= <code>["mission2", 1, "You lose", [[false]]] [[call]] [[BIS_fnc_endMission]]; {{cc|[[failMission]] "mission2_1"}}</code>
|x2= <sqf>["mission2", 1, "You lose", false] call BIS_fnc_endMission; // failMission "mission2_1"</sqf>


|seealso= [[Debriefing]] [[endMission]] [[failMission]]
|seealso= [[Debriefing]] [[endMission]] [[failMission]]
Line 71: Line 71:
|x1= <sqf>"end1" call BIS_fnc_endMission;</sqf>
|x1= <sqf>"end1" call BIS_fnc_endMission;</sqf>


|x2= <code>["epicFail", [[false]], 2] [[call]] [[BIS_fnc_endMission]];</code>
|x2= <sqf>["epicFail", false, 2] call BIS_fnc_endMission;</sqf>


|seealso= [[BIS_fnc_endMissionServer]] [[Debriefing]] [[endMission]] [[markAsFinishedOnSteam]]
|seealso= [[BIS_fnc_endMissionServer]] [[Debriefing]] [[endMission]] [[markAsFinishedOnSteam]]
Line 78: Line 78:
}}
}}


<dl class="command_description">
{{Note
 
|user= R3vo
<dt></dt>
|timestamp= 20160321111200
<dd class="notedate">Posted on March 21, 2016 - 11:12 (UTC)</dd>
|text= To end a multiplayer mission one can use {{ic|["end1", [[true]]] [[remoteExecCall]] ["[[BIS_fnc_endMission]]"];}} - see also [[BIS_fnc_endMissionServer]].
<dt class="note">[[User:R3vo|R3vo]]</dt>
}}
<dd class="note">To end a multiplayer mission one can use {{ic|["end1", [[true]]] [[remoteExecCall]] ["[[BIS_fnc_endMission]]", 0];}} - see also [[BIS_fnc_endMissionServer]].</dd>
 
</dl>

Revision as of 14:30, 1 July 2022

tkoh logo small.png Take On Helicopters
Arma 3 logo black.png Arma 3
Hover & click on the images for description

Description

Description:
Ends mission with the specified ending. Always ends with a 4 seconds black out effect.
nextMission and endingId parameters are assembled together to define which ending is called, in format nextMission_endType.
Execution:
call
Groups:
Missions

Syntax

Syntax:
[nextMission, endingId, displayText, isSuccess, code] call BIS_fnc_endMission
Parameters:
nextMission: String - (Optional, default worldName)
endingId: Number - (Optional, default 1)
displayText: String - (Optional, default "") text displayed on black out
isSuccess: Boolean - (Optional, default true) true to endMission, false to failMission
successCode: Code - code executed right before mission ends, only if isSuccess is set to true
Return Value:
Boolean

Examples

Example 1:
["mission2", 1, "You won"] call BIS_fnc_endMission; // endMission "mission2_1"
Example 2:
["mission2", 1, "You lose", false] call BIS_fnc_endMission; // failMission "mission2_1"

Additional Information

See also:
Debriefing endMission failMission

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
Hover & click on the images for description

Description

Description:
Ends mission with a signature shot or a fade effect, marks it finished for Steam and activates a key in format activateKey format ["BIS_%1.%2_done", missionName, worldName];.
This function should always be used instead of the simple endMission/failMission commands or trigger endings; otherwise, singleplayer scenarios will not properly be marked as played/finished in the game and on Steam!
Execution:
call
Groups:
Missions

Syntax

Syntax:
[endName, isVictory, fadeType, playMusic, cancelTasks] call BIS_fnc_endMission
Parameters:
endName (Optional, default "end1"):
isVictory: Boolean - (Optional, default true) true for successful end, false for failed end
fadeType: Boolean or Number - (Optional, default true) true for signature closing shot. When number, simple fade to black of given duration is used
playMusic: Boolean - (Optional, default true) False to disable automatic music during closing shot
cancelTasks: (Optional, default false): Boolean - true to cancel all pending tasks
Return Value:
Boolean

Examples

Example 1:
"end1" call BIS_fnc_endMission;
Example 2:
["epicFail", false, 2] call BIS_fnc_endMission;

Additional Information

See also:
BIS_fnc_endMissionServer Debriefing endMission markAsFinishedOnSteam

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
R3vo - c
Posted on Mar 21, 2016 - 11:12 (UTC)
To end a multiplayer mission one can use ["end1", true] remoteExecCall ["BIS_fnc_endMission"]; - see also BIS_fnc_endMissionServer.