diag mergeConfigFile: Difference between revisions

Revision as of 20:47, 22 April 2021

-wrong parameter ("arma3diag") defined!-[[:Category:Introduced with arma3diag version 1.00|1.00]]

Hover & click on the images for description

Description

Description:: Update config without restarting. Attributes and classes can not be deleted unless delete is used. Changes to the config are applied to all new entities, a mission restart is not necessarily required. Spawning the vehicle again or switching weapons works too. Since 1.69 CfgAmmo should be mergeable as well.
⚠
Merging a config with an include statement, that points to a non existing file, will crash the game.
Groups:: Diagnostic Config

Syntax

Syntax:: diag_mergeConfigFile [path, userdir]
Parameters:: path: String - Absolute or relative path
: userdir: Bool - (Optional, default false) Path is relative to the user directory, otherwise it is relative to the mission directory
Return Value:: Nothing

Examples

Example 1:: diag_mergeConfigFile ["O:\Arma3\A3\Stuff_F\config.cpp"]

Additional Information

See also:: See also needed

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

[[Category:Introduced with arma3diag version 1.00]][[ Category: arma3diag: New Scripting Commands | DIAG MERGECONFIGFILE]][[ Category: arma3diag: Scripting Commands | DIAG MERGECONFIGFILE]]

@@ Line 6: / Line 6: @@
 |gr1= Diagnostic
+|gr2= Config
-|descr= Adjust configs on-the-fly without the need of restarting the game (by merging the given config file into the main config in memory). Location is relative to the Userdir (default) or mission directory depending on the the value of UserDir [FileName,UserDir].
+|descr= Update config without restarting. Attributes and classes can not be deleted unless {{ic|[[Class Inheritance#delete|delete]]}} is used. Changes to the config are applied to all new entities, a mission restart is not necessarily required. Spawning the vehicle again or switching weapons works too. Since {{GVI|arma3|1.69}} CfgAmmo should be mergeable as well.
-Doesn't work with cfgAmmo & few other classes. (Since 1.69, cfgAmmo should be mergeable!) Merging config file means also that you can't delete parameters through diag_mergeConfigFile. Changes applied by diag_mergeConfigFile are applied to all new entities so restart of mission is not necessarily  required - spawning vehicle again or changing back forth weapon should usually do the trick.
+{{Feature|Warning|Merging a config with an [[PreProcessor_Commands#.23include|include]] statement, that points to a non existing file, will crash the game.}}
-|s1= '''diag_mergeConfigFile''' path
+|s1= '''diag_mergeConfigFile''' [path, userdir]
-|p1= path: [[Array]] - The path to the config on your drive ([FileName,UserDir])
+|p1= path: [[String]] - Absolute or relative path
+|p2= userdir: [[Bool]] - (Optional, default [[false]]) Path is relative to the user directory, otherwise it is relative to the mission directory
 |r1= [[Nothing]]