{"name":"setMusicEffect","operator":null,"title":"setMusicEffect","type":"command","url":"https://community.bistudio.com/wiki/setMusicEffect","revid":377584,"updated":"2026-01-02T06:56:42Z","groups":["Sounds","Triggers","Waypoints"],"status":"ok","replaced_by":[],"games":[{"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":"ofpe","name":"Operation Flashpoint: Elite","version":"1.00"},"arma3_since":"0.50","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"Defines a music track played on activation. If another track is playing already, this will stop it and start the new track.\n\nTrack is a subclass name of CfgMusic. In addition, \"$STOP$\" (stops the current music track) or use `playMusic \"\"`.\nWhen used in a trigger, the track starts on activation but does not automatically stop on deactivation.","syntaxes":[{"syntax":"trigger setMusicEffect track","since":null,"effect":null,"exec":null,"params":[{"name":"trigger","type":"Object","optional":false,"default":null,"description":null,"types":["Object"],"since":null,"text":"trigger: Object"},{"name":"track","type":"String","optional":false,"default":null,"description":null,"types":["String"],"since":null,"text":"track: String"}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"binary","operator":null,"left":{"text":"trigger","types":["Object"]},"right":{"text":"track","types":["String"]}},{"syntax":"waypoint setMusicEffect track","since":null,"effect":null,"exec":null,"params":[{"name":"waypoint","type":"Waypoint","optional":false,"default":null,"description":null,"types":["Waypoint"],"since":null,"text":"waypoint: Waypoint"},{"name":"track","type":"String","optional":false,"default":null,"description":null,"types":["String"],"since":null,"text":"track: String"}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"binary","operator":null,"left":{"text":"waypoint","types":["Waypoint"]},"right":{"text":"track","types":["String"]}}],"examples":[{"text":"```sqf\n_trigger setMusicEffect \"Track1\";\n```","code":["_trigger setMusicEffect \"Track1\";"]},{"text":"```sqf\n[_group1,1] setMusicEffect \"$STOP$\";\n```","code":["[_group1,1] setMusicEffect \"$STOP$\";"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["createTrigger","setSoundEffect","setTitleEffect"],"notes":[],"categories":["ArmA: Armed Assault: Scripting Commands","Arma 2: Operation Arrowhead: Scripting Commands","Arma 2: Scripting Commands","Arma 3: Scripting Commands","Command Group: Sounds","Command Group: Triggers","Command Group: Waypoints"]}