Documentation: Weapons

Recoil

Fri, 24 Dec 2021 01:47:41 +0000

Overview

Recoil is the "kick" of a weapon when it is fired, causing the user's aim to drift off the target, thus limiting accuracy and forcing the user to compensate. This differs from spread, which is a random error that changes the intended trajectory of each fired projectile, while the weapon remains aimed at the same spot. By contrast, recoil changes the orientation of the weapon itself, so even a weapon with no spread will no longer be able to hit the same spot.

Recoil mechanics

Recoil strength

Each fired projectile creates an impulse that will throw the user's aim off-target. The strength of this impulse is determined by the recoil strength parameter. Each projectile will add a 2D (pitch and yaw) impulse to the weapon, rotating it away from the original orientation. The impulses from subsequent projectiles are added to the total recoil angular velocity, so sustained fire will continuously increase the recoil effect.

Recoil pattern

The recoil pattern determines the directions in which the recoil impulses described above take effect. Each time a projectile is fired, an impulse vector is calculated based on the recoil pattern. Most impulses will be directed toward a bias direction (typically in the direction upward from the barrel), and to simulate the pseudo-randomness of the recoil effect, some projectiles will create an impulse in a random direction within the set pattern. The per-shot probability of this random impulse can be adjusted using the random probability parameter.

Arc pattern

The arc pattern is the most conventional type of recoil pattern, which assumes a weapon that primarily "kicks upward". The green arrow shows the bias, which is the direction where normal recoil impulses will push the user's aim. The red arrows show possible directions for random recoil impulses, where the angles of all such impulses w.r.t the vertical direction are constrained to this arc. The pattern arc size parameter can widen the arc, allowing for greater horizontal deviations with each shot.

Circle pattern

The circle pattern behaves similarly to the arc pattern, except that it allows random impulses in the full 360° range (which means it does not need the arc size parameter). This is primarily useful for more wild recoil behavior, e.g a handheld machine gun during sustained fire.

Recoil resistance

In order to prevent the recoil impulses from making the weapon spiral out of control, weapons have recoil resistance, which is a constant force that acts opposite the recoil force while it is nonzero. After each recoil impulse is applied, this force will attempt to bring the recoil movement to a halt, thus it can be balanced with recoil strength to create the appropriate recoil behavior. For example, setting a high recoil strength and low resistance will allow a single shot to widely displace the user's aim, and the recoil effect will take longer to "decay".

The user's current state also affects their resistance. This is achieved using the resistance multipliers, e.g crouching can be expected to increase the user's ability to resist the recoil impulses, while jumping has the opposite effect.

NOTE: the recoil resistance parameter must be nonzero, otherwise the recoil impulse will never decay and will endlessly throw off the user's aim.

Recoil recovery

Recovery is an optional mechanic that allows for automatically correcting the user's aim. After the resistance has reduced the recoil angular velocity to zero, the recovery will take over and move the user's aim back toward the center of their recoil pattern. The recoil recovery parameter sets the speed of this effect, so an appropriate value must be found to make the transition look natural. The recovery also depends on the recoil pattern size, which sets a limit on how far the user's aim can deviate before it can no longer be returned to the original position. If the recoil impulses move the user's aim beyond the pattern radius, then the pattern itself will "drift" with the recoil, and the recovery will only restore the aim to the new center position of the pattern. However, there is a flag; Aimpoint Static that will disable the aim drifting beyond the recoil pattern's size and instead limit the recoil size to just the recoil pattern size, where the player's aim will stay until fire is stopped (if recovery is enabled).

(NEEDS PICTURES)

Recoil parameters

Weapon recoil can be set for infantry weapons and even vehicles. To set up recoil for a weapon, enable the recoil component within the weapon. WIthout this component, reload cannot be used. Once this component is enabled on a weapon, the parameters can be edited both within Mammoth and the in-game EDIT_WEAPON console command. The recoil component has its own tab within EDIT_WEAPON.

Ammo definition parameters

Parameter name

Default value

Short description

Recoil strength

0.0

Recoil strength determines the amount of recoil energy created by each projectile fired from the weapon. Higher values will make the recoil effect much faster and stronger (i.e "the aim will drift off-target more rapidly")

This is located within the Ballistics component within Ammo.

Weapon definition parameters

Parameter name	Default value	Short description
Pattern	Arc pattern	Sets the pattern of the recoil effect ("arc" or "circle")
Pattern size	0.0	Sets the size of the recoil pattern, in degrees. (setting to zero disables recovery)
Bias	(0, 0) vector	Sets the direction in which recoil impulses will be biased towards.. Refer to the charts for the vector direction.
Random probability	0.0	Sets the per-shot probability of a recoil impulse with a randomized direction
Arc size	15.0	Sets the arc size of the recoil pattern, in degrees. (only used by "arc").
First shot multiplier	1.0	Multiplies the strength of the recoil impulse of the first shot by this amount
Resist	1.0	Sets the recoil resistance strength
Jumping Resist multiplier	1.0	Multiplies the resistance by this amount while the user is jumping
Injured Resist multiplier	1.0	Multiplies the resistance by this amount when a player gets injured.
Crouching resist multiplier	1.0	Multiplies the resistance by this amount while the user is crouching
Scoped resist multiplier	1.0	Multiplies the resistance by this amount while the user is scoped (sniper rifle, iron sights, etc.)
Recovery	0.0	Sets the speed of recovery (setting to zero disables recovery)
Aimpoint Static	false	Sets if the recoil recovery point won't shift when the recoil hits the edge of the recoil circle/arc.

Weapon Parameters

Wed, 26 Jan 2022 20:19:58 +0000

Weapons

Weapons are one of the key parts of the engine. Without weapons you can't shoot things. Weapons here aren't just limited to infantry carried weapons, vehicles also use these too.

Parameter	Default	Description
Style	---	The weapon's holding style in third person. More details can be found below.
Model		The weapon's third person model. Usually this is in the form of w_.w3d
IdleAnim		???
FireAnim		???
BackModel		The model used for when the weapon is on the third person model's back. Usually this is in the form of w__b.w3d
SwitchTime	1.000	How long it takes to swap to and from this weapon, in seconds.
ReloadTime	0.000	How long it takes to reload the weapon, in seconds. PerBulletReload note: if this option is enabled,then this is how long it takes to do one reload cycle)
KeyNumber	0.000	What number key is used to select the weapon.
CanSnipe	false	Does this weapon have a sniper scope?
Rating	0.000	Unused.
EjectVelocity	2.000	The velocity of the ejected bullet casing
EjectRandomness	0.000	How random the ejected casing velocity is, plus or minus this number.
EjectTime	0.000	How long after firing is a casing ejected
EjectPhysDefID		Opens a window that allows you to define the casing model and such. More details are found below.
EjectIsShotgunShell	false	When the casing is ejected, will it make shotgun shell sounds (defined in SurfaceEffects.ini under _Shell Shotgun) when it hits the ground?
MuzzleFlashPhysDefID		Allows you to define a model for the muzzle flash.
FirstPersonModel		The model used for the first person view. NOTE: This must be named in the format F_GM_, and there are further dependencies. See for more information on view models.
FirstPersonOffset	0.000,0.000,0.000	The 3d offset of the first person view model.
RecoilImpulse	0.000	How much force will this weapon impart on the user when it fires.
HUDIconTextureName		Unused.
ReloadSoundDefID		What sound is played when the weapon is reloaded PerBulletReload note: if this is enabled, the reload sound will be played every reload cycle
EmptySoundDefID		What sound is played when the player tries to fire, but the weapon has no bullets (and can't reload).
SelectSoundDefID		What sound is played when the player selects this weapon?
DeselectSoundDefID		What sound is played when the player deselects this weapon?
PrimaryAmmoDefID		What does the weapon fire on a left click. Links to an Ammo definition. Required.
SecondaryAmmoDefID		What does the weapon fire on a right click. Links to an Ammo definition. This isn't required.
PrimaryFireMuzzleSetEditor	A	Which set of barrels does the primary fire come out of? (E.g MuzzleA, MuzzleB, etc. Put the letter of the muzzle set in)
SecondaryFireMuzzleSetEditor	B	Which set of barrels does the secondary fire come out of? (E.g MuzzleA, MuzzleB, etc. Put the letter of the muzzle set in)
BypassSameAmmoMuzzleSelectLogic	false	If a weapon has the same ammo set for both primary and secondary, then by default the code will automatically default to ignoring the secondary muzzle set. Set this to make the code instead use both sets of muzzles based on primary/secondary fire, rather than just using the same muzzle.
ClipSize	0	How many bullets does the weapon hold in one clip? -1 means the weapon can shoot infinitely with no reloading.
MaxInventoryRounds	100	How many bullets can the weapon hold to reload with. -1 means infinite reloads.
RecoilTime	0.1	How long will the gun's visual recoil take? For this, the muzzle on vehicles will recoil, and the character's arms and such will recoil.
RecoilScale	1.0	How far will the gun recoil? For this, the muzzle on vehicles will recoil, and the character's arms and such will recoil.
AGiveWeaponsWeapon	false	Will this weapon be granted to the player if the function SoldierGameObj::Give_All_Weapons is called? If the Allweapons console command is used and this is ticked, then this weapon will be given to the client the command points to.
IconNameID		What string is displayed in the hud in the weapon's information area?
IconTextureName		What icon is the weapon using.
IconTextureUV		Where on the IconTextureName texture is the icon? X1 is left, X2 is right, Y1 is top, Y2 is bottom.
IconOffset		How far is the icon offset from it's default position?
HumanFiringAnimation		What animation does the character use when they are firing this weapon?
ScopeTexture		If the weapon has a scope, what texture is used for the scope?
UniformScope	false	Will the scope texture be stretched to match the aspect ratio?
MaxZoom	0	How far in can the scope zoom?
MinZoom	0	What's the most zoomed out the scope can be?
GlobalFireSoundDefID		This sound will be played across the map when the weapon is fired.
AreaEffectWeapon	false	Does this weapon do AOE damage instead of firing a bullet?
AreaEffectWeaponAffectOwner	false	Does the AOE damage effect the owner?
AreaEffectWeaponAffectFriendly	true	Does the AOE damage effect friendlies?
AreaEffectWeaponAffectEnemy	true	Does the AOE damage effect enemies?
AreaEffectWeaponAffectNeutral	true	Does the AOE damage effect neutral objects?
SprayAddWalking	0	How much spray does jumping add to the weapon?
SprayAddWounded	0	How much spray does being wounded add to the weapon?
SprayAddWalking	0	How much spray does walking add to the weapon? (Note, this isn't running.)
SprayAddCrouching	0	How much spray does being crouched add to the weapon?
SprayAddSprinting	0	How much spray does sprinting add to the weapon?
Accuracy Recovery Rate (Movement) (deg/sec)	0.573	How much does the spray reduce each second?
Accuracy Recovery Rate (Weapon) (deg/sec)	-57.296	How much does the weapon's spray bloom get reduced by each second?
IsSuperweaponBeacon	true	Always true.
PerBulletReload	false	Each reload adds a single bullet to the magazine. If this is ticked, the weapon will reload to full, reloading one bullet (or more) at a time. Read the end of the document to find out how exactly this works, as there's a lot to it.
BulletsPerPBReload	1	How many bullets are added to the magazine per reload cycle, if PerBulletReload is enabled.
PBReloadStartTime	0	How much extra time is added to the reload if this is the start of the reload?
PBReloadEndTime	0	How much time does the end of the reload (after the magazine is filled with bullets) take?
PBReloadLoopFrame	0	What frame of the first person animation does the first person reload animation loop to?
PBReloadEndSoundDefID		What sound does the weapon play at the end of the reload, while it's finishing.
FirstPersonAnim		This tells the first person view model to use another weapon's animations. Must be entered in the form of F_GM_XXXX.
DoTiltWhileReloading	true	Does the third person model tilt down while reloading?
AllowEmptyShots	false	Can this weapon fire when the ammo is empty?
HideWhenEmpty	true	Can this weapon be selected if it's got no ammo?
IsCooldownAbility	false	Is this a weapon that goes on cooldown instead of reloading? (Uses Reload Time as Cooldown Time)
IsQuickCastAbility	false	Is this a weapon that fires upon being switched to and then switch back to the last held weapon?
AutoSwitchOnFire	false	Does the Cooldown Ability weapon switch to the last held weapon after firing?
AutoSwitchDelay	0.2	If the Cooldown Ability weapon auto switches after firing, how long should this switch be delayed by?
DelayedChargeFire	false	Can the charge bar or Cooldown Weapon be held with the fire key, to be fired upon releasing the fire key?
CannotFireWithoutLock	false	This weapon cannot fire without a lockon
RequireCrouch	false	When this weapon is equipped, the owner is forced to crouch
PostSprintSwitchTime		The time between coming out of a sprint and being able to fire the weapon
RecoilPattern	Arc	What pattern does the recoil use? Circle - Will go in a 360 direction around the aim point. Arc - Will go in a slice, with the direction in the RecoilBias direction.
RecoilSize	0	How big is the recoil?
RecoilBias	0,0.	What direction is the recoil? This is an X,Y axis.
RecoilRandProb	0	How often will the recoil go in a truly random direction instead of the RecoilPhysBias direction?
RecoilArcSize	0	How wide the arc of the "Arc" recoil pattern is, in degrees.
RecoilResist	0	How well can the recoil be "resisted" by the weapon. This reduces the effect of recoil, but doesn't reset the weapon when done firing.
RecoilResistMulJumping	1	Modifies the recoil resistance. Values greater than one make it worse, less than 1 make it better.
RecoilResistMulInjuring	1
RecoilResistMulCrouching	1
RecoilResistMulScoped	1
RecoilRecovery	0	This controls how quickly the weapon will return to it's original aim point.
RecoilFirstShotMultiplier	1	How much is the recoil strength multiplied on the first shot?
RecoilAimpointStatic	false	If this is enabled, then when the recoil hits the edge of the recoil range, then it will not travel any further. If disabled, this will continue to move the weapon up and shift the original aimpoint up as well.
UseGattlingLogic	false	If enabled, the weapon will spin up/down when firing, like a minigun. There are bones associated with this. (Check in Vehicle/Weapon rigging pages)
GattlingWarmUpTime	1.0	How long does the weapon take to spin up?
GattlingWarmDownMultiplier	1.0	This controls how long it takes the weapon to spin back down after stopping. If Warm up time is 1.0 and the Warm down multiplier is 0.5, then the weapon will take 2 seconds to spin down. If it is 2.0, then the weapon will take half a second to spin down.
GatlingMinimumContSoundPitch	1.0	What is the pitch of the ContinuousMotorSound when the gun is starting to spin?
GatlingMaximumContSoundPitch	1.0	What is the pitch of the ContinuousMotorSound when the gun is at full speed?
GatlingCannotFireWhileWarmingUp	false	Can the weapon fire while it's still spinning up to max RPM? (A Yuri's Revengesque Gatling weapon would be set to false, while a generic gatling from most other games would be set to true.)
GatlingSpinningStopsDuringReload	false	Does the weapon spin down during the reload process?
GatlingContinuousMotorSoundID		Controls what sound is playing when the gatling motor is spinning. This plays even if the weapon is not firing.

Ammo Parameters

Wed, 26 Jan 2022 20:21:07 +0000

A weapon cannot fire without an ammo type.

Parameter	Default	Description
Ammo Type	Normal	This determines if the ammo is just a regular bullet, or a type of C4 explosive.
ModelFilename		What is the W3D model that this projectile fires
ShouldPrelight	true	Does the bullet have dynamic lighting applied to it, or is it full bright?
Warhead	(can vary)	What warhead (from armor.ini) does the ammo have?
Damage	1.000	How much damage does the weapon do per shot?
DamageAfterFalloff	-1.000	After the weapon has gone beyond DamageFalloffRangeEnd meters, how much damage does it do? This is interpolated between the full damage and this damage in between DamageFalloffRangeStart and DamageFalloffRangeEnd. (Eg. A shot with Damage=10, DamageAfterFalloff=1, DamageFalloffRangeStart=25, DamageFalloffRangeEnd=75 will do 10 damage up to 25 meters, 5 damage at 50 meters and 1 damage at 75 meters and beyond.)
Range	10	How far (in meters) can this projectile go? The weapon actually goes about 20% further than this, however, if it uses a projectile. Hitscan weapons will stop exactly at this distance.
DamageFalloffRangeStart	-1.000	Where does the damage falloff start, in meters. If set to -1, then the weapon does not use falloff.
DamageFalloffRangeEnd	-1.000	Where does the damage falloff end, in meters. If set to -1, then the weapon does not use falloff.
EffectiveRange	10	What is the optimum range to use this weapon at? This is primarily used for AI bots.
TargettingRange	-1.000	At what range does the targeting box turn up? This is traditionally set 20% higher than the weapon's range, to make that match the ACTUAL range.
Velocity	1	How fast in m/s does the projectile go? Note: If a projectile is over a certain velocity (set in HitscanVelocityThreshold, in General under Global Settings>General in Mammoth, usually it's 1000m/s) then the projectile will be hitscan, and hit instantly.
ProjectileExtent	0.000, 0.000, 0.000	How big is the projectile? If it's all set to 0, then the projectile will be a point. Length, width, height.
IsDamageZone	false	If this is set, then the weapon that uses it will just "project" damage, in a ProjectileExtent zone in front of the muzzle. This damage will always hit.
Gravity	0.000	How much gravity does the projectile have, simulating a ballistic curve.
Elasticity	1.000	How "bouncy" is the projectile?
Rate of Fire	1.000	How fast does the weapon fire. This is in Rounds per Second, to convert to RPM, divide the RPM by 60.
SprayAngle	0.000	How wide is the weapon's cone of fire in degrees.
SprayAngleIncreasePerShot	0.000	How much does the spray angle increase after every shot?
MaxSprayAngle	0.000	What's the biggest the increased spray can be?
IgnoreSprayAngleIncrease	false	Does the gun ignore the increased spray angle?
SprayCount	1	How many shots per shot does the weapon fire? (A rifle will most likely fire 1 shot, a shotgun would fire multiple.)
SprayBulletCost	1	How many bullets out of the weapon's clip does this ammo use up per shot?
AquireTime	0.000	Unused
BurstDelayTime	0.000	If the weapon fires a burst, how long does it take between bursts? (A weapon could have a higher ROF with a longer burst, and a normal full auto mode with a normal ROF.)
BurstMax	0	How many shots constitute a burst? The gun will fire this many shots before stopping. (If the weapon is out of ammo during the burst, the gun won't fire after reloading.)
IsSemiAutomatic	false	IF set to true, then you will have to re-click every time you want to fire a shot.
SoftPierceLimit	0	If set up right, then a shot from this weapon will penetrate this many objects?
TurnRate	0	If the projectile is tracking, then it will turn this many degrees per second to try and hit it's target.
TimeActivate	false	If set to true, then the weapon will explode at the end of it's lifespan.
TerrainActivated	false	If set to true, then the weapon will explode when it hits the terrain.
ExplosionDefID		When the projectile explodes (if it reaches the end of it's travel or if it hits the terrain and the appropriate flags are set), this explosion will be spawned.
RandomTrackingScale	0.000	How far off the target will this projectile track to, roughly?
DisplayLaser	false	Creates a debug box between the the muzzle and the point the weapon would hit.
ChargeTime	0.000	How long does this ammo take to fire? Charge flags might need to be set.
ContinuousSoundDefID		This sound will play continuously while the weapon fires.
FireSoundDefID		This sound will play every time it fires.
FirstFireSoundDefID		This sound will play on the first shot of the burst.
ContinuousEmitterName		This emitter will be emitted from the muzzle continuously while the weapon fires.
MaxBounces	0	How many times will this projectile bounce off the terrain?
IgnoreCollisionWithParentOfOwner	false	Will the shots hit an object that is the parent of the firer? Useful for multi-turreted vehicles.
C4TriggerTime1	0.000	I honestly don't know what these do.
C4TriggerTime2	0.000
C4TriggerTime3	0.000
C4TriggerRange1	0.000
C4TriggerRange2	0.000
C4TriggerRange3	0.000
C4TimingSound1ID	0.000
C4TimingSound2ID	0.000
C4TimingSound3ID	0.000
C4DisallowSoldierAttach	false	Can this C4 be attached to soldiers?
C4IsMCTOnly	false	Can this C4 be attached only to MCT objects?
C4TransferDamageToAttachedObject	true	When another player shoots this object, does the damage pass through to the object that it is attached to?
C4PersonalLimit	0	The limit of C4s that one player can have in the world at one time. 0 = infinite.
C4DoTTickRate	4	The tick rate for damage over time C4 Objects. i.e. 4 = once every 4 seconds. Damage is set in the regular Damage field of the ammo preset.
AliasedSpeed	0.000	If a weapon's tracer or bullet projectile is clipping into the gun when firing, tweak this setting to offset the tracer object forwards to prevent clipping.
HitterType	Bullet	What surface effect does this bullet generate when it hits something?
BeaconObject		What beacon object does this ammo spawn when fired, if the weapon is a beacon?
BeamEnabled	false	Does this weapon have a bullet beam effect? (This is most useful on hitscan weapons.)
BeamColor	1.000, 1.000, 1.000	An RGB triplet for the beam colour, in 0-1 space. (To convert from regular RGB, divide the values by 255.)
BeamTime	0.300	How long does the beam last for?
BeamWidth	0.250	How wide is the beam, in meters?
BeamEndCaps	true	Does the beam taper off and finish at the ends of the beam?
BeamTexture		What texture does the beam have?
BeamSubdivisionEnabled	false	Does the beam subdivide and jink about? This is useful for electrical weapons, such as tesla weaponry.
BeamSubdivisionFrozen	false	Does the subdivision stay as is when it is generated? If true, what the beam starts as is how it stays, false and the beam will dynamically animate around.
BeamSubdivisionScale	1.000	How big is the subdivision? How much does it jink about?
IconNameID		Used in the HUD for displaying the weapon's current firing mode.
IconTextureName		Unused
IconTextureUV		Unused
IconOffset		Unused
GrenadeSafetyTime	0.000	If a projectile explodes, how long does it have to have been flying through the air before it will actually explode?
ProjectileAnimation	false	If the ammo's model has an animation, if this is ticked, it will be played as the projectile flies through the air. Useful for C4 with a timer animation on them.
Thrown C4 Preset		If this is C4, what is the C4 Preset that it uses to represent it?
DisableHitscan	false	If the ammo's velocity is above the hitscan threshold, having this ticked will ignore that threshold and instead create it as a physically simulated bullet as normal.
AutoAdjustMuzzlesOnEnemyTarget	false	If enabled, the muzzles of the weapon will point towards an enemy target, if that target is under the aiming reticule.
CanShatterMeshes	true	If disabled, this projectile will not shatter meshes that are set to "Shatter" in 3DS Max.
IsTracking	false	Does this ammo track (it will attempt to fly to the point under the reticule or the target under the reticule)?
TrackingIgnoreTarget	false	If set, the ammo won't track targets, it will only attempt to fly to the point under the reticule at fire time.
TrackingLockTime	0.000	How long does it take the weapon to lock? This is most useful with an appropriate texture set for a locking indicator in hud.ini.
UntrackTime	0.000	How long does a weapon stay locked, once locked? This is useful for fast movers that can't maintain a lock on for very long, and yet need to be locked on to a target.
RecoilStrength	0.000	How much recoil strength does this ammo type impart to the gun. See the recoil page for more details.
CanLockOnto...	All ticked	These tickboxes determine the type of vehicles that this ammo type can lock onto. This is based on the Type field in a vehicle object. There are 9 types: Car Tank Bike Aircraft_VTOL Turret Boat Sub Hover Aircraft_CTOL These are all fairly arbitrary, and need to be set up correctly in the vehicles to make sense. This is useful for something like a stinger missile, where it should only lock onto aircraft. (Combined with the CannotFireWithoutLock flag in the weapon, this can feel really nice.)

Weapon View Model Ammo Counters/C4 Timer Counter

Tue, 03 May 2022 21:08:31 +0000

This tutorial will cover both adding an ammo counter to a weapon (imagine the Halo Assault Rifle's ammo display), as well as adding a timer to the C4 object in the world, instead of having to use an animation to display the timer. It's simple, but does require some setup.

Setting up the Number Texture

The first step is creating a texture for the counters. It needs to have the numbers laid out in a grid format, like this:

0	1	2	3
4	5	6	7
8	9	-

The dash in the grid is for when a weapon is reloading. It could be any graphic, but a dash works well.

It doesn't matter if the texture has an alpha channel or not, that more depends on how the texture will be applied to the digit meshes in the model. A sample texture is included in the sample pack at the end of this post.

Setting up the W3D Material

One important part of the counter system is the material. You will need a W3D Material for this. Set up the material for how you want the texture to look on the weapon, including blending modes, vertex material colours, etc. There is one limitation: You can only use the Stage 0 texture for this (so no detail texture. However, you shouldn't need it.)

Once you have the rest of the material set up, it's time to set up the Stage 0 Mapping. Set the Type to Grid and fill in the Args box with this text:

FPS=0.0
Log2Width=2
Last=10
Offset=0

Once that is done, the material is ready, and it's time to set up the model part of this.

Setting up a weapon view model to have an ammo counter

Setting up a weapon to have an ammo counter requires up to 3 meshes to act as the digits (you can have two or even one depending on what you want the weapon to show.)

Apply the texture to the mesh, then make sure that the mesh you want the number to appear on is unwrapped so that the UVs only cover the zero on the number texture. Then name the 3 digits appropriately:

Name	Purpose
AmmoCH	Displays the hundreds digit (eg 123)
AmmoCT	Displays the tens digit (eg 123)
AmmoCO	Displays the ones digit (eg 123)

Included in the sample pack at the end of this post is an example weapon view model with the digits set up.

Setting up a C4 Timer

Setting up a C4 timer is much the same as setting up a view model ammo counter, just that the names that are used are different:

Name	Purpose
TIMERDTM	Displays the tens digit of the minutes on the display (eg 12:34)
TIMERDOM	Displays the ones digit of the minutes on the display (eg 12:34)
TIMERDT	Displays the tens digit of the seconds on the display (eg 12:34)
TIMERDO	Displays the ones digit of the seconds on the display (eg 12:34)

Included in the sample pack at the end of this post is an example weapon view model with the digits set up.

Sample Pack

AmmoCounterC4TimerSamplePack.zip

This sample pack contains the texture for the counter digits, as well as an example of the weapon ammo counter and C4 timers, in Max 2017 format.

The Counter Material is the material that is applied to the digits, to make them work.

19366083.tga