中华宗族 ChineseLineage：v0.9.2。适配霸主 1.4.8（海战DLC 1.2.8 可选兼容）

【MOD名称】中华宗族 ChineseLineage【版本号】v0.9.2【支持游戏】霸主 1.4.8（海战DLC 1.2.8 可选兼容）

【原作者】：@长安归故里北
【发布者】：筱羽（已获原作者授权发布）
【前置依赖】Harmony、ButterLib、UIExtenderEx、MCM v5.12.2（均为强制，缺一不可）
═══════════════════════════════════════
中华宗族是一个面向霸主1.4.8的中式宗族文化MOD。它接管原版姓名系统，从角色创建到新生儿命名全部中文化，并在此基础上构建了字辈、嫡庶、收养、蒙学培养、青年历练、宗族声望、分支家族和史书等完整体系。目标是让你在卡拉迪亚玩出中国古代世家大族的感觉——从给孩子取名、选蒙学方向、安排青年历练，到分家立户、修订族谱，一切围绕"宗族"展开。
═══════════════════════════════════════
【核心功能一览】
■ 完整中文姓名系统  角色创建页骰子按钮改用纯中文始祖姓名池，支持单姓/复姓/男女倾向名  新生儿按性别自动取名，70%通用名库+30%性别倾向名库，三代避讳，十次重试  字辈传承，玩家百科页可直接修改完整姓名，自动识别姓与名
■ 宗法体系  正妻/侧室区分，嫡子/庶子/嫡女/庶女状态记录  继承人指定，16岁赐表字，成年礼按嫡长/嫡出/庶出提供统御管理加成
■ 子女培养（原创玩法）  4-10岁蒙学：文武双全/专注武艺/专注文治/专注智谋/专注内政，每30天成长  11-15岁青年历练：外出游学/随军历练/边疆驻守，事件链+技能成长+史书记录  名师、立功、击退袭扰等额外结果
■ 收养入谱  收养家族内未满18岁非血脉成员，继子女优先  养子养女使用本家姓氏+中文名，不分配字辈，记录原名及更名史事
■ 外嫁系统  女儿外嫁后保持现有姓名并停止本家自动改名，回归主家后重新纳入管理  外嫁女儿在夫家生育时只通知，不纳入娘家族谱
■ 宗族声望  寒门/望族/士族/门阀四等级，影响同伴招募费用  支持MCM倍率调节，可开关整个声望系统
■ 分支家族  子弟分家后保留姓氏，登记分支名称与正统性  抽象正统之争，三十日稳定领土判定
■ 史书系统  自动记录宗族大事（出生、成年、收养、历练、分家、声望变化等）  正册五十条、年表迁移、早夭记录、朱批、史册威名、读史养成、谥号评议  支持导出UTF-8文本到 文档\Mount and Blade II Bannerlord\ChineseLineage\Exports
═══════════════════════════════════════
【详细功能说明】
一、姓名系统
      1. 角色创建   - 新开局在角色创建"回顾"页确认完整中文姓名   - 骰子按钮改用纯中文始祖姓名池，支持常见单姓、复姓和男女倾向中文名   - 进入战役后自动识别单姓或预设复姓，单字姓名允许名为空
      2. 新生儿命名   - 出生时自动按性别生成中式名字   - 70%通用名库 + 30%性别倾向名库   - 三代避讳（不与曾祖辈/祖辈/父辈同名）   - 十次重试机制，冲突时自动换名   - 备用名库 + 世次保底，极端情况也能给出合法名字   - 最终姓名冲突时弹出中文改名框，由玩家确认
      3. 姓名修改   - 玩家百科页快捷入口改为"修改姓名"   - 输入完整中文姓名后自动识别姓与名   - 原版或其他模组修改玩家姓名后，系统会重新识别姓氏   - 姓氏变化时同步玩家后代、主家名称、已登记分支名称与改姓史事   - 本家血脉成员被其他模组改名后，只提取新的"名"，再统一重组为"本家姓氏＋字辈＋名"
      4. 字辈   - 玩家家族第2代起自动插入字辈   - 可在宗族总览中修改字辈序列   - 分家家族不沿用字辈
二、宗法体系
      1. 嫡庶   - 正妻所生为嫡出，侧室所生为庶出   - 嫡子/庶子/嫡女/庶女状态在成员摘要中显示   - 继承人选择结果写入指定继承人状态
      2. 表字   - 本家血脉成员16岁时可赐表字   - 取消输入时使用系统建议表字
      3. 成年礼   - 按嫡长、其他嫡出、庶出提供不同的统御和管理基础加成   - 成年事件写入史书
三、子女培养
      1. 蒙学（4-10岁）   - 可选方向：文武双全、专注武艺、专注文治、专注智谋、专注内政   - 选定后每30天一次小幅成长轮换，提升相关技能   - 年满11岁自动结业，结业结果写入史书
      2. 青年历练（11-15岁）   - 可选路线：外出游学、随军历练、边疆驻守   - 当前为抽象事件链，不强制创建队伍、不移动角色、不干扰原版队伍系统   - 游学持续1-2年，随军与边疆历练持续1年   - 期满自动结算技能成长   - 每条路线均有稳定概率触发名师、立功或击退袭扰等额外结果   - 所有结果同步写入史书
四、收养入谱- 城镇宗族总览"【养】登记收养"入口- 候选限定为玩家家族内未满18岁的非血脉成员，继子女优先显示- 收养成员使用"本家姓氏＋中文名"，不分配字辈- 记录养子/养女身份、原名及更名史事- 收养成员不再被继子女、配偶或本家血脉命名规则重复处理
五、外嫁系统- 外嫁女儿保持现有姓名并停止由本家自动改名- 回归主家后重新纳入管理- 外嫁女儿在夫家生育时只通知一子/一女，不显示孩子姓名，不纳入娘家族谱
六、宗族声望- 四个等级：寒门 → 望族 → 士族 → 门阀- 声望变化影响同伴招募费用（寒门额外花费，门阀返还金币）- 支持MCM倍率调节- 可在MCM中完全关闭声望系统- 家族界面宗族入口区域显示门阀等级和声望值
七、分支家族- 子弟分家后保留姓氏- 可登记分支家族，分支名称统一为"主姓·封地氏"- 抽象正统之争机制- 三十日稳定领土判定
八、史书系统- 自动记录：出生、成年、收养、蒙学结业、历练结束、分家、声望变化、改姓等- 正册五十条、年表迁移、早夭记录- 朱批（玩家批注）、史册威名、读史养成、谥号评议- 宗族总览中可翻阅《宗谱·大事记》- 支持导出UTF-8文本，包含标题、导出时间、门阀等级、宗族声望、正册、年表、分支国别史和朱批
九、MCM设置- PerCampaign模式，每个战役存档拥有独立设置- 分组：姓氏与命名、配偶改名、宗族声望、工具- 可开关宗族声望系统、调节声望增减倍率- "立即应用到所有成员"按钮- "重置手动改名记录"按钮（含中文二次确认）- "导出史书为文本"按钮
═══════════════════════════════════════
【安装说明】
1. 确认已安装以下前置MOD（缺一不可）：   - Bannerlord.Harmony   - Bannerlord.ButterLib   - Bannerlord.UIExtenderEx   - Bannerlord.MBOptionScreen（MCM v5.12.2或以上）
2. 解压 ChineseLineage_v0.9.2.zip
3. 将 ChineseLineage 文件夹复制到游戏目录的 Modules 文件夹下   路径示例：\Steam\steamapps\common\Mount & Blade II Bannerlord\Modules\
4. 启动游戏，在启动器中勾选"Chinese Lineage"
5. 确保加载顺序：Harmony → ButterLib → UIExtenderEx → MCM → ChineseLineage

═══════════════════════════════════════
【兼容性】
✓ 支持霸主 1.4.8
✓ 支持海战DLC 1.2.8（可选）
✓ 支持BirthAndDeath（生死命途）
✓ 支持Sandbox和StoryMode
✗ 不支持1.4.8以下版本（包括1.2.x）
✗ 与其他修改姓名系统的MOD可能冲突（如其他中文姓名MOD）

═══════════════════════════════════════
【已知问题 / 注意事项】
1. 本MOD接管姓名系统，与其他中文姓名MOD冲突，请勿同时使用
2. 旧档升级：v0.6.x存档升级到v0.9.x时，系统会自动进行空值修复，但建议备份存档
3. 青年历练当前为抽象事件链，不创建真实队伍、不移动角色
4. 嫡庶状态基于原版婚姻系统，侧室需要相关MOD支持（如MarriageFertility等）
5. MCM设置为PerCampaign，每个存档独立，开新档需重新配置
6. 如遇姓名被其他MOD覆盖，在玩家百科页重新修改一次完整姓名即可
═══════════════════════════════════════
【更新日志】

v0.9.2（2026-08-22）
完整姓名与姓氏识别：
- 战斗结算后立即按宗族权威状态重新校准主角姓名，避免原版战斗流程剥离姓氏或回退旧名- 当检测到主角姓名暂时失去本家姓氏时，恢复权威姓名，而不是把剩余部分误识别成新姓氏
- 删除MCM、城镇总览及百科中的"单独修改姓氏"流程，避免姓氏与玩家名分开保存造成状态错乱- 新开局在角色创建"回顾"页确认完整中文姓名后，进入战役自动识别单姓或预设复姓；单字姓名允许名为空
- 接管"回顾"页骰子按钮，改用纯中文始祖姓名池，支持常见单姓、复姓和男女倾向中文名
- 玩家百科快捷入口改为"修改姓名"；输入完整中文姓名后自动识别姓与名
- 原版或其他模组修改玩家姓名后，系统会重新识别姓氏；姓氏变化时同步玩家后代、主家名称、已登记分支名称与改姓史事
- 原版或其他模组修改本家血脉成员姓名后，只提取新的"名"，再统一重组为"本家姓氏＋字辈＋名"- 完整姓名解析现在只接受纯中文字符，并兼容姓名中的间隔点，避免混合英文被误认作中文宗族姓名
构建与兼容：
- 目标版本保持Bannerlord v1.4.8，NavalDLC v1.2.8为可选兼容模块
- Release / net472构建通过

v0.9.1（2026-08-15）
收养入谱：
- 新增城镇宗族总览"【养】登记收养"入口- 候选限定为玩家家族内未满十八岁的非血脉成员，继子女优先显示
- 收养成员使用"本家姓氏＋中文名"，不分配字辈，并记录养子/养女身份、原名及更名史事- 收养成员不再被继子女、配偶或本家血脉命名规则重复处理
蒙学培养：
- 四至十岁的本家血脉子女可选择文武双全、专注武艺、专注文治、专注智谋或专注内政
- 方向选定后按每三十日一次的小幅成长轮换提升相关技能
- 年满十一岁自动结业，结业结果写入史书，并提示可安排青年历练青年历练：
- 十一至十五岁的本家血脉子女可安排外出游学、随军历练或边疆驻守
- 当前实现为抽象事件链，不强制创建队伍、不移动角色、不干扰原版队伍系统
- 游学持续一至两年，随军与边疆历练持续一年；期满自动结算技能成长
- 每条路线均有稳定概率触发名师、立功或击退袭扰等额外结果，并同步写入史书
界面、存档与稳定性：
- 独立宗族总览新增收养、蒙学和青年历练三个操作按钮
- 成员摘要新增"收养入谱"、蒙学方向、历练路线及进行/完成状态
- 新增成长进度、奖励次数、开始时间、持续时间和结算结果的存档字段，并加入旧档空值修复
- Gauntlet Prefab已通过单根XML解析，新增命令均完成ViewModel与UI上下文绑定
仍未纳入
v0.9.1：
- 成长路线中的真实离队、真实随军队伍、受伤或死亡模拟- 嫡庶强制改写原版继承、真实分封建族、贡赋与真实内战
- 女儿赠礼/探望/召回/劝降、配偶嫁妆与满意度完整事件链

v0.9.0（2026-08-15）
姓名与家族名称：
- 开局从玩家中文姓名自动识别单姓或预设复姓；单字名允许名为空
- 自动回填MCM姓氏与玩家名- 主家名称统一为"姓氏家族"，分支名称统一为"主姓·封地氏"- 新增姓氏来源锁定与改姓范围确认；可全族同步，也可仅影响未来后代
- 男女命名改为70%通用名库+30%性别倾向名库，继续保留三代避讳、十次重试、备用库和世次保底外嫁与宗法基础：
- 外嫁女儿保持现有姓名并停止由本家自动改名；回归主家后重新纳入管理- 外嫁女儿在夫家生育时只通知一子/一女，不显示孩子姓名，不纳入娘家族谱- 新增正妻/侧室与嫡子、庶子、嫡女、庶女的基础状态记录
- 玩家继承选择结果写入指定继承人状态- 本家血脉成员十六岁时可赐表字；取消输入时使用系统建议- 成年礼按嫡长、其他嫡出、庶出提供统御和管理基础加成
界面与稳定性：
- 宗族成员摘要新增始祖、继承人、嫡庶、正妻/侧室、已外嫁、辈分和表字标识
- 所有新增状态均已接入存档同步、旧档空值修复和MCM双向同步
- 主要入口继续保持在城镇菜单"【宗】宗族"

v0.8.0（2026-08-13）
版本适配与依赖：
- 使用Bannerlord.ReferenceAssemblies.Core 1.4.8编译
- 接入Bannerlord.UIExtenderEx v2.13.3
- 保持Mod Configuration Menu v5.12.2支持
UI与入口重构：
- 初始化UIExtenderEx，并注册中华宗族界面扩展
- 在L键家族界面加入【宗】宗谱总览入口
- 在家族界面显示当前门阀等级与宗族声望- 在N键百科的玩家英雄页面加入姓名快捷入口
- 宗谱总览集中提供宗族状态、修改字辈、史书、分支登记、立即应用和史书导出MCM设置页：
- MCM设置改为PerCampaign，每个战役存档拥有独立设置
- 新增"启用宗族声望系统"开关
- 新增宗族声望增减倍率
- 新增"立即应用到所有成员"按钮
- 新增"重置手动改名记录"按钮
- 新增"导出史书为文本"按钮宗族声望：
- 声望变化支持MCM倍率
- 关闭声望系统后，不再产生新的普通声望增减和同伴招募声望修正
史书导出：
- 新增UTF-8文本导出
- 导出内容包含标题、导出时间、门阀等级、宗族声望、正册、年表、分支国别史和朱批

*总体评价	给总体评价评分
*点评	Smilies 登录