{"name":"kbTell","operator":null,"title":"kbTell","type":"command","url":"https://community.bistudio.com/wiki/kbTell","revid":369397,"updated":"2024-09-03T18:43:19Z","groups":["Conversations"],"status":"ok","replaced_by":[],"games":[{"game":"arma2","name":"Arma 2","version":"1.00"},{"game":"arma2oa","name":"Arma 2: Operation Arrowhead","version":"1.50"},{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},{"game":"arma3","name":"Arma 3","version":"0.50"}],"since":{"game":"arma2","name":"Arma 2","version":"1.00"},"arma3_since":"0.50","branch":null,"locality":{"argument":"local","effect":"global","server_exec":false},"exec":null,"description":"Make the person tell to the receiver the sentence. See Conversations for more details.","syntaxes":[{"syntax":"person kbTell [receiver, topicName, sentenceClass, argumentArray1, argumentArray2, ..., forceRadio]","since":null,"effect":null,"exec":null,"params":[{"name":"person","type":"Object","optional":false,"default":null,"description":null,"types":["Object"],"since":null,"text":"person: Object"},{"name":"receiver","type":"Object","optional":false,"default":null,"description":null,"types":["Object"],"since":null,"text":"receiver: Object"},{"name":"topicName","type":"String","optional":false,"default":null,"description":null,"types":["String"],"since":null,"text":"topicName: String"},{"name":"sentenceClass","type":"String","optional":false,"default":null,"description":null,"types":["String"],"since":null,"text":"sentenceClass: String"},{"name":"argumentArrayN","type":"Array","optional":true,"default":null,"description":"format [argumentName, argumentValue, argumentText, argumentSpeech]:\n- argumentName: String\n- argumentValue: Code\n- argumentText: String\n- argumentSpeech: Array of Strings - each string is an already defined word in config.","types":["Array"],"since":null,"text":"argumentArrayN: Array - (Optional) format [argumentName, argumentValue, argumentText, argumentSpeech]:\n- argumentName: String\n- argumentValue: Code\n- argumentText: String\n- argumentSpeech: Array of Strings - each string is an already defined word in config."},{"name":"forceRadio","type":"Boolean, Number or String (last value of the array)","optional":true,"default":null,"description":"Boolean true/false to force use of radio\n- Number 1-10 to force use of custom radio channel\n- String name of radio channel to use, from: 'GLOBAL', 'SIDE', 'GROUP', 'VEHICLE', 'DIRECT', 'COMMAND'","types":["Boolean","Number","String"],"since":null,"text":"forceRadio: Boolean, Number or String (*last value of the array*) - (Optional)\n- Boolean true/false to force use of radio\n- Number 1-10 to force use of custom radio channel\n- String name of radio channel to use, from: 'GLOBAL', 'SIDE', 'GROUP', 'VEHICLE', 'DIRECT', 'COMMAND'"}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"binary","operator":null,"left":{"text":"person","types":["Object"]},"right":{"text":"[receiver, topicName, sentenceClass, argumentArray1, argumentArray2, ..., forceRadio]","types":["Array"]}}],"examples":[{"text":"```sqf\nplayer kbTell [BIS_HQ, \"myTopic\", \"playerSentence1\"];\n```","code":["player kbTell [BIS_HQ, \"myTopic\", \"playerSentence1\"];"]},{"text":"```sqf\nplayer kbTell [\n    BIS_HQ,                                        // to\n    \"Airstrike\",                                // topic\n    \"AirstrikeRequest\",                            // sentence\n    [\"Team\", {}, \"Anvil\", [\"Anvil\"]],            // argument 1\n    [\"Location\", {}, \"Strelka\", [\"Strelka\"]],    // argument 2\n    true];                                        // use radio\n```\n\nin given .bikb:\n\n```cpp\nclass AirstrikeRequest \n{\n    text = \"%team requesting close air support at grid %location \";\n    speech[] = { %Team, RequestingCloseAirSupportAtGrid, %Location };\n    class Arguments \n    {\n        class Team        { type = \"simple\"; };\n        class Location    { type = \"simple\"; };\n    };\n};\n```","code":["player kbTell [\n\tBIS_HQ,\t\t\t\t\t\t\t\t\t\t// to\n\t\"Airstrike\",\t\t\t\t\t\t\t\t// topic\n\t\"AirstrikeRequest\",\t\t\t\t\t\t\t// sentence\n\t[\"Team\", {}, \"Anvil\", [\"Anvil\"]],\t\t\t// argument 1\n\t[\"Location\", {}, \"Strelka\", [\"Strelka\"]],\t// argument 2\n\ttrue];\t\t\t\t\t\t\t\t\t\t// use radio"]},{"text":"```sqf\nplayer kbTell [\n    BIS_HQ,                                        // to\n    \"Airstrike\",                                // topic\n    \"AirstrikeRequest\",                            // sentence\n    [\"argumentName\", argumentValue],            // argument 1\n    true];                                        // use radio\n```","code":["player kbTell [\n\tBIS_HQ,\t\t\t\t\t\t\t\t\t\t// to\n\t\"Airstrike\",\t\t\t\t\t\t\t\t// topic\n\t\"AirstrikeRequest\",\t\t\t\t\t\t\t// sentence\n\t[\"argumentName\", argumentValue],\t\t\t// argument 1\n\ttrue];\t\t\t\t\t\t\t\t\t\t// use radio"]}],"multiplayer":null,"problems":"Two units cannot talk on the same channel at the same time, this can lead to weird effects for non-local listeners; make sure not to use the same channel at the same time in multiplayer. Custom channels are considered as one channel for this matter.","aliases":[],"see_also":["Conversations","kbAddTopic","kbHasTopic","kbReact","kbRemoveTopic","kbAddDatabase","kbAddDatabaseTargets","FSM","FSM Editor"],"notes":[],"categories":["Arma 2: New Scripting Commands","Arma 2: Operation Arrowhead: Scripting Commands","Arma 2: Scripting Commands","Arma 3: Scripting Commands","Command Group: Conversations","Introduced with Arma 2 version 1.00","Scripting Commands","Scripting Commands: Global Effect","Take On Helicopters: Scripting Commands"]}