This mod for the HBS BattleTech game attempts to make battle damage tell a story. In the base game, certain units can be marked with a Poorly Maintained status. This reduces their armor, but has no other effects. This makes little sense from a lore perspective, where armor is often described as something easily salvaged and quickly applied, even in the field. Internal structure, weapons, and other components are much harder to repair in the field or to keep at a high state of repair. It should be more common to find enemies with damaged weapons, empty ammo bins, or decreased movement or accuracy. This mod implements a more lore-centric view by replacing the default behavior of the poorly maintained lance tags (spawn_poorly_maintained_25, spawn_poorly_maintained_50, spawn_poorly_maintained_75).

Units will never be spawned and immediately die. All effects ensure the unit won't be completely destroyed by any applied damage.

Each unit will have a status icon indicating what theme was applied, the strength of the effects, and any component or skill damage that was applied.

This mod has dependencies to the following mods. These are enforced through mod.json dependencies, and this mod will not load if they are not present.

• CustomComponents provides component categories
• MechEngineer provides Engine and Gyro customization
• IRBTModUtils provides common logging and utility functions

At the start of combat, a theme for the poorly maintained units are determined. A theme is determined for each faction on the battlefield. Your units can have one theme, your allies another, and the opposing force yet another. Each unit will have a status icon indicating what theme was applied, and the relevant effects that were applied. The theme determines what type of effects will be applied to the unit:

• Patched - the units recently participated in a battle and has yet to be fully repaired. Armor has been hastily scavenged and reapplied, though underlying structure damage has not. Some components and weapons may have been damaged or destroyed.
• Exhausted - the units have been on a long patrol or been through light skirmishes. Their ammo is depleted and their some armor damage will be present.
• Mothballed - the units were unused until recently. While structure and armor is intact, internal components are likely damaged or destroyed from their long storage.
• Scavenged - the units were pulled from a scrapyard and are heavily damaged.

Note that themes are completely customizable and can be user-defined. You are free to add whatever themes you like, by customizing the Theme Weights and providing a unique label. The only requirement is that the Theme Weights (MechWeights, VehicleWeights, TurretWeights) have exactly 10 effects.

Each theme is a unique weighting of different types of damage. At the start of combat, the mod rolls to determine how many damage 'hits' to apply to each unit. Each hit will be applied to one of the following damage types:

Important notes:

• Units can be rendered weaponless if they eliminate all but one ammo-using weapon, and the ammo-box was also damaged.

The default theme effects are listed below, where a + symbol represents one 'weight' on the scale. Damage types with more + symbols are more likely to happen than a damage type with a single +.

The value of the poorly maintained tag defines the number of damage effects that should be applied. Units can be tagged with spawn_poorly_maintained_25, spawn_poorly_maintained_50, and spawn_poorly_maintained_75, which correspond to a 25% armor reduction, 50% armor reduction, or 75% armor reduction in the vanilla game. In FieldRepairs each value is associated with a minimum and maximum number of damage rolls that will be applied. The table below provides the ranges provided by the default mod.json.

These values are configurable, and controlled through the mod.json setting DamageRollsConfig.MechRolls, DamageRollsConfig.VehicleRolls, and DamageRollsConfig.TurretRolls.

MechEngineer and Custom Components provide mod authors with significant flexibility. To accommodate the variety of mods available, FieldRepairs has to be configured to identity engine and gyro components for special processing. The CustomComponentCategories.Gyros and CustomComponentCategories.EngineParts values MUST be set to the values you specified for ME gyros and engine parts. If this is not set properly, engine components may be destroyed improperly and leave units crippled at the start of the game.

In addition, components that should NOT be damaged as part of FieldRepairs processing must be identified in the CustomComponentCategories.Blacklisted array. By default we assume that components with the CC Category "Armor", "Structure", "CASE", "PositiveQuirk", or "Cockpit" should not be destroyed and thus are excluded from processing.

Because it can be frustrating to find contracts that are marked with poorly_maintained tags, FieldRepairs includes an option to apply the tag in Skirmish matches. If the Skirmish.Tagvalue is non-null, FieldRepairs will apply it to any op-for unit in the match. This can be used to apply spawn_poorly_maintained_50 for instance and play with custom themes in a more controlled fashion.