• [Warhead_Types]
• [Armor_Types]
• [Soft_Armor]
• [Armor_Save_IDs]
• [Scale_...]
• [Shield_...]
• [Special_Damage_Type]
• [Special_Damage_Probability]
• [Special_Damage_...]
• [Impervious_...]
• [Visceroid_Probability] 

[Warhead_Types]

Warhead types is a list of the various warheads that your mod uses. The list starts from zero and is in the format below:

Example

[Warhead_Types]
0=None
1=Earth
2=Bullets
3=TankShell
4=FlamethrowerWarhead
5=BadFlamethrowerWarhead

[Warhead_Save_IDs]

This is simply the warhead types list, but with the number at the end, rather than at the beginning.

Example

[Warhead_Save_IDs]
None=0
Earth=1
Bullets=2
TankShell=3
FlamethrowerWarhead=4
BadFlamethrowerWarhead=5

[Armor_Types]

Armor types defines what different skins and shields that you have. The list is in the same format as Warhead_Types.

Example

[Armor_Types]
0=None
1=Blamo
2=InfantrySkin
3=FlakJacketArmor
4=FlameproofSkin

[Soft_Armor]

This list defines if a skin/shield can have an Ammo with a SoftPierceLimit greater than 0 penetrate straight through it. Both the unit's skin and shield type must be on this list if a shot is to go through. The list is in the same format as the Warhead_Types list.

Example

[Soft_Armor]
0=None
1=InfantrySkin

[Armor_Save_IDs]

This list is simply the Armor_Types list, but in the same, reversed format as Warhead_Save_IDs.

Example

[Armor_Save_IDs]
None=0
Blamo=1
InfantrySkin=2
FlakJacketArmor=3
FlameproofSkin=4

[Scale_...]

There are a number of Scale_... entries, one for each armor type that you have. Each entry has every type of warhead you have defined in Warhead_Types, with a number following which is the damage multiplier for that warhead towards that armor. A multiplier of 0 will do no damage, a multiplier of 1 will do full damage, a multiplier of 2 will do double damage, and so on.

Example

[Scale_InfantrySkin]
None=1
Earth=1
Bullets=1
TankShell=0.2
FlamethrowerWarhead=2
BadFlamethrowerWarhead=0.75

[Shield_...]

There are also a number of Shield_... entries. These entries aren't mandatory if you are only going to use the armor type as a skin, but if you are going to use it as a shield type, then these entries are required. Each entry has every type of warhead you have defined in Warhead_Types. The number that follows is the percentage of damage that the armor absorbs (and then gets removed from the armor bar). The remaining percentage gets removed from the health of the player.

A value of 0 will mean that damage from that warhead bypasses that shield type, a value of 1 means that the armor absorbs the damage fully.

Example

[Shield_FlakJacketArmor]
None=1
Earth=0
Bullets = 0.5
TankShell= 0
FlamethrowerWarhead= 0
BadFlamethrowerWarhead= 0.5

[Special_Damage_Type]

This block defines what special damage type a warhead has. For example, a flamethrower with a burning effect would have a special damage of type Fire, etc. Warheads don't require this.

Example

[Special_Damage_Type]
FlamethrowerWarhead=Fire
BadFlamethrowerWarhead=WeakFire

[Special_Damage_Probability]

This block defines how the percentage chance that a warhead will deal special damage. 1 means it will always deal it, 0 means it will never, etc. 

Example

[Special_Damage_Probability]
FlamethrowerWarhead=1
BadFlamethrowerWarhead=0.25

[Special_Damage_...]

There are a number of special damage entries, one for each type of special damage you have defined. Warhead defines what warhead the special damage does, duration is how long it lasts for in seconds, and Scale is damage multiplier for the special damage. (The original weapon's per shot damage is multiplied by this, and applied over the period of time.)

Example

[Special_Damage_Fire]
Warhead=None
Duration=5
Scale=1

[Special_Damage_WeakFire]
Warhead=None
Duration=2.5
Scale=0.5

[Special_Damage_HealingOverTime]
Warhead=MedicalWarhead
Duration=5
Scale=-10

[Impervious_...]

With this, you can make certain armor types impervious to special damage. Note that the unit's skin type is what's checked for imperviousness, not the shield type.

Example

[Impervious_Fire]
0=None
1=Blamo
2=FlameproofSkin

[Visceroid_Probability] 

This defines the percentage chance that a killing shot from this warhead will create a Visceroid. If a warhead isn't listed, then it will never make a Visceroid. This will usually be unused. The type of object that will be created can be set, however, in the "Global Settings>General>General" Preset, under VisceroidName.

Example

[Visceroid_Probability]
NastyChemicalWeapon=1
NotSoNastyChemicalWeapon=0.25

Each entry needs a name in square brackets (e.g. [GDI Construction Yard]), then these items:

Example

[Profile_List]
0=Default
1=Sniper
2=First_Person
3=Death
4=APC
5=Ranger
6=Allied_Artillery
7=Arty_Side
8=Arty_Side2

Following that are sections which define the parameters of these cameras:

Example

[Default]
Name=Default
TranslationTilt=22.5
ViewTilt=0
Distance=1.5
Height=1.4
FOV=90
LagUp=0.2

There are five hard coded cameras that must be defined: Default, First_Person, Death, Sniper, Cinematic (the last one is optional for MP games).

In Mammoth, the cameras can then be applied to vehicle presets using the Profile and Alt. Camera Profiles settings:

Profile Parameters

All angular values are specified in degrees, distances in world space meters. Take note that the default values are not 0 for many of these parameters. This is especially important if you want to use OriginOffsetUp instead of Height.
In W3D Engine version 5.0, the parameters can be changed at runtime using the edit_camera console command (only works on a listen server with max player count 1, will not save the changes to cameras.ini).

^†Added in W3D Engine version 5.0

The following is a comparison video of using Forward/Sideways (first half of the video) vs OriginOffset (second half). For side views like the ones of the Artillery, OriginOffset feels a bit weird because the camera pivots around empty space and the pivot is moving in a circle along the model orientation when you drive around. Turret cams are what OriginOffset was intended for, which is clearly visible in the Cruiser example, where side cams are woefully inadequate.

Each entry needs a name in square brackets (e.g. [GDI Light Infantry]), then these items:

The Hud.ini is the main editable .ini text file that creates the colors and placements for all the HUD (Heads Up Display) you see in-game. While it typically utilizes .dds files inside the always.dat as well.. the hud.ini is the main part where a lot of the settings including color (Which follows the RGB code of numbers 0-255) of the HUD can be edited.

There are a lot of HUDs created for different games across the W3DHub game spectrum including A Path Beyond and of course Renegade itself. However, should you choose to transfer one HUD meant for Renegade to A Path Beyond you will typically have to adjust the settings to accommodate the new game layout. Furthermore be aware that when crossing HUDs into different games a certain script may be needed to make said HUD work at all.

Explanation of a basic Hud.ini

[General] Section

NodHouseRed=int (Nod color for chat messages, goes from 0 to 255)
NodHouseGreen=int (Nod color for chat messages, goes from 0 to 255)
NodHouseBlue=int (Nod color for chat messages, goes from 0 to 255)
GDIHouseRed=int (GDI color for chat messages, goes from 0 to 255)
GDIHouseGreen=int (GDI color for chat messages, goes from 0 to 255)
GDIHouseBlue=int (GDI color for chat messages, goes from 0 to 255)
PrivateMessageRed=int (private message color for chat messages, goes from 0 to 255)
PrivateMessageGreen=int (private message color for chat messages, goes from 0 to 255)
PrivateMessageBlue=int (private message color for chat messages, goes from 0 to 255)
PublicMessageRed=int (public message color for chat messages, goes from 0 to 255)
PublicMessageGreen=int (public message color for chat messages, goes from 0 to 255)
PublicMessageBlue=int (public message color for chat messages, goes from 0 to 255)
TitleColor=color (changes UI colors)
TitleHilightColor=color (changes UI colors)
TextColor=color (changes UI colors)
TextShadowColor=color (changes UI colors)
LineColor=color (changes UI colors)
BkColor=color (changes UI colors)
DisabledTextColor=color (changes UI colors)
DisabledTextShadowColor=color (changes UI colors)
DisabledLineColor=color (changes UI colors)
DisabledBkColor=color (changes UI colors)
HilightColorBkColor=color (changes UI colors)
TabTextColor=color (changes UI colors)
TabGlowColor=color (changes UI colors)
DialogTextTitleColor=color (changes UI colors)
DialogTextTitleGlowColor=color (changes UI colors)
MenuHiliteColor=color (changes UI colors)
MerchandiseTextColor=color (changes UI colors)
MenuStaticGlowColor=color (changes UI colors)
MenuActiveGlowColor=color (changes UI colors)
MenuPushedBaseGlowColor=color (changes UI colors)
MenuPushedHighlightGlowColor=color (changes UI colors)
ListColumnColorEnabled=bool (whether to change the list column color)
ListColumnColorRed=int (list column color, goes from 0 to 255)
ListColumnColorGreen=int (list column color, goes from 0 to 255)
ListColumnColorBlue=int (list column color, goes from 0 to 255)
HidePlayerList=bool (hide the player list)
HideBottomText=bool (hide the time and credits text)
LodBudgetDialogValue1=int (value to use for lower LOD budget position on the config dialog)
LodBudgetDialogValue2=int (value to use for higher LOD budget position on the config dialog)
CenterMainMenu=bool (whether to center the main menu)
WinScreenGDIColor=color (color to use for GDI on the win screen)
WinScreenNodColor=color (color to use for Nod on the win screen)
HideHelpScreenKeys=bool (hides the key text on the help screen
HideWeaponBox=bool (hide the weapon box)
HideInfoBox=bool (hide the info box)
HideCenter=bool (hide the centre bits)
HidePowerupIcons=bool (hide the powerup icons)
WeaponChartColor=color (color for the weapon chart icons
WeaponChartEmptyColor=color (color for the empty weapon chart icons)
DecalLimit=int (decal limit)
MaxStaticLODBudget=int (max static lod budget)
MaxDynamicLODBudget=int (max dynamic lod budget)

[Team HUD] Section

Enabled=bool (enable per-team hud stuff)

[Crosshair] Section

This section documents the crosshair displacement tech, which is used to move the crosshair when weapon spread is applied by any of the following settings in a weapon and/or ammo preset (see image to the right).

This section was written by @ OWA

Spray Settings

Weapon Settings

Ammo Settings

*The spray penalties are calculated in radians in the engine, so the multipliers are pretty large. An example calculation:
 

SprayAddJumping      = 3.25 deg (~0.057 rad)
SprayAngle           = 0.75 deg (~0.013 rad)
OffsetMultiplier     = 600
SprayAngleMultiplier = 300
DistanceFromCenter   = 2 pixels
Resulting Offset     = 600 * 0.013 + 300 * 0.057 + 2 = 26.9 pixels

Diagram

[Crosshair]
Enabled=true
Up_Left=30
Up_Top=43
Up_Right=34
Up_Bottom=57
Down_Left=30
Down_Top=7
Down_Right=34
Down_Bottom=21
Left_Left=7
Left_Top=30
Left_Right=21
Left_Bottom=34
Right_Left=43
Right_Top=30
Right_Right=57
Right_Bottom=34
DistanceFromCenter=2
OffsetMultiplier=600
AddSprayAngle=true
SprayAngleMultiplier=300

Todo

Hud.ini stuff I can't document, @ Romanov  will probably be able to help with this given his rewrite of hud.ini and all the work he did in adding things to it:

Colors, TextureQuads, Bullet, Clip, WeaponText, WeaponImage, HealthBar, ShieldBar, HealthText, ShieldText, Compass, Credits, TimeRemaining, HealthIcon, ShieldIcon, VeterancyBar, VeterancyText, VeterancyIcon, SprintIcon, BurnIcon, CooldownHUD, ElectricfiedIcon, ChemIcon, Radar, WeaponChargeBar, SneakIcon, SuperweaponTimer, BuildingHealth, Mines, TrackingLock, Target Box Shield Bar, Target Ctrl settings.

Also the ObjectiveMarker stuff (AR only)

RegBase=string (sets base registry path)
RegClient=string (sets client registry path)
RegFDS=string (sets FDS registry path)
FileBase=string (sets base file path)
FileClient=string (sets client file path)
FileFDS=string (sets FDS file path)
UseRenFolder=bool (set this to use the renegade folder for data storage instead of the documents folder)
ConfigExe=string (exe file to load for configuration instead of wwconfig.exe)

There are also three more sections called "Bullet_Stopping", "Damage_Warhead" and "Damage_Rate".

Surface Types:

• Light Metal
• Heavy Metal
• Water
• Sand
• Dirt
• Mud
• Grass
• Wood
• Concrete
• Flesh
• Rock
• Snow
• Ice
• Default
• Glass **
• Cloth
• Tiberium Field
• Foliage Permeable
• Glass Permeable **
• Ice Permeable
• Cloth Permeable
• Electrical
• Electrical Permeable
• Flammable
• Flammable Permeable
• Steam
• Steam Permeable
• Water Permeable
• Tiberium Water
• Tiberium Water Permeable
• Underwater Dirt
• Underwater Tiberium Dirt
• Blue Tiberium *
• Red Tiberium *
• Tiberium Veins *
• Laser *

* Scripts 5.0 only

** Surface types "Glass" and "Glass Permeable" are special in that they are the only ones able to apply decals to transparent meshes and they will also not be applied to neighboring objects if you hit near the edge between them (unfortunately does not discriminate between individual meshes that are part of an object). This is currently hard coded.

Hitter Types:

• None
• Generic Object
• Footstep Run
• Footstep Walk
• Footstep Crouched
• Footstep Jump
• Footstep Land
• Bullet
• Bullet Fire
• Bullet Grenade
• Bullet Chem
• Bullet Electric
• Bullet Laser
• Bullet Squish
• Bullet Tib Spray
• Bullet Tib
• Bullet Shotgun
• Bullet Silenced
• Bullet Sniper
• Bullet Water
• Eject Casing
• Shell Shotgun
• Tire Rolling
• Tire Sliding
• Track Rolling
• Track Sliding
• Footstep Ladder ***

*** This is hard coded to hit the "Light Metal" surface type whenever you are stepping up/down a ladder, so you do not need to specify its effects for each surface type (unless you for some reason decide to make an ammo preset with this hitter type).

[Bullet_Stopping]

This section sets whether a given surface type stops bullets when hit. If there is no entry for a surface type, it defaults to true.

Example

[Bullet_Stopping]
Cloth=true
Cloth Permeable=false
Concrete=true
Default=true
Dirt=true
Electrical=true
Electrical Permeable=false

[Damage_Warhead]

This section determines the damage warhead (see armor.ini) of the given surface type. Shown below is a specific example from APB that handles barbed wire and water damage.

Example

; Water = water surface (instakills helicopters)

; Underwater Tiberium Dirt = underwater surface (minor damage to vehicles; the main bulk of the damage is dealt by the water script zone, for vehicles that are fully submerged in deep water)

; Tiberium Water = top of barbed wire fence (hurts infantry only, not so lethal to those with armour)

; Tiberium Field = places infantry should not be able to access, like un-laddered rooftops (instant death)

[Damage_Warhead]
Water=AntiAircraft2
Water Permeable=AntiAircraft2
Underwater Tiberium Dirt=Water
Tiberium Water=Splash
Tiberium Field=Splash

[Damage_Rate]

This section determines the damage caused per second when touching the given surface type.

Example

[Damage_Rate]
Water=9999.0
Water Permeable=9999.0
Underwater Tiberium Dirt=15.0
Tiberium Water=30.0
Tiberium Field=9999.0

[SurfaceTypeName_HitterTypeName]

This section determines the effects created when "HitterTypeName" hits/touches "SurfaceTypeName".

Note that there can be an arbitrary number of entries named Sound/Emitter/Decal by adding a number N at the end of the entry name. Numbers must start at 0 and must be contiguous. The game will pick one of these entries at random each time the effect is spawned.

* Only applies to hitter types "Generic Object", "Tire Rolling" and "Track Rolling". Generic objects currently only apply friction (not drag), tracked vehicles currently do not apply either friction or drag.

Example

[Wood_Bullet Silenced]
Sound0=Wood Ricochet Sounds Twiddler
Emitter0=e_wdblt
Duration=3
Decal0=D_BH_s_wood1.tga
Decal1=D_BH_s_wood2.tga
Decal2=D_BH_s_wood3.tga
DecalSize=0.05
DecalSizeRandom=0.01

ContinueReloadOnVehicleExit=bool (enables reloading to continue when vehicles are empty)

VehicleOwnershipDisable=bool (disables the stock Renegade vehicle locking feature to allow e.g. spies to be able to steal vehicles)

VehicleBuildingDisable=bool (changes how the code determines if a factory is busy, if you have naval/air or you have the sidebar, you will want this off)

DisableVehicleFlipKill=bool (disables the killing of vehicles when they flip over)

MapPrefix=string (changes the map prefix for multiplayer maps from the default of C&C_ to something else)

NeutralVechiclePointsFix=bool (ensures you get points for killing a vehicle even if the players get out of it)

DrawDistance=float (changes the distance at which stuff gets drawn, also changes matching things in the netcode)

ScriptsLastTeamTime=int (sets how long the vehicle will remain teamed after you get out of it, set to -1 for infinite time)

NukeWeatherDisable=bool (disable weather effects for the nuke beacon)

IonWeatherDisable=bool (disable weather effects for the ion beacon)

CreditsMultiplier=float (multiplier for how many credits you get for every one score value you get)

DisableOnFire=bool (disables some "when you are on fire, you can't shoot" code for soldiers)

MultiplayerTutorialEnable=bool (makes the tutorial run in a special version of skirmish mode rather than in single player mode)

MultiplayerTutorialTeam=int (what team the player should be in the multiplayer tutorial mode)

StreamedSoundBufferSize=int (controls the size at which a sound becomes a streamed sound, you can only have one streamed sound playing at once)

ScriptZoneDebug=bool (enable this to make script zones visible in-game for debugging purposes)

SectorDebug=bool (enable this to make pathfind sectors visible in-game for debugging purposes)

PortalDebug=bool (enable this to make pathfind portals visible in-game for debugging purposes)

PathfindingDebug=bool (enable this to make pathfind web paths visible in-game for debugging purposes)

HUDDebug=bool (enable this to show HUD element extensions in-game for debugging purposes)

DialogDebug=bool (enable this to show dialog element extensions in-game for debugging purposes)

StealthShader=string (shader fx file to use for the stealth effect)

UndergroundShader=string (shader fx file to use for the underground effect)

NewUnpurchaseableLogic=bool (special case logic if you are using the old PTs and are using certain features related to air and naval, chances are you want this enabled)

RefillLimit=float (limits how often you can refill)

DisableKillMessages=bool (disables the stock kill messages if you have custom ones instead)

DisableSP=bool (disables the "single player" button from working)

HidePassengerRadarIcons=bool (hides icons for vehicle passengers on the radar)

LoadingMusic=string (sets the music track for when a player is loading)

OverrideHelpWithNewEncyclopedia=bool (if set to true, replaces the help menu with a version of the old SP encyclopedia)



SidebarHUDEnabled=bool (set this to false to disable the rendering of the HUD while the ingame sidebar is open)

SidebarDescriptionCostEnabled=bool (set this to true to show the cost of the selected unit in the sidebar, next to the description, uses IDS_MERCH_DESCRIPTION_COST for translation)

SidebarBuyButtonEnabled=bool (set this to true to show an exclusive buy button on the sidebar)

SidebarShowCredits=bool (set this to true to show an extra text near the sidebar that shows the current credits of the player, uses IDS_HUD_CREDITS for translation)

GDIBuyTexture=string (texture to display on the buy button for team 1)

NODBuyTexture=string (texture to display on the buy button for team 0)

SidebarCostsEnabled=bool (set this to false to disable showing the costs of merch items)

SidebarNamesEnabled=bool (set this to true to enable showing the names of merch items)

SidebarCustomCostsEnabled=bool (set this to true to enable showing the costs of merch items in the top right corner of the merch boxes, uses IDS_MERCH_COST for translation)

SidebarCustomNamesEnabled=bool (set this to true to enable showing the names of merch items in the bottom center of merch boxes)

SidebarExtraSlotsEnabled=bool (set this to true to enable 10 merchandise slots instead of the default 8 slots)

GDITabTexture1=string (texture to display on the tabbed sidebar's 1st button for team 1, change number from 1 to 2/3/4 for the other tabs)

GDITabTexture1Selected=string (texture to display on the tabbed sidebar's 1st button for team 1 if active, change number from 1 to 2/3/4 for the other tabs)

NODTabTexture1=string (texture to display on the tabbed sidebar's 1st button for team 0, change number from 1 to 2/3/4 for the other tabs)

NODTabTexture1Selected=string (texture to display on the tabbed sidebar's 1st button for team 0 if active, change number from 1 to 2/3/4 for the other tabs)

Each entry needs a name in square brackets (e.g. [GDI Titan]), then these items:

Each entry needs a name in square brackets (e.g. [M16 Mk 2 Pulse Rifle]), then these items:

[General]
GDIWinBanner=HUD_GDIWINBAN (w3d file to use for the GDI win banner, no .w3d on the end)
NodWinBanner=HUD_NODWINBAN (w3d file to use for the Nod win banner, no .w3d on the end)
LoadingMusic=filename
OverrideNightTime=bool (set this to true to cause it to be night time no matter what the actual time is set to)

[CustomBackdrop]

Works just like campaign.ini backdrop settings (documentation on how this works needed)

; You can specify a 'color' in two ways:

; 1. Separate Red/Green/Blue components:

;    SkyColorRed=112

;    SkyColorGreen=146

;    SkyColorBlue=176

; 2. Hex color (ARGB):

;    SkyColorHex = 0xFF7092b0

[SkyColors]
OverrideSkyColors=bool (enable this to override the sky colors)
WarmSkyColor=color (Warm sky color - Clouded sky's additional, color around the sun)
ColdSkyColor=color (Cold sky colors - Clouded sky's additional color everywhere else + Fog color (bottom skydome))
SunColor=color (Sun color)
SunHaloColor=color (Sun halo color)
MoonHaloColor=color (Moon halo color)
SkyColor=color (Sky color (top skydome))
GloominessColor=color (Cloud gloominess color)
StarfieldAlpha=int (Star field transparency, 255 - Stars appear (good for clear sky night time); 0 - No stars)

; These are the defaults.

Textures for sky settings:
[SkyTextures]
StarTexture=Star.tga
LightningTexture=LightningBolt.tga
LightningSource=LightningSource.tga
SunTexture=Sun.tga
SunHaloTexture=SunHalo.tga
MoonHaloTexture=MoonHalo.tga
CloudTexture=CloudLayer.tga
MoonTexture1=FullMoon.tga
MoonTexture2=PartMoon.tga
EarthTexture1=FullEarth.tga
EarthTexture2=PartEarth.tga

Thunder sounds
[ThunderSounds]
ThunderSound1=Thunder01
ThunderSound2=Thunder02
ThunderSound3=Thunder03
ThunderSound4=Thunder04
ThunderSound5=Thunder05
ThunderSound6=Thunder06
WarBlitzSound=SFX.Ambient_Explosion_01

Weather textures
[WeatherTextures]
WeatherTexture=WeatherParticles.tga

Weather sounds
[WeatherSounds]
WindSound=Wind01
RainSound=Rainfall01

All sounds set in this ini file are sound preset names and should work as twiddlers. Although the sounds are loaded once when the level is loaded or the weather settings get changed by e.g. a script command (at least for the thunder, wind and rain sounds, war blitz sound is weird and I don't fully understand that one)

[General] section
AirFactoryVehicleLimit=int (vehicle limit for air factories)
NavalFactoryVehicleLimit=int (vehicle limit for naval factories)
VehicleFactoryVehicleLimit=int (vehicle limit for vehicle factories)
LowPowerDamageScale=float (when buildings are damaged and power is off, the damage is scaled by this amount)
UseExtraPTPages=bool (enables the extra "secret" pages on the PT, not relavent for the sidebar)
BuildingRefillDisable=bool (enable this to allow you to require a specific building in order to refill. If the building doesn't exist on the map or its alive, refill works, otherwise its disabled)
NodBuildingRefillDisable=string (building controller preset for Nod for the above feature)
GDIBuildingRefillDisable=string (building controller preset for GDI for the above feature)
NoPowerCostMultiplier=float (what to multiply purchase costs by when the power is low)
BuildTimeDelay=float (what to multiply build time by when the power is low)
NewTechLevel=bool (enable the new tech level and factory stuff that works through settings on the presets)
VisceroidEnable=bool (enable the Visceroid Probability stuff in armor.ini that might spawn a Visceroid when you die)
OverrideMuzzleDirection=bool (let AI infantry aim their muzzles like player infantry do)
GDIUpArrowTexture=string (texture for the up arrow on the GDI sidebar)
GDIDownArrowTexture=string (texture for the down arrow on the GDI sidebar)
GDIBackgroundTexture1=string (texture for the background upper part on the GDI sidebar)
GDIBackgroundTexture2=string (texture for the background lower part on the GDI sidebar)
NODUpArrowTexture=string (texture for the up arrow on the Nod sidebar)
NODDownArrowTexture=string (texture for the down arrow on the Nod sidebar)
NODBackgroundTexture1=string (texture for the background upper part on the Nod sidebar)
NODBackgroundTexture2=string (texture for the background lower part on the Nod sidebar)
Sidebar=bool (whether to enable the sidebar)
SidebarSoundsEnabled=bool (whether to enable the sidebar sounds)
SidebarRefillSound=string (sound to use when purchasing refill on the sidebar)
SidebarRefillSoundNod=string (sound to use when purchasing refill on the Nod sidebar)
SidebarRefillSoundGDI=string (sound to use when purchasing refill on the GDI sidebar)
SidebarInfantrySound=string (sound to use when purchasing infantry on the sidebar)
SidebarInfantrySoundNod=string (sound to use when purchasing infantry on the Nod sidebar)
SidebarInfantrySoundGDI=string (sound to use when purchasing infantry on the GDI sidebar)
SidebarVehicleSound=string (sound to use when purchasing vehicles on the sidebar)
SidebarVehicleSoundNod=string (sound to use when purchasing vehicles on the Nod sidebar)
SidebarVehicleSoundGDI=string (sound to use when purchasing vehicles on the GDI sidebar)
SidebarRefillEnabled=string (enable refill on the sidebar)
SidebarTabsEnabled=string (enable tabs on the sidebar)
TabCharacters=int (what tab to put infantry on)
TabCharactersSecret=int (what tab to put secret infantry on)
TabVehicles=int (what tab to put vehicles on)
TabVehiclesSecret=int (what tab to put secret vehicles on)
TabAir=int (what tab to put air vehicles on)
TabAirSupplemental=int (what tab to put supplemental air vehicles on)
TabNaval=int (what tab to put naval vehicles on)
GDISidebarPowerOnTexture1=string (sidebar power on texture for GDI)
GDISidebarPowerOnTexture2=string (sidebar power on texture for GDI)
GDISidebarPowerOffTexture1=string (sidebar power off texture for GDI)
GDISidebarPowerOffTexture2=string (sidebar power off texture for GDI)
NODSidebarPowerOnTexture1=string (sidebar power on texture for Nod)
NODSidebarPowerOnTexture2=string (sidebar power on texture for Nod)
NODSidebarPowerOffTexture1=string (sidebar power off texture for Nod)
NODSidebarPowerOffTexture2=string (sidebar power off texture for Nod)
GDITabTexture1=string (sidebar tab 1 texture for GDI)
GDITabTexture2=string (sidebar tab 2 texture for GDI)
GDITabTexture3=string (sidebar tab 3 texture for GDI)
GDITabTexture4=string (sidebar tab 4 texture for GDI)
NODTabTexture1=string (sidebar tab 1 texture for Nod)
NODTabTexture2=string (sidebar tab 2 texture for Nod)
NODTabTexture3=string (sidebar tab 3 texture for Nod)
NODTabTexture4=string (sidebar tab 4 texture for Nod)

The new updated weather system operates differently in two primary ways; by introducing more customization capabilities on a per-map basis, and by introducing the capability of rendering surface level weather VFX.

The primary means of assigning a weather type to a level (rain, snow, ash) remains unchanged, via Mammoth.

New Per-Map Options

Your map-specific INI files (the same file containing skybox information and a couple of other things), now also contain new parameters for weather related settings, as well as a few additional skybox settings. 

All the new settings, including their default values, are seen here in this example:

[SkyTextures]
MoonTexture1=FullMoon.dds
MoonTexture2=PartMoon.dds
EarthTexture1=FullEarth.dds
EarthTexture2=PartEarth.dds
SunTexture=Sun.dds
SunHaloTexture=SunHalo.dds
MoonHaloTexture=MoonHalo.dds
CloudTexture=CloudLayer.dds
StarTexture=Star.dds
LightningTexture=LightningBolt.tga
LightningSource=LightningSource.dds

[WeatherTextures]
WeatherTexture=weatherparticles.dds

; Sounds look for presets by name, not audio files.
[ThunderSounds]
ThunderSound1=Thunder01
ThunderSound2=Thunder02
ThunderSound3=Thunder03
ThunderSound4=Thunder04
ThunderSound5=Thunder05
ThunderSound6=Thunder06
WarBlitzSound=SFX.Ambient_Explosion_01

[WeatherSounds]
WindSound=Wind01
RainSound=Rainfall01

[WeatherEffects]
; When a weather particle hits the ground, it will generate a random
; number between 0 and 1000 and if that number is less than
; WeatherEffectChance, it will trigger the "weather effect".
; See surfaceeffects.ini for weather hitter type data.
; Value from 0 to 1000.
WeatherEffectChance=750

; Area size around the camera to render weather in.
RainSize=20.0
SnowSize=40.0
AshSize=40.0

New Surface Effects

In order to generate the new client-side localized weather VFX, you need to update your surfaceeffects.ini with additional hitter type entries for each weather type (rain, snow, ash). Once you have listed your weather hitter types, you can then assign VFX to them like you would any other hitter type. 

Below is an example for the Rain hitter type:

;    Weather Effects
;    RAIN

[Light Metal_Rain]
Emitter0=e_rainspla
Emitter1=e_rainsplb

[Heavy Metal_Rain]
Emitter0=e_rainspla
Emitter1=e_rainsplb

You can do the same for the other weather hitter types.

Bonus tip: If your project has an unused weather type (most likely Ash), you can remove the ash texture from weatherparticles.dds and then use that weather to, for example, create wind effects in a sandy map.