{"name":"radioChannelCreate","title":"radioChannelCreate","type":"command","url":"https://community.bistudio.com/wiki/radioChannelCreate","revid":378309,"updated":"2026-04-01T22:48:12Z","groups":["Radio and Chat","Custom Radio and Chat"],"status":"ok","games":{"tkoh":"1.00","arma3":"0.50"},"since":"tkoh 1.00","arma3_since":"0.50","locality":{"argument":"global","effect":"global","server_exec":true},"description":"Create a custom radio channel with the given color, label, call sign and registered characters.\nThe **custom channel ID** returned can be used to manipulate the created channel later.\nThere are **50** slots (10 slots before Arma 3 v2.22) for custom radio channels which would correspond to channels 6..15 and 26..65 (see getPlayerChannel).\nThe command will find an unused index in this range and create it when found.","syntaxes":[{"syntax":"radioChannelCreate [color, label, callSign, units, sentenceType]","params":[{"name":"color","type":"Array","description":"RGBA color values","type_expr":"Array"},{"name":"label","type":"String","description":"label","type_expr":"String"},{"name":"callSign","type":"String or Arma 3 v2.22 Array of Strings","description":"see radioChannelSetCallSign","type_expr":"String | Array<String>"},{"name":"units","type":"Array of Objects","description":"units in the channel","type_expr":"Array<Object>"},{"name":"sentenceType","type":"Boolean","optional":true,"default":"true","description":"true - use *Protocol* message color from `getArray (configFile >> \"RscChatListDefault\" >> \"colorMessageProtocol\")`\n- false - use *Normal* message color from `getArray (configFile >> \"RscChatListDefault\" >> \"colorMessage\")`","type_expr":"Boolean","text":"sentenceType: Boolean - (Optional, default true)\n\n- true - use *Protocol* message color from `getArray (configFile >> \"RscChatListDefault\" >> \"colorMessageProtocol\")`\n- false - use *Normal* message color from `getArray (configFile >> \"RscChatListDefault\" >> \"colorMessage\")`"}],"returns":{"type":"Number","type_expr":"Number","description":"created custom channel ID (used in customChat command), 0 if failed. (see BIS_fnc_channelNumToRadioChannelID, BIS_fnc_radioChannelIDToChannelNum)","text":"Number - created **custom channel ID** (used in customChat command), 0 if failed. (see BIS_fnc_channelNumToRadioChannelID, BIS_fnc_radioChannelIDToChannelNum)"},"form":"unary","right":{"text":"[color, label, callSign, units, sentenceType]"}}],"examples":[{"code":["_channelID = radioChannelCreate [[0.96, 0.34, 0.13, 0.8], \"Q-dance Radio\", \"%UNIT_NAME\", [player1, player2]];"]},{"code":["_channelID = radioChannelCreate [[0.96, 0.34, 0.13, 0.8], \"Q-dance Radio\", \"%UNIT_NAME\", [player1, player2], true];\n// using true also disables automatic quotes for chat in channel (Arma 3)"]},{"text":"Create custom channel and add all players to it, present and JIP:\n\n```sqf\nif (isServer) then\n{\n    private _channelName = \"Q-dance Radio\";\n    private _channelID = radioChannelCreate [[0.96, 0.34, 0.13, 0.8], _channelName, \"%UNIT_NAME\", []];\n    if (_channelID == 0) exitWith {diag_log format [\"Custom channel '%1' creation failed!\", _channelName]};\n    [_channelID, {_this radioChannelAdd [player]}] remoteExec [\"call\", [0, -2] select isDedicated, _channelName];\n};\n```","code":["if (isServer) then\n{\n\tprivate _channelName = \"Q-dance Radio\";\n\tprivate _channelID = radioChannelCreate [[0.96, 0.34, 0.13, 0.8], _channelName, \"%UNIT_NAME\", []];\n\tif (_channelID == 0) exitWith {diag_log format [\"Custom channel '%1' creation failed!\", _channelName]};\n\t[_channelID, {_this radioChannelAdd [player]}] remoteExec [\"call\", [0, -2] select isDedicated, _channelName];\n};"]}],"see_also":["radioChannelAdd","radioChannelRemove","radioChannelSetCallSign","radioChannelSetLabel","customChat","customRadio","setCurrentChannel","currentChannel","enableChannel","channelEnabled","getPlayerChannel","radioChannelInfo"],"notes":[{"user":"Killzone_Kid","date":"2016-01-21T13:30:00Z","text":"Make sure you add all units you intend to speak or receive messages on created custom channel to the channel."},{"user":"Hypoxic125","date":"2022-11-01T06:38:08Z","text":"Units are removed from the chat channel on RESPAWN. Be sure to add units back to their custom chat channels upon respawn via onPlayerRespawn.sqf or Respawn Event Handler."}]}