---
name: "BIS_fnc_kbTell"
type: function
status: ok
groups: ["Conversations"]
arma3_since: "0.50"
locality: {"argument": "global", "effect": "global", "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_kbTell
revid: 370523
updated: 2025-01-01T18:16:34Z
---

# BIS_fnc_kbTell

*Function · Conversations · Arma 3 v0.50 · introduced in Take On Helicopters v1.00*

Locality: arguments **global** · effect **global** · executed with **spawn**

## Description

Play given sentence/conversation. Script terminates itself when conversation is finished.

Conversation must be declared in [Description.ext/CfgSentences](../topics/Description.ext.md#cfgsentences).

> [!NOTE]
> This function can also be executed with [call](../commands/call.md). Doing so will make it internally [spawn](../commands/spawn.md) since it needs to be able suspend its execution.

## Syntax

```sqf
[topic, container, section, radioMode, code, speakers, soundVolume, radioProtocol] spawn BIS_fnc_kbTell
```

**Parameters:**

- `topic`: [String](../topics/String.md) - topic name
- `container`: [String](../topics/String.md) - (Optional, default [missionName](../commands/missionName.md)) container name ([CfgSentences](../topics/Description.ext.md#cfgsentences) sub-category)
- `section`: [Array](../topics/Array.md) or [String](../topics/String.md) - (Optional, default "") section to be played. Elements can be:
  - [String](../topics/String.md) - "variant" - play specific variant
  - [Array](../topics/Array.md)
    - [startingSentence(, endingSentence)] - play all sentences between specific start and end
      - startingSentence and endingSentence can be in format:
        - [String](../topics/String.md) - full sentence name (example: "04_intro_team_PLA_0")
        - [Array](../topics/Array.md) - [<actorID>(, <sentenceID>)] (example: ["PLA", 0] or just ["PLA_0"])
        - [Boolean](../topics/Boolean.md) - true to play random sentence, false to play first sentence
        - default - first sentence for startingSentence, last sentence for endingSentence
  - default: play everything
- `radioMode`: [Boolean](../topics/Boolean.md), [String](../topics/String.md), [Object](../topics/Object.md) or [Code](../topics/Code.md) - (Optional, default: [false](../commands/false.md)) can be:
  - [Boolean](../topics/Boolean.md) - true to force radio
  - [String](../topics/String.md) - name of radio channel ("DIRECT" or "VEHICLE")
  - [Number](../topics/Number.md) - [custom](../commands/radioChannelCreate.md) radio channel
  - [Object](../topics/Object.md) - listener's channel
  - [Code](../topics/Code.md) - returned value of code
- `code`: [Code](../topics/Code.md) or [Array](../topics/Array.md) - (Optional, default `{ true }`) can be:
  - [Code](../topics/Code.md) - executed at the start of every sentence (arguments are same as in kbAddTopic event handler)
  - [Array](../topics/Array.md) - code with arguments in format [code, arguments]
- `speakers`: [Array](../topics/Array.md) or [Boolean](../topics/Boolean.md) - (Optional, default `[]`) can be:
  - [Array](../topics/Array.md) - replacement units for those defined in .bikb file (in chronological order)
  - [Boolean](../topics/Boolean.md) - when true, dummy logics will be created for all actor units which doesn't exist (default: false or value of 'BIS_fnc_kbTell_createDummy' variable)
- `soundVolume`: [Number](../topics/Number.md) - (Optional, default Take On Helicopters v1.00 0.2, Arma 3 v1.00 -1) music and sound volumes lowering ratio during the conversation, range 0..1 (e.g 0 = no music, 0.25 = a quarter of the current volume, 1 or out of range = no change)
- `radioProtocol`: [Boolean](../topics/Boolean.md) - (Optional, default [true](../commands/true.md)) true to disable radio protocol message while the conversation is playing

**Returns:** [Nothing](../topics/Nothing.md)

## Examples

### Example 1

```sqf
["01_Wave", "A_in", nil, "SIDE", nil, nil, 1, false] spawn BIS_fnc_kbTell;
```

## See also

Conversations · [kbTell](../commands/kbTell.md) · [BIS_fnc_kbCanSpeak](../functions/BIS_fnc_kbCanSpeak.md) · [BIS_fnc_kbCreateDummy](../functions/BIS_fnc_kbCreateDummy.md) · [BIS_fnc_kbIsSpeaking](../functions/BIS_fnc_kbIsSpeaking.md) · [BIS_fnc_kbMenu](../functions/BIS_fnc_kbMenu.md) · [BIS_fnc_kbPriority](../functions/BIS_fnc_kbPriority.md) · [BIS_fnc_kbSentence](../functions/BIS_fnc_kbSentence.md) · [BIS_fnc_kbSkip](../functions/BIS_fnc_kbSkip.md) · [BIS_fnc_kbTellLocal](../functions/BIS_fnc_kbTellLocal.md) · [BIS_fnc_kbTopicConfig](../functions/BIS_fnc_kbTopicConfig.md)

<sub>Source: [BI Community Wiki — BIS fnc kbTell](https://community.bistudio.com/wiki/BIS_fnc_kbTell) (revision 370523).</sub>