{"name":"playMusic","operator":null,"title":"playMusic","type":"command","url":"https://community.bistudio.com/wiki/playMusic","revid":369050,"updated":"2024-09-02T20:24:51Z","groups":["Sounds"],"status":"ok","replaced_by":[],"games":[{"game":"ofp","name":"Operation Flashpoint","version":"1.00"},{"game":"ofpe","name":"Operation Flashpoint: Elite","version":"1.00"},{"game":"arma1","name":"Armed Assault","version":"1.00"},{"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":"ofp","name":"Operation Flashpoint","version":"1.00"},"arma3_since":"0.50","branch":null,"locality":{"argument":null,"effect":"local","server_exec":false},"exec":null,"description":"Plays music defined in Description.ext's CfgMusic or config.cpp. If the *musicName* could not be found a message is logged into the .rpt file: `Music <*musicName*> not found`.\n- Arma 3: CfgMusic\n- Arma 2: CfgMusic\n- ArmA: Armed Assault: CfgMusic\n- Operation Flashpoint: CfgMusic\n\n> [!NOTE]\n> To stop the music, use `playMusic \"\";`.","syntaxes":[{"syntax":"playMusic musicName","since":null,"effect":null,"exec":null,"params":[{"name":"musicName","type":"String","optional":false,"default":null,"description":"music classname","types":["String"],"since":null,"text":"musicName: String - music classname"}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"unary","operator":null,"left":null,"right":{"text":"musicName","types":["String"]}},{"syntax":"playMusic [musicName, start]","since":null,"effect":null,"exec":null,"params":[{"name":"musicName","type":"String","optional":false,"default":null,"description":"music classname","types":["String"],"since":null,"text":"musicName: String - music classname"},{"name":"start","type":"Number","optional":false,"default":null,"description":"start, in seconds. Can be negative.","types":["Number"],"since":null,"text":"start: Number - start, in seconds. Can be negative."}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"unary","operator":null,"left":null,"right":{"text":"[musicName, start]","types":["Array"]}}],"examples":[{"text":"```sqf\nplayMusic \"RadioAmbient1\";\n```","code":["playMusic \"RadioAmbient1\";"]},{"text":"```sqf\nplayMusic [\"RadioAmbient3\", 3]; // start to play from 00:00:03\n```","code":["playMusic [\"RadioAmbient3\", 3]; // start to play from 00:00:03"]},{"text":"Play from 00:00:01 to 00:00:05:\n\n```sqf\n0 spawn {\n    playMusic [\"RadioAmbient5\", 1];\n    sleep 4;\n    playMusic \"\";\n};\n```","code":["0 spawn {\n\tplayMusic [\"RadioAmbient5\", 1];\n\tsleep 4;\n\tplayMusic \"\";\n};"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["getMusicPlayedTime","playSound","say","createSoundSource","addMusicEventHandler","fadeMusic","Arma 3 Utilities"],"notes":[],"categories":["ArmA: Armed Assault: Scripting Commands","Arma 2: Operation Arrowhead: Scripting Commands","Arma 2: Scripting Commands","Arma 3: Scripting Commands","Command Group: Sounds","Introduced with Operation Flashpoint version 1.00","Operation Flashpoint: Elite: Scripting Commands","Operation Flashpoint: New Scripting Commands","Operation Flashpoint: Scripting Commands","Scripting Commands","Scripting Commands: Local Effect","Take On Helicopters: Scripting Commands"]}