Difference between revisions of "Arma 3: Magazine Proxies"

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "\{\{( *)Warning( *)\|" to "{{$1Feature$2|$Warning$2|")
m (Text replacement - " +\|\$Warning( *)\|" to " |$1Warning$1|")
Line 163: Line 163:
=== CfgNonAIVehicles ===
=== CfgNonAIVehicles ===
{{Feature |$Warning | It is strongly suggested to use '''"\A3\Data_f\proxies\weapon_slots\MAGAZINESLOT.p3d"''' as proxy but in case you want to create your own, here are the instructions.}}
{{Feature | Warning | It is strongly suggested to use '''"\A3\Data_f\proxies\weapon_slots\MAGAZINESLOT.p3d"''' as proxy but in case you want to create your own, here are the instructions.}}

Revision as of 01:30, 7 February 2021

Magazine Proxies, as name suggest, is a technology that allows moving weapon magazines to seperate proxy & swap it dynamically by just swapping a different magazine. Magazine Following feature was introduced in Arma 3 logo black.png1.78 version of game.



Magazines in all LODs (shadow & geometry too) need to be replaced with new proxy which is linked to cfgNonAIVehicles entry. In Arma 3 logo black.png1.80 patch following proxy was created for this purpose A3\Data_f\proxies\weapon_slots\MAGAZINESLOT.p3d

magazineProxies MX profile.png

MX magazine in separate p3d

magazineProxies MX magazine.png

For testing purposes (especially when you are repositioning magazine) it is good to directly link in proxy to p3d containing your magazine so you can easily see it in buldozer

Model Config

Magazine proxies can be animated and retextured. At the moment, it supports following animation sources

  • reload
  • reloadMagazine
  • revolving
  • ammo
  • ammoRandom
  • isEmpty

Configuring of bones, animations & sections for texturing is same as with any other model.cfg p3d & more info about it can be found on Model Config page.

Example model.cfg code for bullet hiding for transparent magazines.
// Macro for hiding bullets
#define BULLET_HIDE(x,from,count) class Bullet##x\
	maxValue= 0.000000;\

class CfgSkeletons
	class Default
		isDiscrete = 1;
		skeletonInherit = "";
		skeletonBones[] = {};
	class magazine_transparent_skeleton: Default
		skeletonInherit = "";
		skeletonBones[] = 
			"bullet030",	"",
			"Bullet002",	"",
			"Bullet003",	"",
			"Bullet004",	"",
			"bullet005",	"",
			"bullet006",	"",
			"bullet007",	"",
			"bullet008",	"",
			"bullet009",	"",
			"bullet010",	"",
			"bullet011",	"",
			"bullet012",	"",
			"bullet013",	"",
			"bullet014",	"",
			"bullet015",	"",
			"bullet016",	"",
			"bullet017",	""
class CfgModels
	class Default
		skeletonName	= "";
		sectionsInherit	= "";
		sections[]		= {};
	class magazine_transparent: Default 
		// Magazine proxies supports hidden selections
		sections[] =
		class Animations


Heart of magazine proxy system lies in modelSpecial - a system originally designed in OFP for rifle mounted grenades. It was redesigned and now allows you to change to use magazine defined in modelSpecial as a proxy in weapon. In order to do so, you need to add following parameter - modelSpecialIsProxy = 1;

In addition to that, it is still possible to use reloadAction inside magazine config, which means you can have different reload animation depending on currently loaded magazine.

class CfgMagazines
	class RPG32_F;
	class RPG7_F: RPG32_F
		modelSpecial = "linkToP3d";
		modelSpecialIsProxy = 1
		hiddenSelections[] = {"camo"};
		hiddenSelectionsTextures[] = {"linkToTexture.paa"};
	class RPG7_YellowMagazine_F: RPG7_F
		displayName = "Go, go my yellow rocket!";
		reloadAction = "ReloadRPG"; // Switches reload action from RPG-7 front loading anim defined in cfgWeapons to RPG-32 back loading animation
		hiddenSelectionsTextures[] = {"#(argb,8,8,3)color(1,0.952941,0.0509804,1.0,CO)"}; // procedural yellow rocket


Moment of switching between old & new model is controlled by already existing parameter - magazineReloadSwitchPhase. It controls now both restart of revolving source (pre magazine proxy behavior) & model switching. Default value is 0.5 which means magazines will get swapped in the middle of reload animation (same as reloadMagazine source). It's worth to mention that following parameter can be applied per muzzle.

class CfgWeapons
	class Launcher_Base_F;
	class launch_RPG7_F: Launcher_Base_F
		magazineReloadSwitchPhase = 0.3; // magazine will get replaced pretty early


It is strongly suggested to use "\A3\Data_f\proxies\weapon_slots\MAGAZINESLOT.p3d" as proxy but in case you want to create your own, here are the instructions.

Proxy that is used in p3d need to be listed in CfgNonAIVehicles class. There is following rule for creating those entries

class Proxy + nameOfP3d

Bear in mind that same as with i.e. missile proxies for dynamic loadouts, name need to be unique in order to have it working properly. Since for game only thing that matters is p3d name, location of this proxy doesn't need to be same across different models. For sake of simplicity it is advised to use just single proxy on all weapons.

class CfgNonAIVehicles
	class ProxyWeapon;
	class ProxyMagazine: ProxyWeapon
		model		= "";
		simulation	= "magazine";


Example proxies for AKM, MX, STANAG & RPG-7 magazines - https://drive.google.com/open?id=1hZvLu8rJqg6WSrNoOoy0tUctFTccFmJj

E-Mag sample provided by da12thMonkey, model by Tigg - https://www.dropbox.com/s/am5ke5b02xr2jit/proxymag_example.7z?dl=0

Known issues

Currently known issues:

  • There is no magazine model visible if magazine doesn't have modelSpecial defined which might be quite problematic when it comes to community magazine interchangeability.
  • Loading magazine without modelSpecial & then loading one which have it defined will result in on screen assert and invisible rifle (magazine will be still visible though)
  • There is no way to manipulate model.cfg animation (i.e. M249 STANG & Box magazines)

See Also