File information

Last updated

Original upload

Created by


Uploaded by


Virus scan

Safe to use

Tags for this mod

About this mod

Fixes, enhances, and customise your combat experience while maintaining vanilla balance. Such as coloured facing rings and targeting lines, tune down roll correction, show distance numbers, or a detailed attack log.

Permissions and credits
AIM is a BattleTech mod that fixes, enhances, and customise your combat experience, such as coloured facing rings and targeting lines,
tune down roll correction, show distance numbers, or a detailed attack log. The default settings aim to preserve the balance of vanilla game.

This mod does not modify game data. Saves made with this mod on will not be affected by disabling or removing this mod.
ALL features can be enabled or disabled individually.

Bug Fixes and HUD Enhancements
  • Grey head disease fixed.
  • Line of fire fixed and stylised: Dotted = indirect, Cyan = flank, Green = rear.
  • Coloured facing ring and floating armour bar.
  • Damaged Structure Display fixed and enhanced.
  • Multi-Target Back Out fixed.
  • Make sure 0 HP means dead, never zombie.
  • Show heat, instability, distance, and movement numbers.
  • Show ammo count in paper doll hover.
  • Show base hit chance in accuracy modifier popup.
  • Show mechwarrior stats in hover/right-click hint.
  • Post-move to-hit penalties and heat factored in action preview.
  • (Optional) Show Mech Tonnage.
  • (Optional) Show Corrected Hit chance and Called Shot Chance.

Mechanic Enhancements
  • Unlock hit chance stepping (make odd Gunnery useful).
  • Called shots cluster around called mech location.
  • Precise hit distribution that improves SRM and MG called shot.
  • More melee modifiers, and fixes the absent of stood up penalty.
  • Flank and rear attack Bonus.
  • Allow net bonus hit modifiers.
  • Allow negative height modifier.
  • Remove melee position locking.
  • Ammo loader AI that balance ammo usage to minimise explosion.
  • Auto jettison useless ammo.

New Critical Hit System
  • Skip criting the dead mechs.
  • Vehicle and turret critical hits.
  • Critical hits follow damage transfer.
  • Prevent critical hit on locations with intact structure.
  • Give normal crit chance to NPC allies. Enemies adjustable.
  • (Optional) Adjust normal critical hit chances and mix/max cap.
  • (Optional) Allow Through Armour Critical hit (TAC).
  • (Optional) Allow critical hit reroll and location transfer.
  • (Optional) Allow multiple critical hits per weapon.

Other Adjustables
  • Tabular attack log that can be opened directly in Excel.
  • Old attack logs are archived and auto-deleted in background.
  • Adjustable roll correction strength, default halved.
  • Adjustable miss streak breaker.
  • Adjustable base hit chances.
  • Adjustable hit chance stepping and min/max cap.
  • Adjustable attack modifier list.
  • Control display precision of hit chance and called shot chance.


  1. Make sure game is version 1.3.
  2. Install BTML and ModTek.
  3. Extract this mod into a new folder in the mod folder.  e.g. you should have BATTLETECH\Mods\AttackImprovementMod\mod.json
  4. Launch the game. The mod will creates a "settings.json" and a mod log in the same folder as mod.json.
  5. Open settings.json to see mod settings. If you want to change it, restart game to apply changes.

A more detailed readme, explaining the effect of each settings and what code they affects, can be read on GitHub and is included in the package.