{"name":"playMusic","title":"playMusic","type":"command","url":"https://community.bistudio.com/wiki/playMusic","revid":369050,"updated":"2024-09-02T20:24:51Z","groups":["Sounds"],"status":"ok","games":{"ofp":"1.00","ofpe":"1.00","arma1":"1.00","arma2":"1.00","arma2oa":"1.50","tkoh":"1.00","arma3":"0.50"},"since":"ofp 1.00","arma3_since":"0.50","locality":{"effect":"local"},"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\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","params":[{"name":"musicName","type":"String","description":"music classname","type_expr":"String"}],"returns":{"type":"Nothing","type_expr":"Nothing"},"form":"unary","right":{"text":"musicName"}},{"syntax":"playMusic [musicName, start]","params":[{"name":"musicName","type":"String","description":"music classname","type_expr":"String"},{"name":"start","type":"Number","description":"start, in seconds. Can be negative.","type_expr":"Number"}],"returns":{"type":"Nothing","type_expr":"Nothing"},"form":"unary","right":{"text":"[musicName, start]"}}],"examples":[{"code":["playMusic \"RadioAmbient1\";"]},{"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};"]}],"see_also":["getMusicPlayedTime","playSound","say","createSoundSource","addMusicEventHandler","fadeMusic","Arma 3 Utilities"]}