setDebriefingText: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "{{Command " to "{{RV|type=command ")
m (Some wiki formatting)
 
(37 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{RV|type=command
{{RV|type=command


| arma3
|game1= arma3
|version1= 0.50


|0.50
|gr1= Briefing


|gr1= Broken Commands
|descr= Sets debriefing title, text, subtitle, picture and background for a mission ending.
The end type could be the engine-defined ("CONTINUE", "KILLED", "LOSER", "END1", "END2", "END3", "END4", "END5", "END6"), config-defined (see [[Debriefing#Configuration|CfgDebriefing]]) or, with an alternative syntax of this command, any [[String]].
Given texts will be used to replace the corresponding texts on the debriefing screen.


|gr2= Briefing
{{Feature|important|In order to benefit from alternative syntax functionality, there will have to be at least '''three''' arguments passed to the command; '''two''' arguments will trigger the old behaviour.}}
[[File:endMission.jpg|400px]] [[File:failMission.jpg|400px]]


| Sets debriefing text for endType defined in [[Debriefing#Configuration|CfgDebriefing]].
|s1= endType [[setDebriefingText]] [title, description]
<br><br>
{{Warning | This command is broken. https://feedback.bistudio.com/T85682 }}


| endType '''setDebriefingText''' [title, description]
|p1= endType: [[String]] - engine type


|p1= endType: [[String]]
|p2= title: [[String]] - title text on the debriefing screen


|p2= [title, description]: [[Array]]
|p3= description: [[String]] - description text on the debriefing screen


|p3= title: [[String]]
|r1= [[Nothing]]


|p4= description: [[String]]
|s2= endType [[setDebriefingText]] [title, description, subtitle, picture, background]


| [[Nothing]]
|s2since= arma3 2.06


|x1= <code>_currentObjective = ([[taskDescription]] ([[currentTask]] [[player]])) [[select]] 2;
|p21= endType: [[String]] - any name
"endDeath" [[setDebriefingText]] ["You Lose","All of your men were killed while assaulting the " + _currentObjective];</code>


| [[debriefingText]], [[disableDebriefingStats]], [[enableDebriefingStats]]
|p22= title: [[String]] - title text on the debriefing screen


|
|p23= description: [[String]] - description text on the debriefing screen
}}
 
|p24= subtitle: [[String]] - subtitle text on the debriefing screen ('''must''' be defined in order to trigger this syntax of the command)
 
|p25= picture: [[String]] - (Optional) title picture
 
|p27= background: [[String]] - (Optional) background picture
 
|r2= [[Nothing]]


|x1= <sqf>
_currentObjective = (taskDescription currentTask player) select 2;
"endDeath" setDebriefingText ["You Lose", "All of your men were killed while assaulting the " + _currentObjective];
</sqf>


{{GameCategory|arma3|New Scripting Commands}}
|seealso= [[getDebriefingText]] [[disableDebriefingStats]] [[enableDebriefingStats]] [[endMission]] [[failMission]] [[missionEnd]]
{{GameCategory|arma3|Scripting Commands}}
}}
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 17:31, 25 March 2024

Arma 3 logo black.png0.50
Hover & click on the images for description

Description

Description:
Sets debriefing title, text, subtitle, picture and background for a mission ending. The end type could be the engine-defined ("CONTINUE", "KILLED", "LOSER", "END1", "END2", "END3", "END4", "END5", "END6"), config-defined (see CfgDebriefing) or, with an alternative syntax of this command, any String. Given texts will be used to replace the corresponding texts on the debriefing screen.
⚠
In order to benefit from alternative syntax functionality, there will have to be at least three arguments passed to the command; two arguments will trigger the old behaviour.
endMission.jpg failMission.jpg
Groups:
Briefing

Syntax

Syntax:
endType setDebriefingText [title, description]
Parameters:
endType: String - engine type
title: String - title text on the debriefing screen
description: String - description text on the debriefing screen
Return Value:
Nothing

Alternative Syntax

Syntax:
endType setDebriefingText [title, description, subtitle, picture, background]
Parameters:
endType: String - any name
title: String - title text on the debriefing screen
description: String - description text on the debriefing screen
subtitle: String - subtitle text on the debriefing screen (must be defined in order to trigger this syntax of the command)
picture: String - (Optional) title picture
background: String - (Optional) background picture
Return Value:
Nothing

Examples

Example 1:
_currentObjective = (taskDescription currentTask player) select 2; "endDeath" setDebriefingText ["You Lose", "All of your men were killed while assaulting the " + _currentObjective];

Additional Information

See also:
getDebriefingText disableDebriefingStats enableDebriefingStats endMission failMission missionEnd

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
Retrieved from "https://community.bistudio.com/wiki?title=setDebriefingText&oldid=363195"