CfgMagazines Config Reference

From Bohemia Interactive Community
Jump to navigation Jump to search

Template:Stub

Introduction

CfgAmmo, cfgMagazines, cfgWeapons and cfgVehicles are root classes defined in the engine's config.bin.

These classes can be subsequently added to by addons inherit in the game or provided by oem.

CfgAmmo defines the missile characterstics for ammunition held in a cfgMagazine which, in turn, is used by a cfgWeapon, which, in turn, is selected for use in a (series of) cfgVehicles. The same ammunition can be, and generally is, used by multiple magazines. The same magazine, can be, and generally is, used by multiple weapons. And so on.



'Default' values are shown in the legend. They come from the derived class CA_Magazine rather than the true default{} since almost everything derives from this class. Nearly all values are identical to their ofp equivalent.

Note that engines will accept integer values (or math strings) where a float would normally be expected.

TokenNames marked ArmA were introduced from Xbox Elite and beyond.

Arma Enhancement

Arma introduced a new root class, cfgMagazines.

The magazines it declares are selected for use by specific cfgWeapons

Any given magazine can (obviously) only hold a specific cfgAmmo class.


In contrast, OFP uses a rather tedious construct in it's cfgWeapons class to distinguish between weapon and magazine paramaters.

The major alterations here are:

         OFP           ARMA
ammo=                  moved to cfgMagazines
cost=                  moved to cfgMagazines
displayNameMagazine=   moved to cfgMagazines and renamed DisplayName (of course)
magazines[] = {"this"};magazines[] = {};
magazineType=          moved to cfgMagazines and rennamed Type
maxLeadSpeed=          moved to cfgMagazines
minRange =             moved FROM cfgAmmo
minRangeProbab =
midRange =
midRangeProbab =
maxRange = 
maxRangeProbab = 
scopeWeapon=          renamed scope
scopeMagazine=        moved to cfgMagazines and rennamed scope
shortNameMagazine=    moved to cfgMagazines and rennamed descriptionShort?


Modifications

unlike it's cfgAmmo and cfgWeapon cousins: all bets are off. There is, a default class (the substance of this document), but it, and all other classes in cfgMagazines are deleteable/erasable/modifiable.

Caution should be excercised about 'expected' default values when inheriting. ANY added pbo can alter them substantially beofre your very eyes.

Alphabetic Order

ammo=""

StringName of the cfgAmmo class which this magazine holds

ammo=B_30mm_HE; //eg

class InventoryPlacements{}

class Library

 class Library
 {
  libTextDesc = "";
 };

count=30

Integer: the amount of ammo this magazine holds

descriptionShort=""

String: The descriptive Name of the ammunition

descriptionShort=$STR_SN_MAVERICK;
descriptionShort="Beretta Ammo";

displayName=""

String: The descriptive Name of the magzine. In ofp, this was called DisplayNameMagazine.

initSpeed=900

Integer: Starting speed of missile ==maxLeadSpeed = 23; Integer:

model="\ca\weapons\mag_univ[.p3d]"

String: The mag model identical to ofp

modelSpecial="[.p3d]"

String:

nameSound="magazine"

String:

picture="[\][[.pac]"

String: picture shown in gear for this mag. See cfgAmmo for warnings about picture paths

reloadAction="ManActReloadMagazine"

String:

scope=protected

Integer: values

private
protected
public

Ofp name was ScopeMagazine selectionFireAnim="zasleh"== String:

simulation="ProxyMagazines"

String:

type=256

Integer: OFP name was MagazineType See cfgWeapons for the CHANGES between ofp and arma for this value

useAction=0

Integer:

useActionTitle=""

String:

value=1

Integer: Formerly known as ValueMagzine in ofp

weight=0

Integer:

additonal values

because just about anything can be added to these classes it is not overly useful to attempt to define most of them of them. Fro whatver reason, and unlike other root classes, the engine doesn't need these tokens declared in default{}

tracersEvery=4

lastRoundsTracer=4