入赘为婿

描述
描述你的模组的主要用途

安装说明
列出用户安装你的模组时必须遵循的所有步骤

主要功能
描述你的模组核心功能

前置需求
- Harmony
- ButterLib
- UIExtenderEx
- Mod Configuration Menu v5

鸣谢
向你受到启发或帮助过你的人致谢。
入赘系统

入赘婚姻（Marry Into The Wife's Family）

**一个为《骑马与砍杀2：霸主》制作的入赘（赘婿 / 随母姓婚姻）MOD。**

厌倦了辛辛苦苦培养的女儿、姐妹一结婚就嫁到别人家吗？这个 MOD 让你可以提议**男方入赘到你的家族**。对方会根据你家族的实力、以及你们之间的关系来决定是否同意。

---

### ✨ 功能特性

#### 1. 入赘按钮
当有 NPC 向你的女性家族成员求婚时，会弹出一个新选项 **「提议入赘」**。若对方家族同意，男方将加入你的家族——你的女儿留在家里。

#### 2. AI 基于「实力 + 关系」判定
对方家族是否同意，取决于两大因素：

- **家族实力**——声望、影响力、领地（封地）、财富
- **关系**——两家**领袖之间**的个人关系，**以及**两个**家族之间**的关系

两项关系都做了**封顶钳制**，任何单一因素都无法完全否决（或强制）入赘——实力始终是主要考量。

#### 3. 双向 AI 与绝嗣预防
AI 也会利用入赘来**防止家族绝嗣**。当某个 AI 家族只剩最后一名女性继承人、即将绝后时，它会主动安排入赘婚姻延续血脉。如果它想拉你家族的男性入赘，会先征求你的同意。

#### 4. 完整的 MCM 配置
所有参数都能在游戏内通过 **Mod Configuration Menu** 实时调整，无需改配置文件。

---

### ⚙️ MCM 设置项

| 设置项 | 默认 | 说明 |
|---|---|---|
| 玩家入赘难度 | 1.0 | 你向 AI 提议入赘时的难度 |
| AI 入赘难度 | 1.0 | AI 家族之间入赘的难度 |
| 声望 / 影响力 / 领地 / 财富权重 | 0.4 / 0.2 / 0.3 / 0.1 | 家族实力评分的权重 |
| 关系权重 | 0.3 | 关系对判定的影响程度 |
| 关系影响上限 | 0.5 | 关系最多能改变门槛的幅度 |
| 启用绝嗣预防 | 开 | AI 家族主动安排入赘避免绝后 |
| 允许玩家男性加入 AI 家族 | 开 | 允许 AI 请求你家族的男性入赘 |
| 启用自动入赘判定 | 关 | 调试用：自动判定不弹窗 |

---

### 🔧 前置依赖

- [Harmony](https://www.nexusmods.com/mountandblade2bannerlord/mods/2006)
- [ButterLib](https://www.nexusmods.com/mountandblade2bannerlord/mods/2018)
- [UIExtenderEx](https://www.nexusmods.com/mountandblade2bannerlord/mods/2102)
- [Mod Configuration Menu v5](https://www.nexusmods.com/mountandblade2bannerlord/mods/612)

游戏版本：**v1.2.x+**（已在 v1.4.x 上实测）

---

### 📦 安装方法

1. 将压缩包解压到 `Mount & Blade II Bannerlord\Modules`
2. 在启动器中勾选 **Marry Into The Wife's Family**，并让它排在 Harmony / ButterLib / UIExtenderEx / MCM **之后**加载
3. 在 MCM 选项菜单中进行配置

---

### ⚠️ 兼容性

- **请勿与「Keep Our Women」同时使用**——两者修改了同一个游戏方法，会冲突。本 MOD 已覆盖其功能。
- 与大多数其他 MOD 兼容。采用事件监听 + Harmony 补丁实现，可随时安全添加/移除。

---

### 🙏 鸣谢

**本 MOD 由 DeepSeek（AI 编程助手）协助编写完成。** 核心婚姻系统 API 通过反编译游戏 DLL 逐一核实，特此说明。

---

# 🇨🇳 中文版本
## 入赘婚姻（Marry Into The Wife's Family）

**一个为《骑马与砍杀2：霸主》制作的入赘（赘婿 / 随母姓婚姻）MOD。**

厌倦了辛辛苦苦培养的女儿、姐妹一结婚就嫁到别人家吗？这个 MOD 让你可以提议**男方入赘到你的家族**。对方会根据你家族的实力、以及你们之间的关系来决定是否同意。

---

### ✨ 功能特性

#### 1. 入赘按钮
当有 NPC 向你的女性家族成员求婚时，会弹出一个新选项 **「提议入赘」**。若对方家族同意，男方将加入你的家族——你的女儿留在家里。

#### 2. AI 基于「实力 + 关系」判定
对方家族是否同意，取决于两大因素：

- **家族实力**——声望、影响力、领地（封地）、财富
- **关系**——两家**领袖之间**的个人关系，**以及**两个**家族之间**的关系

两项关系都做了**封顶钳制**，任何单一因素都无法完全否决（或强制）入赘——实力始终是主要考量。

#### 3. 双向 AI 与绝嗣预防
AI 也会利用入赘来**防止家族绝嗣**。当某个 AI 家族只剩最后一名女性继承人、即将绝后时，它会主动安排入赘婚姻延续血脉。如果它想拉你家族的男性入赘，会先征求你的同意。

#### 4. 完整的 MCM 配置
所有参数都能在游戏内通过 **Mod Configuration Menu** 实时调整，无需改配置文件。

---

### ⚙️ MCM 设置项

| 设置项 | 默认 | 说明 |
|---|---|---|
| 玩家入赘难度 | 1.0 | 你向 AI 提议入赘时的难度 |
| AI 入赘难度 | 1.0 | AI 家族之间入赘的难度 |
| 声望 / 影响力 / 领地 / 财富权重 | 0.4 / 0.2 / 0.3 / 0.1 | 家族实力评分的权重 |
| 关系权重 | 0.3 | 关系对判定的影响程度 |
| 关系影响上限 | 0.5 | 关系最多能改变门槛的幅度 |
| 启用绝嗣预防 | 开 | AI 家族主动安排入赘避免绝后 |
| 允许玩家男性加入 AI 家族 | 开 | 允许 AI 请求你家族的男性入赘 |
| 启用自动入赘判定 | 关 | 调试用：自动判定不弹窗 |

---

### 🔧 前置依赖

- [Harmony](https://www.nexusmods.com/mountandblade2bannerlord/mods/2006)
- [ButterLib](https://www.nexusmods.com/mountandblade2bannerlord/mods/2018)
- [UIExtenderEx](https://www.nexusmods.com/mountandblade2bannerlord/mods/2102)
- [Mod Configuration Menu v5](https://www.nexusmods.com/mountandblade2bannerlord/mods/612)

游戏版本：**v1.2.x+**（已在 v1.4.x 上实测）

---

### 📦 安装方法

1. 将压缩包解压到 `Mount & Blade II Bannerlord\Modules`
2. 在启动器中勾选 **Marry Into The Wife's Family**，并让它排在 Harmony / ButterLib / UIExtenderEx / MCM **之后**加载
3. 在 MCM 选项菜单中进行配置

---

### ⚠️ 兼容性

- **请勿与「Keep Our Women」同时使用**——两者修改了同一个游戏方法，会冲突。本 MOD 已覆盖其功能。
- 与大多数其他 MOD 兼容。采用事件监听 + Harmony 补丁实现，可随时安全添加/移除。

---

### 🙏 鸣谢

**本 MOD 由 DeepSeek（AI 编程助手）协助编写完成。** 核心婚姻系统 API 通过反编译游戏 DLL 逐一核实，特此说明。

---