Recruit Exiled Clans(v1.2.X)

Features:

1. Recruit Exiled Clans after Kingdom Destruction

Recruit by having dialogue with the Clan Leader.

1. AI Exiled Clan Auto-Join System

Only supports game versions 1.1.5–1.2.X; Not compatible​ with 1.3.X–1.4.X.

Requires four specific prerequisites​(Harmony,butterlib,UIExt,MCM...) corresponding to game version 1.2.12.

High Compatibility:​ Theoretically compatible with all mods; can be installed or uninstalled at any time.

Link to the version compatible with game version 1.3.X–1.4.X (Supports Sailing DLC):

https://steamcommunity.com/sharedfiles/filedetails/?id=3618730894

June 24, 2026 Update:

Updated to the latest version of this mod (adapted for game version 1.2.X).

The current mainstream versions of the base game are 1.3.15–1.4.6. As the majority of mods have already adapted to game versions 1.3.X–1.4.X, maintenance for this specific version (1.2.X)​ will cease as of today, barring any critical bugs.

AI Auto-Join System: Decision Logic

When an exiled clan (no kingdom, not mercenaries, not rebels, not minor factions) decides where to go, it follows a three-stage process:

Stage 1: Filtering

Excludes destroyed kingdoms.

Excludes kingdoms without a ruler.

Optionally excludes kingdoms currently at war with the clan (configurable).

Stage 2: Scoring (0.0 – 1.0)

Each candidate kingdom receives a score based on weighted factors:

Relationship Network (Default: 70% Weight)

60% based on the relationship with the Kingdom Ruler.

40% based on the relationship with the most friendly noble in the kingdom.

Cultural Compatibility (Default: 30% Weight)

Same Culture: 1.0

Different Culture: 0.3

Unknown Culture: 0.5

Stage 3: Final Selection

Top 2 Selection:​ The system picks the top two candidates.

Threshold Check:​ If the top score is too low, the clan wanders indefinitely.

Dynamic Balancing:

Rule 1 (Anti-Snowball):​ If the #1 kingdom is AI and vastly stronger than #2, the clan may choose the weaker one to prevent domination.

Rule 2 (Anti-Player Farming):​ If the #1 kingdom is the Player Kingdom, a dynamic penalty applies based on your power and your relationship with the clan, making it harder to hoard all exiles.

Rule 3 (Default):​ If no special rules trigger, the clan joins the highest-scoring kingdom.

🏰 Kingdom Power Calculation

Power is calculated using: Military (60%)​ + Settlements (30%)​ + Clan Count (10%). Configuration Options

Players can adjust most parameters via the MCM menu, including stage weights, thresholds, and probabilities, allowing for various decision-making styles ranging from simple to complex.

Functional Notes:

Trigger Timing:​ The auto-join system runs only once at the start of the in-game week; it remains dormant for the rest of the time.

Joining Players:​ AI exiled clans can automatically join the Player Kingdom if the system calculates it as the "Best Choice."

Preventing Extinction:​ Via the MCM menu, you can configure the mod so that all exiled clans will eventually join a qualified kingdom, preventing them from disappearing due to prolonged exile.

Changelog

June 24, 2026:​ Synced with the latest version of the mod (for game v1.2.X).

March 5, 2026:​ Added the AI Exiled Clan Auto-Join feature; can be toggled On/Off in MCM.

December 6, 2025:​ Updated the version compatible with 1.3.X and the Sailing DLC. (Note: You may need to unsubscribe from this version before subscribing to that version). Link: https://steamcommunity.com/sharedfiles/filedetails/?id=3618730894

August 25, 2024:​ Exclude Rebel and Mercenary clans.

If you encounter bugs, please report them in the comments section.

If you found this helpful, please leave a like to encourage the author!

Support the Author:​ https://afdian.com/a/arc_1212

Source Code:​ https://github.com/HelloKitty112-cpu/RecruieExiledClans