索尔

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

=== 如果你喜欢我的模组，请点个赞/投个票吧，这对你来说不花一分钱，却能帮我把这个模组推荐给更多人 ===

雷神是一个全面的生活质量模组，能自动化《英灵神殿》中许多重复性任务，同时保持游戏平衡性与沉浸感。该模组以北欧雷神命名，为你的维京聚落带来力量与效率。

**16,000多行精心编写的代码**，包含大量性能优化、增量过滤日志记录以及用于多人游戏支持的服务器同步配置。

---

### ⚡ 核心特性

#### 🔥 自动燃料系统
自动从附近的容器为你的站点补充燃料——再也不用手动运送燃料了！

**支持的站点：**
- **壁炉与火炬** - 立式火炬、壁挂火炬、火坑、热水浴池
- **熔炉/高炉与窑炉** - 可配置上限自动添加矿石和燃料
- **烹饪台** - 石炉可自动收集烹饪好的食物，防止烧焦
- **蜂箱** - 自动收集蜂蜜至附近容器，并显示时间
-**发酵桶** - 自动添加蜂蜜酒基液作为燃料，并在计时器显示完成后自动收集成品蜂蜜酒
- **风车** - 自动添加大麦、可选风力绕行、地面面粉清理
- **纺车** - 自动将亚麻线存入容器
- **埃特尔精炼厂** - 自动供给树液/软组织，带溢出保护
- **护盾生成器** - 用骨头碎片保护你的基地

**智能功能：**
- **分批装填** - 将燃料均匀分配到多个窑炉中（轮询）
- **窑炉输出限制器** - 当容器达到阈值时停止煤炭生产
- **地面物品清理** - 自动收集站点产出的掉落煤/面粉/线
- **湮灭器优先** - 在容器之前使用湮灭器作为全局燃料源
- **尤勒克拉普自动装填** - 每天从玩家库存中自动填充礼物容器一次
- **整理存储** - 仅将产出物存入已有该物品类型的容器中
- **保留最后一件物品** - 安全功能，确保容器不会被完全清空

---

#### 🎣 拖网渔船捕鱼系统
**航行时钓鱼！** 将钓鱼用品放入船上的货舱，航行时即可自动捕鱼。这是托尔最精密的系统之一。

工作原理：
- **需要钓竿** - 启用水域捕鱼（鲈鱼、金枪鱼、鮟鱇鱼等）
- **需要深渊鱼叉** - 启用水下生物狩猎（海蛇、水蛭、骨颌鱼）
-**需要鱼饵** - 不同的鱼饵能吸引不同的鱼：
  - 基础鱼饵 → 河鲈、狗鱼（任何生物群系的常见鱼类）
  - 海洋鱼饵 → 金枪鱼、珊瑚鳕鱼 + 海蛇
  - 森林鱼饵 → 巨魔鱼
  - 沼泽鱼饵 → 巨型鲱鱼 + 水蛭  
  - 洞穴鱼饵 → 四齿鲦（山地湖泊）
  - 平原鱼饵 → 石斑鱼
  - 雾隐之地的鱼饵 → 河豚、鮟鱇鱼
  - 灰烬之地鱼饵 → 熔岩鱼 + 骨颚鱼
  - 深北鱼饵 → 北方鲑鱼

**水域生物自动狩猎：**
- **生命值阈值系统** - 当生命值低于可配置的百分比时，自动捕捉蛇、水蛭、骨颚兽
鱼叉模拟——逼真模拟鱼叉击杀并掉落战利品
- **星级追踪** - 分别追踪0★、1★、2★怪物的击杀数

鱼饵（可选——范围扩大30米）：
- **奖杯**（优先使用 - 价值较低）：所有35种以上的奖杯类型都可作为诱饵
- **制作材料**（次要用途）：内脏、脖颈肉、血袋、软泥、冻腺、腐肉等。
- 每捕获3条鱼消耗1个诱饵
- 可见的鱼漂在船后生成，显示吸引区域

**动态钓鱼修正：**
- **每日变化** - 每个游戏日都有随机捕捉率（基础30-60%）
- **天气效果** - 暴风雨天气 +8%，晴朗天气 -5%
- **时段** - 黎明/黄昏 +12%，午夜 +6%，正午 -8%
- **技能成长** - 钓鱼技能 0-100 最多增加 +15% 上钩率
- **基于技能的射程** - 射程从30米（技能0）到130米（技能100）
- **非原生生态加成** - 对在原生生态之外发现的鱼，捕获率+10%

钓鱼技能整合：
- 从拖网渔获中获得钓鱼经验（可配置倍率）
- 根据每条鱼捕获时模拟的“收线时间”获得经验值
- 技能提升所需最低鱼量阈值

**钓鱼指示器界面：**
- 在小地图附近显示当前钓鱼状况
- 显示天气、时间和捕捉几率修正
- 仅在钓鱼技能达到阈值要求时可见

**来鱼吧！（唤蛇术）**
- 每个游戏日自动生成一条蛇
- 需求：海洋生物群系 + 夜晚 + 雷暴
- 包含戏剧性音效（呼喊声 + 庆祝声“weeee！”）
- 蛇在距玩家可配置的距离处生成

---

#### ⛵ 船岸装卸系统
在范围内时，自动在船只、货车和岸上容器之间转移物品。

**舰船 ↔ 岸上转运：**
- 将货物从停靠的船只转移到岸上集装箱
- 可配置的传输范围（默认10米）
“需要现有物品”安全设置——仅转移到匹配的容器中

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

**湮灭者溢出缓冲区：**
- 将歼灭者用作临时分拣缓冲区
- 购物车溢出 → 清除器 → 存储容器（如果有空间）
- 可配置的允许/禁止物品类型列表
- 防止意外销毁贵重物品

**智能筛选：**
- 物品允许列表（白名单）或禁止列表（黑名单）
- 可按传输类型配置
- 带物品数量的消息格式

---

#### 🔨 从容器中制作（CFC）
直接从附近的容器中获取制作材料，无需手动将物品移入你的背包。

**核心特色：**
- **范围搜索** - 从可配置半径内的容器中取出材料
- **适用于所有制作** - 工作台、锻造、烹饪、建造、升级
- **燃料与矿石补给** - 从容器向空间站添加燃料/矿石

**容器筛选：**
- 排除集装箱
- 排除货车/手推车容器  
- 排除木箱、强化箱、黑金属箱、私人箱
- 每个过滤器可独立配置

**视觉反馈：**
- 幽灵连接线显示正在访问哪些容器
- 从容器中获取资源时，资源数量会闪烁提示
- 可配置闪光颜色

**快捷键操作：**
- **防止修饰键**（Alt）- 开关CFC行为
拉取物品键（Ctrl）——将食材拉取到背包，而非直接制作
- **全部装填键**（Shift）- 一次性抽取所有可用的燃料/矿石

**安全功能：**
- **留一个** - 容器中始终保留至少1个物品
- **按距离拉取** - 优先最近的容器
- **燃料/矿石禁止类型** - 防止燃烧珍贵木材（圆木、精木）

**奥丁生活质量兼容性：**
- 检测 OdinsQoL 堆叠大小和重量修改
- 相应调整计算

---

#### 🐗 动态繁殖系统
持续进行繁殖管理，并自动淘汰多余个体以防止过度繁殖，同时保留繁殖对。

**连续繁殖逻辑：**
- 在默认人口上限时淘汰最年长的未命名后代
- 允许父母无限繁殖而不受上限限制
- 命名的动物（通过“驯服”命令）永远不会被淘汰——它们是你珍贵的育种资源

**每种生物种群上限：**
- **野猪** - 默认每位玩家4只
- **狼** - 默认每名玩家4只
- **熏鲑鱼** - 每名玩家默认2份
- **鸡（母鸡）** - 每名玩家默认12只
- **阿斯克文斯** - 默认每名玩家2个
- 无玩家在线时的基地上限（服务器）
- 随在线玩家数量而变化

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

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

**网箱养殖的坠落防护支持：**
- **鸡蛋** - 从笼子地板碎片掉落（1x1，2x2）
**野猪幼崽** - 从笼子地板碎片坠落（1x1，2x2）
- **狼崽** - 从笼子地板碎片掉落（1x1、2x2）
**洛克牛犊** - 从笼子地板碎片（1x1、2x2）掉落
- **亚斯文蛋** - 从笼子地板部件（1x1、2x2）掉落

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

---

#### 🔫 飞船炮塔自动装填
*用于长船升级模组*

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

---

### ⚙️ 配置

Thor 提供 **200+ 项配置选项**，按逻辑分区整理，并支持服务器同步：

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

调试日志（精细控制）：
- 各功能调试开关：HereFishy、AutoFuel、ShipToShore、TrawlerFishing、CraftFromContainers、Breeding、Performance、General
- Delta 过滤日志可防止日志刷屏
- 仅在状态变化时记录日志，不重复记录静态值

**服务器同步设置：**
所有影响游戏玩法的设置从服务器同步到客户端：
- 钓鱼范围、上钩率、鱼饵消耗
- 转移范围与冷却时间
繁殖上限和淘汰间隔
- 容器搜索范围

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

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

---

### 📦 需求

- **英灵神殿** - 灰烬之地更新或更晚
- **BepInEx 5.4.x** - Mod加载框架
- **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`

---

### 🎮 兼容性

- **服务器/客户端：** 客户端模组，通过服务器同步设置为多人游戏提供支持
- **适用版本：** 英灵神殿 灰烬之地更新
- **已知兼容模组：**
  - 基于霜巨人的模组
  - OdinsQoL（自动检测以调整堆叠/重量）
  - 长船升级（用于舰船炮塔自动装填）
  - 大多数其他BepInEx模组

---

### 🔧 技术细节

**性能优化：**
- 具有可配置刷新间隔的容器缓存（默认60秒）
- 空间搜索结果缓存（1秒 TTL）
- 生产站清理的地面掉落物缓存
- Delta 过滤日志（仅在状态变化时记录）
- 角色搜索的图层蒙版优化

**代码架构：**
- 16,000+ 行 C# 代码
- 针对所有修改过的游戏系统的 Harmony 补丁
- 全面的空值检查和错误处理
- 在适当情况下使用基于协程的异步操作