activateAddons: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
No edit summary
 
(59 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma |= Game name
|game1= ofpe
|version1= 1.00


|1.00|= Game version
|game2= arma1
____________________________________________________________________________________________
|version2= 1.00


| Activates the listed addons. The list of active addons is initialized during this function. |= Description
|game3= arma2
____________________________________________________________________________________________
|version3= 1.00


| '''activateAddons''' [addon1, ...] |= Syntax
|game4= arma2oa
|version4= 1.50


|p1= [addon1, ...]: [[Array]] |= Parameter 1
|game5= tkoh
|version5= 1.00


| [[Nothing]] |= Return value
|game6= arma3
____________________________________________________________________________________________
|version6= 0.50
 
|x1= <pre>activateAddons ["BISOFP"]</pre> |= Example 1
____________________________________________________________________________________________


| |= See also
|gr1= Mods and Addons


}}
|descr= Activates the listed addons.
 
|s1= [[activateAddons]] addonsList
 
|p1= addonsList: [[Array]] of [[String]]s
 
|r1= [[Nothing]]


<h3 style="display:none">Notes</h3>
|x1= <sqf>activateAddons ["BISOFP"];</sqf>
<dl class="command_description">
<!-- Note Section BEGIN -->
Be aware that "Addon1" is the cfgPatches class of the desired addon to preload.


|seealso= [[unitAddons]] [[activatedAddons]]
}}


----
{{Note
|user= WGL.Q
|timestamp= 20090121123700
|text= Be aware that addon's string is the {{hl|CfgPatches}} class of the desired addon to preload.
}}


{{Note
|user= UNN
|timestamp= 20090510111700
|text= This command will activate addons that are referenced via scripts but not included in a missions required addons section. If executed from a configs init event with the [[call]] command, it will effectively override a missions required addons, preventing them from being activated (Appears to only happen in multi player).
To activate the passed addons along with those defined in the mission.sqm, execute the command from a configs init event using [[spawn]] or [[execVM]].
}}


This command will activate addons that are referenced via scripts but not included in a missions required addons section. If executed from a configs init event with the [[call]] command, it will effectively override a missions required addons, preventing them from being activated (Appears to only happen in multi player).  
{{Note
|user= samatra
|timestamp= 20220703084305
|text= Here is a handy function to call before you do [[createVehicle]] or other create* command during missing init scripts, which should activate missing addons without having to worry about re-adding previously added addons.
<sqf>
fnc_prepareClassAddons = {
private _class = toLower _this;


To activate the passed addons along with those defined in the mission.sqm, execute the command from a configs init event using [[spawn]] or [[execVM]]. [[User:UNN|UNN]]
// To avoid double checks
<!-- Note Section END -->
if(isNil"var_addonCheckedClasses") then {var_addonCheckedClasses = createHashMap;};
</dl>
if(_class in var_addonCheckedClasses) exitWith {};


<h3 style="display:none">Bottom Section</h3>
// Finding missing addons
private _needed = unitAddons _class apply {toLower _x};
private _active = activatedAddons;
private _missing = _needed - (_needed arrayIntersect _active);
if(count _missing > 0) then {
// Adding everything again, engine will figure it out itself
_active append _missing;
activateAddons _active;
};


[[Category:Scripting Commands|ACTIVATEADDONS]]
var_addonCheckedClasses set [_class, _needed];
[[Category:Scripting Commands OFP Elite |ACTIVATEADDONS]]
};
[[Category:Scripting Commands ArmA|ACTIVATEADDONS]]
</sqf>
[[Category:Command_Group:_System_Commands|{{uc:{{PAGENAME}}}}]]
Usage would be <sqf inline>"Land_BurntGarbage_01_F" call fnc_prepareClassAddons</sqf>.
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
}}
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]

Latest revision as of 09:43, 3 July 2022

ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
Hover & click on the images for description

Description

Description:
Activates the listed addons.
Groups:
Mods and Addons

Syntax

Syntax:
activateAddons addonsList
Parameters:
addonsList: Array of Strings
Return Value:
Nothing

Examples

Example 1:
activateAddons ["BISOFP"];

Additional Information

See also:
unitAddons activatedAddons

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note
WGL.Q - c
Posted on Jan 21, 2009 - 12:37 (UTC)
Be aware that addon's string is the CfgPatches class of the desired addon to preload.
UNN - c
Posted on May 10, 2009 - 11:17 (UTC)
This command will activate addons that are referenced via scripts but not included in a missions required addons section. If executed from a configs init event with the call command, it will effectively override a missions required addons, preventing them from being activated (Appears to only happen in multi player). To activate the passed addons along with those defined in the mission.sqm, execute the command from a configs init event using spawn or execVM.
samatra - c
Posted on Jul 03, 2022 - 08:43 (UTC)
Here is a handy function to call before you do createVehicle or other create* command during missing init scripts, which should activate missing addons without having to worry about re-adding previously added addons.
fnc_prepareClassAddons = { private _class = toLower _this; // To avoid double checks if(isNil"var_addonCheckedClasses") then {var_addonCheckedClasses = createHashMap;}; if(_class in var_addonCheckedClasses) exitWith {}; // Finding missing addons private _needed = unitAddons _class apply {toLower _x}; private _active = activatedAddons; private _missing = _needed - (_needed arrayIntersect _active); if(count _missing > 0) then { // Adding everything again, engine will figure it out itself _active append _missing; activateAddons _active; }; var_addonCheckedClasses set [_class, _needed]; };
Usage would be "Land_BurntGarbage_01_F" call fnc_prepareClassAddons.
Retrieved from "https://community.bistudio.com/wiki?title=activateAddons&oldid=325219"