【小型MOD】Frank的连锁采集 – 适用V3.2（原创）

■ 这是什么

一个轻量的连锁采矿模组：按住触发键（默认 ~）挖开一块矿石时，自动把同一水平层里相邻的同种矿石，以及和它们挨着的砾石一起采掉。

基于v3.2(b10)构建，对于其他版本暂未适配计划。

和常见的”连锁挖矿”不同，它刻意做得比较克制：

· 默认只在同一水平层扩散，不会顺着矿脉把整座山挖穿；

· 掉落数量按游戏原版采集规则结算；

· 不修改任何游戏 XML，不新增物品或方块，可以随时安装、随时卸载。

────────────────────────────────────────

■ 功能特性

────────────────────────────────────────

· 一键连锁：按住 ~ 挖矿，同层矿脉一次采完，省去反复挥镐。

· 掉落一致：严格复刻原版采集公式，母矿技能、矿工护甲、食物加成、拾荒者手套、当前工具加成、存档的开采产出倍率。

· 同层优先：默认只在同一 Y 层做 4 向扩散，纵向不蔓延。

· 立体模式：配置里可切换为六向立体连锁（All）。

· 按键可选：默认按住 ~ 触发；配置里留空即免按键，挖矿自动连锁。

· 范围可选：只连锁同种矿 / 连锁所有矿石 / 连锁所有带 ore 标签的方块。

· 不留孤岛：达到上限时会自动换块，避免留下孤零零的悬空矿物。

· 上限可控：单次连锁最多 32 块，可自行调整。

· 日志可控：每次连锁一行汇总，可以关掉。

────────────────────────────────────────

■ 前置要求

────────────────────────────────────────

1. 必须安装 TFP Harmony 前置（0_TFP_Harmony）。

2. 必须关闭 EAC 启动游戏（带代码的模组在 EAC 开启时不会被加载）。

3. 如果安装过其它连锁采集 / 连锁挖矿类模组，请先删除，避免一次挖矿触发两次连锁。

────────────────────────────────────────

■ 安装方法

────────────────────────────────────────

1. 解压压缩包，把里面的 FranksChainHarvest 文件夹整个放进：

   …\7 Days To Die\Mods\

2. 确认目录结构是：

   Mods\FranksChainHarvest\ModInfo.xml

3. 启动游戏，日志里出现下面两行就是加载成功：

   [FrankChain] Config loaded: …\ChainHarvestConfig.xml

   [FrankChain] Loaded. Trigger key: BackQuote, max chain: 32, …

4. 进游戏按住 ~ 挖一块矿石试试。

────────────────────────────────────────

■ 使用方法

────────────────────────────────────────

· 按住 ~ 不放，用镐子挖矿石 → 同层的同种矿石 + 相邻砾石一起被采掉。

· 只有矿石会触发连锁；挖砾石本身不会触发。

· 默认只连锁同一种矿石（挖铁矿不会带出铅矿），需要混连见下方 OreMatch。

· 不想要连锁时松手正常挖即可，等同原版。

────────────────────────────────────────

■ 配置说明（Mods\FranksChainHarvest\ChainHarvestConfig.xml）

────────────────────────────────────────

TriggerKey        触发键。填 Unity KeyCode 名称：BackQuote（即 ~）、LeftAlt、

                  RightShift、F6、Mouse2 等；留空或写 None = 免按键，挖矿即连锁。

ChainMode         Horizontal = 同层 4 向（默认）；All = 六向立体连锁。

                  两种模式共用 MaxChainCount 上限。

OreMatch          SameBlock = 只连锁同种方块（默认）；

                  AllOres   = 连锁 OreBlocks 里列出的所有矿石；

                  Tag       = OreBlocks + 所有带 ore 标签的方块（兼容模组矿）。

MaxChainCount     一次连锁最多破坏多少块（不含你亲手挖掉的那块），默认 32。

MaxExtraBlocks    为避免留下孤立方块允许的超限块数，默认 8；改 0 就是严格不超限。

Cooldown          同一玩家两次连锁的最小间隔（秒），默认 0.1。

LogChainSummary   是否在日志输出每次连锁的一行汇总，默认开启；不想要改 false。

EnableDebugLogs   更详细的调试日志，默认关闭。

OreBlocks         可作为连锁起点、并会被连锁的矿石方块列表。

CompanionBlocks   伴生方块（默认 terrGravel），不会自己触发连锁。

■ 三套现成配置

· 默认省心：TriggerKey = BackQuote，ChainMode = Horizontal，OreMatch = SameBlock

· 立体爽快：ChainMode = All，其余默认（注意 32 块上限会更快用满）

· 免按键懒人：TriggerKey 留空，ChainMode = All，OreMatch = AllOres

────────────────────────────────────────

■ 已知限制

────────────────────────────────────────

1. 只对本机玩家生效：单机、以及自己开房当主机时的房主。专用服务器上的远端玩家不会触发。

2. 免按键模式下，炸药或其它模组造成的矿石破坏也会触发连锁。

3. All 模式会更快用满 32 块上限。

4. 连锁破坏的方块没有原版破坏特效和音效。

5. 掉落直接进背包/物品栏，满了才掉在地上。

────────────────────────────────────────

■ 常见问题

────────────────────────────────────────

Q：按住 ~ 挖矿完全没反应？

A：按顺序检查四件事——是否关闭 EAC 启动；是否装了 TFP Harmony；TriggerKey 是否写对；Mods 里是否还留着别的连锁挖矿模组。再看日志里有没有 [FrankChain] 开头的行。

Q：怎么一次挖了这么多？

A：默认同层连锁最多 32 块，可以在 MaxChainCount 调小；如果用 All 模式会更快用满。

Q：为什么显示挖了 33 块？

A：为了不留下孤立方块，允许在极端地形下最多多挖 MaxExtraBlocks 块（默认 8，实际一般只多 1 块）。想严格不超过 32，就改成 0。

Q：多人游戏能用吗？

A：单机和”自己开房当主机”可以；专用服务器上的远端玩家暂不支持。

Q：安装/卸载会坏存档吗？

A：本模组不改 XML、不加物品方块、不写存档数据，可以随时装卸；习惯上还是建议先备份。

────────────────────────────────────────

■ 更新日志

────────────────────────────────────────

1.1.0

· 新增 ChainMode：Horizontal（默认）/ All 立体连锁。

· 新增 OreMatch：SameBlock / AllOres / Tag。

· 新增免按键模式（TriggerKey 留空）。

· 新增 LogChainSummary 汇总日志开关。

· 连锁掉落改为方块确认破坏后再结算，避免保护区误发。

1.0.0

· 首版：按住 ~ 同层连锁矿石与砾石，掉落与手挖一致，自动消除孤立方块。

────────────────────────────────────────

■ 许可

────────────────────────────────────────

可自由使用、修改、转载本模组，请保留作者与出处，禁止售卖。