kbAddTopic: Difference between revisions

Latest revision as of 18:11, 15 March 2024

1.00

Hover & click on the images for description

Description

Description:: Register conversation topic to given person. See Conversations for more details.
ⓘ
Only the speaker(s) need to have the topic added.
Groups:: Conversations

Syntax

Syntax:

person kbAddTopic [topicName, conversationFile, fsmFile, eventHandler]

Parameters:

person: Object

topicName: String - the topic id for further reference

conversationFile: String - .bikb file path

fsmFile: String - (Optional) .fsm file path. Receives the following parameters:

_sentenceId: the sentence as defined in the .bikb file
_topic: TopicName registered via kbAddTopic
_this: the person that was talked to (receiver)
_from: the person that talked to the receiver and triggered the script

eventHandler: Code or String - (Optional) code to execute - given String will be compiled. This is not an sqf file path.
Parameters: identical to fsmFile - see above.

Return Value:

Nothing

Examples

Example 1:: player kbAddTopic ["myTest", "myTest.bikb", "myTest.fsm", compile preprocessFileLineNumbers "myTest.sqf"];
Example 2:: player kbAddTopic ["itsGettingWarm", "weatherTalk.bikb"];

Additional Information

See also:: Conversations kbHasTopic kbTell kbWasSaid kbReact kbRemoveTopic kbAddDatabase kbAddDatabaseTargets FSM FSM Editor

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

@@ Line 1: / Line 1: @@
-[[Category:Scripting Commands|KBADDTOPIC]]
+{{RV|type=command
-[[Category:Scripting Commands ArmA|KBADDTOPIC]]
-{{future-use}}
-{{Command|= Comments
+|game1= arma2
-____________________________________________________________________________________________
+|version1= 1.00
-| arma |= Game name
+|game2= arma2oa
+|version2= 1.50
-|1.00|= Game version
+|game3= tkoh
-____________________________________________________________________________________________
+|version3= 1.00
-| Register conversation topic to given person.|= Description
+|game4= arma3
-____________________________________________________________________________________________
+|version4= 0.50
-|[[Boolean]] <nowiki>=</nowiki>  [[Object#Person|Person]] '''kbAddTopic''' [name, "filename", task type)] |= Syntax
+|gr1= Conversations
-|p1= [[Object#Person|Person]] |= Parameter 1
+|arg= local
-|p2= [name, filename, task type)]: [[Array]] |= Parameter 2
+|eff= local
-| [[Nothing]] |= Return value
+|descr= Register conversation topic to given person. See [[Conversations]] for more details.
-____________________________________________________________________________________________
+{{Feature|informative|Only the speaker(s) need to have the topic added.}}
-|  |= See also
+|s1= person [[kbAddTopic]] [topicName, conversationFile, fsmFile, eventHandler]
-}}
+|p1= person: [[Object]]
+|p2= topicName: [[String]] - the topic id for further reference
+|p3= conversationFile: [[String]] - .bikb file path
+|p4= fsmFile: [[String]] - (Optional) .fsm file path. Receives the following parameters:
+* '''_sentenceId:''' the sentence as defined in the .bikb file
+* '''_topic:''' TopicName registered via kbAddTopic
+* '''_this:''' the person that was talked to (receiver)
+* '''_from:''' the person that talked to the receiver and triggered the script
+|p5= eventHandler: [[Code]] or [[String]] - (Optional) code to execute - given String will be [[compile]]d. This is '''not''' an sqf file path.<br>
+Parameters: identical to ''fsmFile'' - see above.
+|r1= [[Nothing]]
-<h3 style="display:none">Notes</h3>
+|x1= <sqf>player kbAddTopic ["myTest", "myTest.bikb", "myTest.fsm", compile preprocessFileLineNumbers "myTest.sqf"];</sqf>
-<dl class="command_description">
-<!-- Note Section BEGIN -->
-<!-- Note Section END -->
+|x2= <sqf>player kbAddTopic ["itsGettingWarm", "weatherTalk.bikb"];</sqf>
-</dl>
-<h3 style="display:none">Bottom Section</h3>
+|seealso= [[Conversations]] [[kbHasTopic]] [[kbTell]] [[kbWasSaid]] [[kbReact]] [[kbRemoveTopic]] [[kbAddDatabase]] [[kbAddDatabaseTargets]] [[FSM]] [[FSM Editor]]
+}}