The Grimes Crate Filler script is an old-fashioned Ammo Crate Refill script for ArmA 3, including modular use of all weapons, attachments, magazines, items, clothing, bags, and much more!
This package includes an application of the script as part of an example mission.
This README is intended to provide detailed information as to the purpose, function, FAQs, and minor troubleshooting for this script in addition to installation, uninstallation, and maintenance tips. For further information or specifics in the code, the user should read the comments to the code within the script files.
Kent “KC” Grimes of Austin, Texas, United States is the author of the Grimes Crate Filler. The script was made in order to provide mission makers a user-friendly means of customizing an ammo crate.
The purpose of this script is to provide a way for the mission maker to customize ammo crates in order to make their mission unique and as generalized or as focused as they would like.
BI Forums Topic: https://forums.bohemia.net/forums/topic/161393-grimes-crate-filler-script/
At this time, there is no “installer” for the script, and it is instead a simple series of actions and file moves.
- Obtain the script files
- Simply copy the file "G_crate.sqf" into your mission directory
- In the ArmA 3 editor, place an ammo crate found in the Empty -> Supplies -> Ammo section
- In the crate's Init field, type the following command:
null = [this] execVM "G_crate.sqf";
Parameters:
Basic Settings:
_weaponCount = 10; //Quantity of each weapon/launcher
_ammoCount = 50; //Quantity of each type of ammunition/explosive
_itemCount = 10; //Quantity of each type of item (gadgets, attachments, etc.)
_uniformCount = 3; //Quantity of each type of uniform/hat/helmet/glasses (suggested to keep small due to not being stackable)
_bagCount = 3; //Quantity of each type of bag/vest (suggested to keep small due to not being stackable)
_refreshTime = 600; //Amount of time (seconds) until crate empties/refills (0 is no refresh)
Advanced Settings:
_NATO_Weapons = 1; //All BLUFOR weapons
_OPFOR_Weapons = 1; //All OPFOR weapons
_Ind_Weapons = 1; //All Independent weapons
_Base_Weapons = 1; //All weapons selected above will only be base/stock variants with no attachments (see attachments parameter)
_NATO_Launchers = 1; //All BLUFOR rocket/missile launchers
_OPFOR_Launchers = 1; //All OPFOR rocket/missile launchers
_Ind_Launchers = 1; //All Independent rocket/missile launchers
_Weapon_Ammo = 1; //All ammunition used by any weapons or launchers pulled from above parameters
_Plantable_Explosives = 1; //All plantable explosive devices (mines, charges, etc.) (not sorted by faction)
_Grenade_Launcher_Ammo = 1; //All grenade launcher ammo
_Throwables = 1; //All throwable munitions (smokes, grenades, chemlights, etc.)
_Attachments = 1; //All weapon attachments (not sorted by faction)
_Items = 1; //All items (gadgets, kits, binoculars, rangefinder, laser designator, anything else on player that is not a bag or weapon)
_Headgear = 1; //All hats and helmets
_Glasses_Goggles = 1; //All glasses and goggles
_BLUFOR_Uniforms = 1; //All BLUFOR uniforms (Note: Can only wear the uniforms of the player's faction, though Civilian can wear most all uniforms)
_OPFOR_Uniforms = 1; //All OPFOR uniforms (Note: Can only wear the uniforms of the player's faction, though Civilian can wear most all uniforms)
_Independent_Uniforms = 1; //All Independent uniforms (Note: Can only wear the uniforms of the player's faction, though Civilian can wear most all uniforms)
_Civilian_Uniforms = 1; //All Civilian uniforms (Note: Can only wear the uniforms of the player's faction, though Civilian can wear most all uniforms)
_Other_Uniforms = 1; //All Other uniforms (Note: Can only wear the uniforms of the player's faction, though Civilian can wear most all uniforms)
_Vests = 1; //All vests and chest rigs
_Empty_Bags = 1; //All empty, normal backpacks
_Preset_Bags = 1; //All preset bags (normal bags containing a preset of items, such as First Aid Kits and Explosives)
_Assemble_Bags = 1; //All backpacks that lack cargo but can be used or combined with another bag to assemble a device or static weapon
_Exclusion_Array = []; //Array of classnames, as strings, of specifc items to be excluded
_Debug = 1; //Dump formatted return of all entities added to ammo box to .rpt
This README is intended to provide detailed information as to the purpose, function, FAQs, and minor troubleshooting for this script in addition to installation, uninstallation, and maintenance tips. For further information or specifics in the code, the user should read the comments to the code within the script files. Any further questions or comments can be directed to the author.
The script is designed to exit upon critical failure and it will attempt to announce the problem in chat. These types of failures are intended for development, and should never be encountered down the road if they were not encountered at launch, save for software updates. Upon setup or completion of modifications, it is recommended that the user, before launch, run the script in a test environment.
Contributions are welcomed and encouraged. Please follow the below guidelines:
- Use the Pull Request feature
- Document any additional work
- Provide reasonable commit history comments
- Test all modifications locally and online
MIT License
Copyright (c) 2014-2018 Kent "KC" Grimes. All Rights Reserved.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.