{"name":"radioChannelCreate","operator":null,"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","replaced_by":[],"games":[{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},{"game":"arma3","name":"Arma 3","version":"0.50"}],"since":{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},"arma3_since":"0.50","branch":null,"locality":{"argument":"global","effect":"global","server_exec":true},"exec":null,"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]","since":null,"effect":null,"exec":null,"params":[{"name":"color","type":"Array","optional":false,"default":null,"description":"RGBA color values","types":["Array"],"since":null,"text":"color: Array - RGBA color values"},{"name":"label","type":"String","optional":false,"default":null,"description":"label","types":["String"],"since":null,"text":"label: String - label"},{"name":"callSign","type":"String or Arma 3 v2.22 Array of Strings","optional":false,"default":null,"description":"see radioChannelSetCallSign","types":["String","Array"],"since":null,"text":"callSign: String or Arma 3 v2.22 Array of Strings - see radioChannelSetCallSign"},{"name":"units","type":"Array of Objects","optional":false,"default":null,"description":"units in the channel","types":["Array","Object"],"since":null,"text":"units: Array of Objects - units in the channel"},{"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\")`","types":["Boolean"],"since":null,"text":"sentenceType: Boolean - (Optional, default true)\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","types":["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","operator":null,"left":null,"right":{"text":"[color, label, callSign, units, sentenceType]","types":["Array"]}}],"examples":[{"text":"```sqf\n_channelID = radioChannelCreate [[0.96, 0.34, 0.13, 0.8], \"Q-dance Radio\", \"%UNIT_NAME\", [player1, player2]];\n```","code":["_channelID = radioChannelCreate [[0.96, 0.34, 0.13, 0.8], \"Q-dance Radio\", \"%UNIT_NAME\", [player1, player2]];"]},{"text":"```sqf\n_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)\n```","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};"]}],"multiplayer":null,"problems":null,"aliases":[],"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."}],"categories":["Arma 3: Scripting Commands","Command Group: Custom Radio and Chat","Command Group: Radio and Chat","Introduced with Take On Helicopters version 1.00","Scripting Commands","Scripting Commands: Global Effect","Scripting Commands: Server Execution","Take On Helicopters: New Scripting Commands","Take On Helicopters: Scripting Commands"]}