Description
🤖 AI Disclosure
Matchmaker is made by Alkeari.
AI is solely used for the following items:
- Minimal assistance with code: bug fixes and updates
- Restructuring code for organization and clarity
- README
- Changelog
- Translations
⭐ What It Does
- One hotkey from the campaign map - any keyboard key, the middle mouse button or mouse 4 or 5, with optional Shift, Ctrl or Alt, and it closes on Escape or when the map stops being the active screen.
- Only the candidates you would consider - filter on load by age, gender, clan-leader and wanderer status, your own clan and close family, prisoner status, minimum skills and minimum relation.
- Everyone in Calradia, or only who you know - every eligible hero is listed by default; turn off Show All Heroes to see only the ones the game counts as known to you.
- Search and sort the way you think - free text across name, clan, culture and location, six sortable columns, and a Skill button that cycles the sort through five skills; clicking the active column flips the direction.
- Two filters you can flip mid-look - Unmarried Only, Show All or Married Only, and Any Relation, Positive Only or Friendly at 50 and above.
- A real case for each candidate - clan and tier, culture, where they are now (or their clan's home when the game does not say), and marriage status.
- How they fit you - relation, a color-coded compatibility score, the dowry a proposal costs, skills and traits.
- Meet - opens that candidate's Encyclopedia page.
- Propose - marries you to the candidate from the panel after a confirmation showing the dowry and your gold; the dowry is paid to the candidate's clan leader.
- It adds no marriage rule of its own - being married already only warns you; the game's own pairing rules still apply unless a multi-spouse mod changes them or you turn on Bypass Marriage Restrictions.
- Refresh without reopening - reloads the candidate list and picks up display settings you changed while the panel was open.
📋 Requirements
- Mount & Blade II: Bannerlord v1.3.13 through v1.4.8, and the Beta branches v1.5.2 and v1.5.7.
- Languages. English plus twelve of the game's languages, not yet checked by a native speaker; the translator files let you fix or add one.
- Mod Configuration Menu 5.12.2 or newer, which brings Harmony, ButterLib and UIExtenderEx with it.
📥 Installation
⚙️ Configuration
35 settings in five groups in the MCM options screen, none needing a restart except Update Notice, which applies from the next game start.
| Group | What you can change |
|---|---|
| General | the master enable, and Update Notice: when the game starts, asks alkeari.com for the newest version of Matchmaker and shows a message if one is out, sending nothing about you or your game |
| Hotkey | the key and its modifier |
| Candidate Filters | age, 18 to 40 by default, gender, exclusions, minimum skills, minimum relation |
| Display Options | what each candidate row and the detail panel show |
| Gameplay Features | Meet, Show All Heroes, Quick Marriage, Bypass Marriage Restrictions |
The minimum skills start at 0 and the minimum relation at -100, so they filter no one until you raise them. The age range, the exclusions of clan leaders, wanderers, your own clan and close family, and prisoners, and hiding already-married heroes are on by default; each can be changed on its own.
Sort columns
Name, Age, Compatibility, Relation, Dowry and Clan Tier. The Skill button sorts by Stewardship, then Medicine, Charm, Leadership and Trade on each further click, its caption naming the skill in use.
🖥️ Compatibility
- Save games. Nothing is written to your save and no game code is patched, so it can be added to or removed from a campaign at any time.
- Game versions. This release supports v1.3.13 through v1.4.8, and the Beta branches v1.5.2 and v1.5.7.
- Languages. English plus twelve of the game's languages, not yet checked by a native speaker; the translator files let you fix or add one.
- A confirmed proposal is a real marriage and a real gold transfer, applied at once without the usual courtship.
- Propose is off by default. Turn on Quick Marriage to use it, and it still refuses when you cannot afford the dowry.
- One copy only. A
Modules\copy overrides a Workshop copy silently, so if you have ever installed this mod the other way, delete...\Modules\Matchmakerbefore using the store copy.
🐛 Support
- Include the mod version, your Bannerlord version, your launcher's mod list in load order, and what the candidate panel showed.
📄 License
License terms are in the Alkeari License Agreement.
Every release, its changes and how to send feedback are on the project page at alkeari.com/projects/matchmaker.
💛 Donate
If you would like to donate, you can do so on Ko-fi, Patreon, PayPal, Stripe, GitHub Sponsors or Buy Me a Coffee.


