索尔

=== 如果你有兴趣帮助我调试/改进模组：https://discord.gg/Hnuz6qVq8h ===

=== 如果你喜欢我的模组，请点赞/投票支持它，推广给他人无需任何代价 ===

索尔（Thor）是一款全面的生活质量优化模组，可自动化《英灵神殿》中许多重复性任务，同时保持游戏平衡性和沉浸感。以北欧雷神命名，这款模组为你的维京定居点带来力量与效率。

16,000 多行精心编写的代码，经过广泛的性能优化、增量过滤日志记录，并支持多人游戏的服务器同步配置。

---

### ⚡ 核心功能

#### 🔥 自动燃料系统
自动从附近容器为你的工作站补充燃料——再也不用手动添加燃料了！

支持的工作站：
- 壁炉与火把 - 立式火把、壁挂火把、篝火、热水浴缸
- 熔炉/高炉与窑炉 - 自动添加矿石与燃料，并可配置数量限制
- 烹饪站 - 石炉，在食物烧焦前自动收集已烹饪的食物
- 蜂箱 - 自动收集蜂蜜至附近容器，并显示时间
- 发酵器 - 自动添加蜜酒基底并收集成品蜜酒，带计时器显示
- 风车 - 自动添加大麦，可选的绕过风力机制，地面面粉清理
- 纺车 - 自动将亚麻线存入容器
- 埃特精炼器 - 自动添加树液/软组织，防止溢出
- 护盾发生器 - 用骨头碎片保护你的基地

智能特性：
- 分布式填充 - 在多个窑炉间均匀分配燃料（轮询调度）
- 窑炉输出限制器 - 当容器达到阈值时停止产煤
- 地面物品清理 - 自动收集工作站输出的掉落煤炭/面粉/线
- 毁灭者优先级 - 在从容器取用前，优先使用毁灭者作为全局燃料源
- 尤尔礼物自动补充 - 每天一次从玩家背包自动填充礼物容器
- 有序存储 - 仅将产出存入已有同类物品的容器中
- 保留最后一项 - 防止完全清空容器的安全特性

---

#### 🎣 拖网捕鱼系统
航行时也能钓鱼！ 将钓鱼用品放入船舱，在航行中自动捕鱼。这是索尔模组中最复杂的系统之一。

运作方式：
- 需要钓鱼竿 - 启用鱼类捕捉（鲈鱼、金枪鱼、琵琶鱼等）
- 需要深渊鱼叉 - 启用水中生物狩猎（蛇蛇、水蛭、碎骨者）
- 需要鱼饵 - 不同鱼饵吸引不同鱼类：
  - 基础鱼饵 → 鲈鱼、梭子鱼（任何生物群系中的常见鱼类）
  - 海洋鱼饵 → 金枪鱼、珊瑚鳕鱼 + 蛇蛇
  - 森林鱼饵 → 巨魔鱼
  - 沼泽鱼饵 → 巨型鲱鱼 + 水蛭
  - 洞穴鱼饵 → 四眼鱼（高山湖泊）
  - 平原鱼饵 → 石斑鱼
  - 迷雾之地鱼饵 → 河豚、琵琶鱼
  - 灰烬之地鱼饵 → 岩浆鱼 + 碎骨者
  - 极北之地鱼饵 → 北方鲑鱼

水中生物自动狩猎：
- 生命值阈值系统 - 当蛇蛇/水蛭/碎骨者生命值低于可配置百分比时自动捕捉
- 鱼叉模拟 - 真实模拟鱼叉击杀，产生战利品掉落
- 星级追踪 - 分别追踪 0★、1★、2★ 生物击杀

鱼类诱饵（可选 - 将范围扩展 30 米）：
- 战利品（优先使用 - 价值较低）：所有 35 种以上的战利品类型均可作为诱饵
- 制作材料（次优使用）：内脏、蛇颈、血袋、软泥、冰冻腺体、腐肉等。
- 每钓到 3 条鱼消耗 1 个诱饵
- 船后会生成可见的鱼漂，显示吸引范围

动态钓鱼调整值：
- 每日变化 - 每个游戏日有随机捕获率（基础 30-60%）
- 天气影响 - 暴风雨天气 +8%，晴朗天气 -5%
- 时间因素 - 黎明/黄昏 +12%，午夜 +6%，正午 -8%
- 技能加成 - 钓鱼技能 0-100 可增加最多 +15% 捕获率
- 基于技能的范围 - 范围从 30 米（技能 0）到 130 米（技能 100）
- 生物群系外加成 - 在原生生物群系外捕获鱼类 +10% 捕获率

钓鱼技能整合：
- 通过拖网捕鱼获得钓鱼经验值（可配置倍率）
- 经验值基于每次捕获鱼的模拟"收线时间"
- 获得技能所需的最低鱼类数量阈值

钓鱼指示器界面：
- 在小地图附近显示当前钓鱼条件
- 显示天气、时间及捕获率修改项
- 仅当钓鱼技能达到需求阈值时可见

鱼儿上钩！（召唤蛇蛇）
- 每个游戏日自动生成一条蛇蛇
- 需要：海洋生物群系 + 夜晚 + 雷暴
- 包含戏剧性的音效（召唤音 + 庆祝欢呼"wee!"）
- 蛇蛇在距玩家可配置距离处生成

---

#### ⛵ 船岸系统
在范围内自动在船、手推车和岸上容器之间转移物品。

船 ↔ 岸转移：
- 将停靠船只的货物转移到岸上容器
- 可配置转移范围（默认 10 米）
- "需要已有物品"安全特性 - 仅转移到匹配的容器

手推车系统：
- 手推车 ↔ 岸 - 自动将手推车卸货到容器
- 船 ↔ 手推车 - 在船与手推车之间转移（可配置方向）
- 互斥防止无限循环

毁灭者溢出缓冲区：
- 使用毁灭者作为临时排序缓冲区
- 手推车溢出 → 毁灭者 → 存储容器（如有空间）
- 可配置允许/禁止物品类型列表
- 防止意外销毁贵重物品

智能过滤：
- 物品允许列表（白名单）或禁止列表（黑名单）
- 每个转移类型可独立配置
- 带物品数量的消息格式

---

#### 🔨 从容器制作（CFC）
无需手动将物品移到背包，即可从附近容器获取制作材料。

核心特性：
- 基于范围的搜索 - 从可配置半径内的容器中提取材料
- 支持所有制作 - 工作台、熔炉、烹饪、建筑、升级
- 燃料与矿石支持 - 从容器为工作站添加燃料/矿石

容器过滤：
- 排除船用容器
- 排除手推车/马车容器
- 排除木质箱子、加固箱子、黑金属箱子、私人箱子
- 每个过滤器均可独立配置

视觉反馈：
- 幽灵连接线显示正在访问的容器
- 当资源来自容器时，数量闪烁显示
- 可配置闪烁颜色

快捷键控制：
- 防止模组键（Alt） - 启用/禁用 CFC 行为
- 提取物品键（Ctrl） - 将材料提取到背包而非直接制作
- 全部填充键（Shift） - 一次性提取所有可用燃料/矿石

安全特性：
- 保留一个 - 始终在容器中至少保留 1 个物品
- 按距离提取 - 优先从最近容器提取
- 燃料/矿石禁止类型 - 防止燃烧贵重木材（圆木、精木）

OdinsQoL 兼容性：
- 检测 OdinsQoL 的堆叠数量和负重修改
- 相应调整计算

---

#### 🐗 动态繁殖系统
持续育种管理，自动清理以防止过度繁殖，同时维持繁殖对。

持续繁殖逻辑：
- 当达到原版种群上限时，清理最年长的未命名后代
- 允许父母无限期繁殖而不受上限限制
- 已命名动物（通过"驯服"命令）永不清理——它们是珍贵的种畜

每个物种的种群上限：
- 野猪 - 默认每名玩家 4 只
- 狼 - 默认每名玩家 4 只
- 洛克斯 - 默认每名玩家 2 只
- 鸡（母鸡） - 默认每名玩家 12 只
- 阿斯克温 - 默认每名玩家 2 只
- 无玩家在线时的基础限制（服务器）
- 随在线玩家数量调整

容器喂食：
- 驯养动物从附近的箱子/手推车/船只中进食（100 米范围）
- 自动搜索有效食物物品
- 当容器无法接收蛋时显示"饲料箱已满"警告

自动捡蛋：
- 自动收集冷鸡蛋
- 将鸡蛋转移到饲料槽附近的容器中
- 可配置检查间隔（默认 30 秒）

笼式农场掉落支持：
- 鸡蛋 - 穿过笼子地板部件掉落（1x1、2x2）
- 野猪幼崽 - 穿过笼子地板部件掉落（1x1、2x2）
- 狼崽 - 穿过笼子地板部件掉落（1x1、2x2）
- 洛克斯幼崽 - 穿过笼子地板部件掉落（1x1、2x2）
- 阿斯克温蛋 - 穿过笼子地板部件掉落（1x1、2x2）

定期清理：
- 可配置清理检查间隔（默认 20 分钟）
- 可配置繁殖区周围清理半径（默认 100 米）
- 仅清理未命名的成年动物——从不清理已命名动物或幼崽

---

#### 🔫 舰载弩炮自动装填
需配合长船升级模组使用

- 检测长船升级模组的 ShipTurret 组件
- 从船舱自动装填舰载弩炮
- 可配置弹药阈值（默认：剩余 20% 弹药时装填）
- 可配置搜索范围（默认：50 米）
- 增量过滤日志记录（仅在弹药数量变化时记录）

---

### ⚙️ 配置

索尔模组拥有 200 多个配置选项，按逻辑分区组织，并支持服务器同步：

功能开关：
- 独立启用/禁用整个系统
- 每个主要功能都有主开关

调试日志记录（精细控制）：
- 按功能调试开关：这里有条鱼、自动燃料、船到岸、拖网捕鱼、从容器制作、繁殖、性能、通用
- 增量过滤日志记录防止日志刷屏
- 仅在状态变化时记录，而非重复记录静态值

服务器同步设置：
所有影响游戏性的设置从服务器同步到客户端：
- 钓鱼范围、捕获率、鱼饵消耗
- 转移范围和冷却时间
- 繁殖限制和清理间隔
- 容器搜索范围

仅客户端设置：
- 界面位置和可见性
- 快捷键绑定
- 调试开关
- 视觉反馈偏好

所有设置均可通过 BepInEx 配置管理器（游戏中按 F1）实时重载。

---

### 📦 需求

- 《英灵神殿》 - 灰烬之地更新或更高版本
- BepInEx 5.4.x - 模组加载器框架
- Jotunn 2.27.0+ - 《英灵神殿》模组开发库

### 🔧 安装

1. 安装 BepInEx 和 Jotunn（如果尚未安装）
2. 将 Thor.dll 放入 BepInEx/plugins/Thor/ 文件夹
3. （可选）将音效文件复制到 BepInEx/plugins/Thor/Sound Files for AsathorrOdinsson/ 文件夹
4. 启动《英灵神殿》- 配置文件将自动生成
5. 通过 F1（BepInEx 配置管理器）进行配置，或编辑 Thor.cfg 文件

---

### 🎮 兼容性

- 服务器/客户端： 客户端模组，支持多人游戏服务器同步设置
- 测试环境： 《英灵神殿》灰烬之地更新
- 已知兼容模组：
  - 基于 Jotunn 的模组
  - OdinsQoL（自动检测堆叠/负重调整）
  - 长船升级模组（用于舰载弩炮自动装填）
  - 大多数其他 BepInEx 模组

---

### 🔧 技术细节

性能优化：
- 容器缓存，可配置刷新间隔（默认 60 秒）
- 空间搜索结果缓存（1 秒缓存生存期）
- 生产工作站地面掉落物缓存清理
- 增量过滤日志记录（仅在状态变化时记录）
- 角色搜索的层遮罩优化

代码架构：
- 16,000 多行 C# 代码
- 对所有修改的游戏系统应用 Harmony 补丁
- 广泛的空值检查和错误处理
- 基于协程的异步操作（适当时使用）