Show Mech Affinity
⚪ Last updated 2024⚠️ Install Order · 1 step
Install in this order, then this mod last — most mods fail to load without their framework and dependencies in place.
Preview

🔍 Analysis
- 👍 4.6% endorsement rate — high engagement, a strong quality signal
- 🏆 #10 of 27 User Interface mods in this game by downloads
📋 About This Mod
Mech Affinity Verison 1. 4 Incompatibility
Currently this mod is not compatible with Mech Affinity version 1. 4+. The changes between 1. 3 and 1. 4 are enough to require a re-write to support.
If BEX upgrades to 1. 4, I may come back and update this. Alternatively, if there is enough demand, I could come back and address this.
If someone is interested in doing the re-write for 1. 4+, feel free to use this source code or push to the GitHub repository listed later in this document.
Battletech Show Mech Affinity
An extension for the Mech Affinity mod. This mod shows which pilots have an affinity with a specific chassis.
Rather than searching pilots for chassis affinity via the tool tips, the pilot list will be colored and sorted by level of affinity for the selected mech.
Usage
When in the contract loadout screen, click on a mech and all the pilots will have their rank icon changed to a color based on the pilot's affinity.
The pilots on the right of the screen will also be sorted by the number of drops with the selected mech and then by name.
Default Affinity Colors:
| Affinity level | color |
| --------------- | ------ |
| No Affinity (0) | Black |
| | |
| < 10 | Grey |
| | |
| < 20 | Green |
| | |
| < 30 | Blue |
| | |
| < 50 | Purple |
| | |
| >= 50 | Orange |
User Custom Colors
The colors can be set by editing the BATTLETECH\Mods\BTShowMechAffinity\mod.json file.
"Settings": {
"AffinityColors": [
{"deploymentCountMax": 0, "Color": "#000000"},
{"deploymentCountMax": 9, "Color": "#BABABA"},
{"deploymentCountMax": 19, "Color": "#309231"},
{"deploymentCountMax": 29, "Color": "#4d51f8"},
{"deploymentCountMax": 49, "Color": "#A335EE"},
{"deploymentCountMax": 9999999, "Color": "#FF8000"}
The mech affinity is based on the number of deployments a pilot has in a chassis. The color selection is based on the deployment count vs the deploymentCountMax value in numeric order.
In the example above, if the pilot has a deployment count of 23, the color will be #4d51f8 since it is greater than 19 and less than or equal to 29.
The Color is an HTML color. The website https://htmlcolorcodes.com/color-picker/ has a useful color picker.
The last entry uses 9999999 to cover an affinity of 50 or more.
Note that the de
Show Mech Affinity is a UI mod for Mech Affinity that displays all pilots with an affinity for the selected mech in the contract loadout screen. With 133 endorsements and 2,861 downloads, it's a niche quality-of-life improvement for players using the Mech Affinity system.
✨ Key Features
📊 Pros & Cons
✅ Pros
- Tiny but useful QoL addition for Mech Affinity users—no more guessing which pilots synergize with your mech.
- Decent community traction (133 endorsements) for a niche UI tweak.
- Lightweight and focused—does exactly one thing without bloating your mod list.
⚠️ Cons
- Requires the Mech Affinity mod to function—useless if you don't run that mod.
- Only affects the contract loadout screen; no other UI improvements.
- Last updated in May 2024—may not be compatible with future game patches or Mech Affinity updates.
For Mech Affinity players who want to quickly see which pilots have affinity with a selected mech before launching a contract. Skip if you don't use Mech Affinity or prefer a more comprehensive UI overhaul.
💡 Beginner Tips
- Make sure Mech Affinity is installed and up to date before adding this mod.
- If you use a mod manager, let it handle the file placement to avoid overwriting issues.
- Check the mod's page for any compatibility notes with other UI mods you might have.
📊 Mod Details
- Game
- Battletech Mods
- Author
- NBKRedSpy
- Version
- 1.1.0
- Downloads
- 2,861
- Endorsements
- 133
- Category
- User Interface
- Created
- 5/18/2022
- Updated
- 5/16/2024
🔧 How to Install Battletech Mods
Download from Nexus Mods.
📖 Full step-by-step install guide for Battletech →
Visit the official mod page for specific installation instructions for this mod.
🎮 Need cheat codes or console commands? Check ur gaming wiki for Battletech commands, item IDs, and more.
Keep browsing — more Battletech mods await