[V3.0] Changes to item_modifiers.xml — Quality Levels 1–6 for MODs

item_modifiers.xml is the core file behind V3.0’s new feature: MOD quality levels (giving equipment/weapon/workstation MODs a quality of 1–6, with effects scaling in tiers).

1. MOD Quality Levels (most important)

A set of three new properties has been added to each item_modifier (roughly 103 places):

• ShowQuality="true" (displays quality stars)
• DisplayType (an identifier for quality display)
• QualityMin="1"

tiered="false" has been removed from effect_group, and passive_effect is now scaled using tier="1,2,3,4,5,6" plus a value array.

<passive_effect name="MagazineSize" operation="perc_add" value=".1,.2,.3,.4,.5,.6" tier="1,2,3,4,5,6"/>

• For tooltips, <display_value name="dXxx" value="…" tier="…"/> is specified separately
• DegradationMax now uses tag="modRanged" plus tier="1,6" interpolation, so MOD quality also affects a weapon’s maximum durability

2. Quality-Tier-Linked CVar Control

In onSelfEquipStart, the quality of the inserted MOD is evaluated with RequirementItemModTier (a new requirement), and CVars are set per tier. The value of RandomRoll is referenced dynamically, as in @$crippleChance.

3. Finer Subdivision of Attachment Category Tags

• Part of barrelAttachment has become barrelTipAttachment (separating muzzle-end items such as muzzles/suppressors)
• specialDamage → specialDamageAnimal and other special damage types have also been subdivided

Impact on MODs

• xpaths targeting item_modifier[@modifier_tags='barrelAttachment'] or effect_group[@tiered='false'] will miss due to the shift to barrelTipAttachment and the disappearance of the tiered attribute.
• set/replace operations that assume a single value on passive_effect will break when they hit the new value="a,b,c,d,e,f" tier=… array.
• If you add your own MOD, it won’t appear in the quality UI unless it follows the new convention (ShowQuality/DisplayType/QualityMin plus the tier array).

Reference: Example Diff

+       <property name="ShowQuality" value="true"/>
+       <property name="DisplayType" value="modGunMagazineExtender"/>
+       <property name="QualityMin" value="1"/>
-       <effect_group tiered="false">
-           <passive_effect name="MagazineSize" operation="perc_add" value=".5"/>
+       <effect_group>
+           <passive_effect name="MagazineSize" operation="perc_add" value=".1,.2,.3,.4,.5,.6" tier="1,2,3,4,5,6"/>
        </effect_group>

* Based on investigation immediately after applying the experimental build (equivalent to B252).

---

Related: List of MOD-making articles