原料剔除器

允许你配置那些在配方中不应与其类别食材相匹配的物品。

模组核心定位

这是一款为《星露谷物语》1.6 版本开发的轻量 SMAPI 模组，核心作用是：在不修改物品本身任何属性的前提下，将指定 “屏蔽物品” 加入可配置清单，使其永远无法匹配制作 / 烹饪配方中的 “类别型原料”。

这里的 “类别型原料” 指配方中按 “类别” 定义的原料（如 “任意鱼类”），而非某一种具体物品，这类原料会匹配该类别下的所有物品。

模组实用场景

若仅使用原版的三类基础类别（鱼类、牛奶、蛋类）（原版或多数模组均如此），本模组并无实用价值；但当模组 / 内容包需要主动使用非原版类别型原料时，物品分类的混乱问题会凸显，此时本模组就能解决核心痛点：

宝石类别冗余问题：想制作 “需切割宝石” 的配方，但该类别还包含石英、冰晶泪等极易获取的采集类矿物；

原版类别精准化需求：单纯想阻止部分原版物品匹配标准类别（鱼类 / 蛋类 / 奶类）—— 比如认为蜗牛不算海鲜、想临时禁止冰箱里的传奇鱼匹配 “任意鱼类” 配方、觉得虚空蛋不应用于普通煎饼（仅适配虚空煎饼）。

现有解决方案对比（当前技术限制下）

已知解决该问题的方式有「2 种简易方案 + 1 种复杂方案」，各有明显弊端：

方案 1：在模组 / 内容包中重新归类问题物品

操作逻辑：将不符合预期的物品归类到其他类别；

核心弊端：物品类别关联游戏内大量机制，易引发不可预见的连锁反应：

物品可能无法卖给原对应商贩；

采集工、铁匠、探矿者等职业加成失效；

物品在收藏图鉴中的位置错乱；

其他模组依赖原版类别逻辑，可能出现兼容问题（如传奇鱼被归为 “蔬菜类”）；

存档兼容性灾难：星露谷会将物品完整属性存入存档（而非仅存 ID 和少量数据），即使卸载模组，已存在的物品仍会保留修改后的类别，导致玩家在既有存档中安装 / 卸载模组时出现大量问题。

方案 2：本模组的实现方式

操作逻辑：通过 Harmony 补丁，以相对简单的方式修改配方匹配的核心方法，直接屏蔽指定物品匹配类别型原料；

核心优势：不改动物品本身属性，仅拦截配方匹配逻辑，无存档兼容问题，不影响物品其他功能。

方案 3：全面重构配方匹配逻辑（复杂方案）

操作逻辑：为所有制作相关系统打 Harmony 补丁，适配 “上下文标签”；

核心弊端：实现难度远高于本模组，且会打破其他模组对配方机制的所有预设，导致大量兼容问题。

模组工作原理

核心运行逻辑

本模组允许你在 config.json 配置文件中定义一份限定物品 ID 清单，也可通过 GMCM 配置。

被列入清单的 “屏蔽物品”，永远无法匹配配方中对应的类别型原料，但如果配方直接指定该物品作为原料，仍可正常匹配。

默认屏蔽物品（ID 清单）

(O)159,(O)160,(O)163,(O)682,(O)775,(O)92,(O)725,(O)726

对应物品：所有珍稀传奇鱼 + 树液、橡木树脂、松焦油。

默认配置效果示例

无法用冰川鱼制作生鱼片😜；

若 “土豆沙拉” 配方要求「土豆 + 任意采集类物品」，现在只会匹配玩家背包中除树液外的所有采集类物品；

若 “树液炖鱼” 配方要求「树液 + 任意鱼类」，树液可正常匹配，但传奇鱼不会被纳入 “任意鱼类” 的匹配范围；

若 “传奇盛宴” 配方直接指定「传奇鱼 + 若干五彩碎片」，该配方可完全正常生效。

模组为《星露谷物语》注入了源源不断的生命力，让这款经典的农场模拟游戏始终保持着新鲜感。创作者们用代码和创意，或是填补原版内容的空白，或是颠覆传统的玩法机制，甚至构建出全新的剧情线与地图。正是这些天马行空的想法，推动着星露谷的世界不断拓展。愿每一位创作者的灵感都能落地生根，也愿每一位玩家都能在星露谷的模组宇宙里，寻得独属于自己的那份治愈与快乐。

注意！！ 此mod与其他相同类型的mod有冲突，请单独使用！