附近制作（原作 IPA38 / mikeg）的分支版本，新增了快速存放排除项、从附近箱子取用燃料/矿石，以及一个附近物品定位命令。

附近的制作分支

附近制作分叉功能让你可以使用附近玩家建造的容器中存储的材料进行制作和建造，无需先将资源移入你的物品栏。

这是以下项目的源分支 附近制作 1.2.1 (原作者 IPA38 / mikeg) 包含快速存放排除项，以及从附近箱子为熔炉、窑炉、火堆和光源提供燃料/矿石辅助。

身份

作者	声波伤害
插件名称	附近制作分叉
插件 GUID	索尼克DM的英灵神殿附近制作分叉版
装配	附近的制作分支.dll
版本	1.5.3
配置文件	BepInEx/配置/com.sonicdm.valheim.nearbycraftingforked.cfg

做 不 请勿同时运行此分支与原始的 Nearby Crafting 插件。两者都会修改相同的 Valheim 方法；请只使用其中一个。

这可能会破坏其他同样修改了制作、建造或站点燃料补给的CraftFromChests风格插件。

功能

• 使用附近符合条件的容器中的材料进行制作。
• 使用附近可用容器中的材料进行建造。
• 批量快速存放可通过一个可配置的快捷键，将匹配的库存物品发送到附近的箱子中。
• 快速存入可以独立于附近制作功能单独启用或禁用。
• 宝箱和已停放推车上可选的快速存放发光效果（默认关闭；颜色和持续时间与物品定位无关）。
• 快速存放排除项默认会将消耗品、弹药、装备和实用物品保留在您的库存中。
• 每项排除/允许列表，附带 * 通配符（例如存放蘑菇时保留其他食物）。
• 熔炉、炭窑、高炉、营火、火把、火盆及类似设施交互时从附近箱子取用燃料（使用各预制体自身的燃料物品：木材、树脂、煤炭、灰矮人之眼等）。
• 可选从附近箱子中取出冶炼炉/窑炉矿石及其他可烧炼材料。
• 在附近的箱子和停放的推车中寻找 附近 控制台/聊天指令（高亮显示最近的匹配项）。
• 容器按由近及远的顺序处理。
• 可配置容器范围与玩家建造/移动容器过滤器。
• 兼容 BalrondConstructions 存储布局。
• 弹匣打空时可选自动装填 .cfg 磁盘上的文件更改（编辑、保存、在游戏内应用）。

批量快速存放

按下已配置的热键，将匹配的物品存入附近符合条件的箱子中。

• 物品只会被存入这样的箱子： 已包含该物品类型.
• 如果匹配的宝箱无法容纳全部数量，剩余物品可以继续放入另一个匹配的宝箱。
• 一条HUD消息会报告已存放了多少物品以及有多少个箱子收到了物品。
• 可选宝箱/推车发光（高亮宝箱（默认关闭）显示哪些容器收到了物品。 高亮颜色 接受十六进制（#248038）或 RGB（36,128,56 / 0.14,0.50,0.22）。不透明度为 高亮透明度 （滑块，默认值1）。持续时间为 高亮持续秒数 （默认15）。与物品定位分开。清除方式： 附近无敌人.
• 只有可堆叠物品会被存入（最大堆叠数量大于1）。
• 排除规则仅适用于快速存取。附近的制作和建造仍可从箱子中取用材料。

默认快速存入设置：

[快速存放] 已启用 = true 热键 = F6 高亮箱子 = false 高亮颜色 = #248038 高亮透明度 = 1 高亮持续秒数 = 15

快速存款排除项

默认设置刻意保守，以确保战斗/食物装备始终留在你身上：

[快速存放 - 排除项] ExcludeConsumables = true ExcludeAmmo = true ExcludeEquipment = true ExcludeUtility = true ExcludedItemTypes = ExcludedItems = AllowedItems =

设置	Purpose 用途
排除消耗品	保留食物、蜂蜜酒、药水等。
排除弹药	保留箭矢、弩矢和不可装备的弹药
排除装备	保留武器、护甲、盾牌、工具、火把
排除工具	保留功能物品类型
排除物品类型	额外 物品类型 要排除的名称（逗号分隔，不区分大小写）
排除物品	按预制体或共享名称强制排除特定物品
允许物品	例外：即使类型被排除，仍然存入这些

匹配规则

• 排除物品 和 允许物品 匹配物品 本地化显示名称, 预制体名称，以及内部共享名称（不区分大小写）。物品 描述内容不会被搜索.
• 偏好使用预制体风格的名称，例如 蘑菇黄显示名称也可以使用（燕麦粥 与菜品匹配，尽管它的预制体是 燕麦越橘果酱）
• * 支持通配符： 蘑菇*, *蛋, 熟肉.
• 一种图案， 以……开头 * (*贝尔*, 蛋）与显示名称匹配，并且 第一 预制体仅识别首词。复合预制体中后续词语将被忽略，因此 *贝尔* 存入蓝莓/越橘/覆盆子，而非燕麦（预制体 燕麦越橘果酱）。
• 如果某件物品同时出现在两个列表中， 排除物品 胜利.
• 排除项不影响制作或建造材料的获取。

实用示例

与 排除消耗品 = true，熟食、大锅食物和蜂蜜酒会留在你身上。使用 允许物品 仅限 剩余草料 你想放进箱子的东西。下方的预制件ID与 英灵神殿维基物品ID / 食物 列表。

通常随身携带（默认排除项已涵盖这些）

这些通常是你在战斗和成长时最需要的食物——请不要排除它们：

• 烹饪好的空间站食物（熟肉, 熟鹿肉, 烤鱼, 熟蛇肉, …)
• 大锅／烤箱餐食（皇后果酱, 胡萝卜汤, 香肠, 面包, 血布丁，雾隐地/灰烬之地菜肴，……）
• 蜂蜜酒和大麦酒（次级蜂蜜酒生命值, 中型蜂蜜体力, 蜜酒霜冻抗性, 大麦酒, …) — 通配符 蜂蜜酒* / 大麦酒* 如果你以后允许广泛使用消耗品，又需要重新将它们排除在外
• 蜂蜜酒基底（蜜酒基地*)如果在你的配置中这些显示为可存入的堆叠

生肉屠夫肉（生肉等）通常是 材料，不是消耗品，所以他们无需加入允许列表即可存入。

游戏前期——草地／黑森林采集

探索时可安全存入的多余物品（弱效食物；也是制作材料，如果正在酿造，保留一小堆）：

AllowedItems = 蘑菇,黄蘑菇,蓝蘑菇,树莓,蓝莓,蜂蜜

或者更短：

允许物品 = 蘑菇*,树莓,蓝莓,蜂蜜

可选的农场盈余（也用于食谱——只有在充足时才允许存入）：

允许物品 = 蘑菇*,树莓,蓝莓,蜂蜜,胡萝卜

游戏中期 — 山地 / 平原

加入云莓（平原）和可选的洋葱盈余（山地农场作物/汤原料）：

允许物品 = 蘑菇*,树莓,蓝莓,云莓,蜂蜜,胡萝卜,洋葱

后期——迷雾之地/灰烬之地的采集物

这些蘑菇/植物是可以食用的 和 烹饪/以太材料的关键。仅在储备充足时允许存入：

# 迷雾之地 允许物品 = 蘑菇*,树莓,蓝莓,云莓,蜂蜜,法师帽菇,巨魔蓬菇 # 灰烬之地（相关时添加） 允许物品 = 蘑菇*,树莓,蓝莓,云莓,蜂蜜,法师帽菇,巨魔蓬菇,烟粉菇,蕨菜,藤蔓莓*

垃圾消耗品

布克佩里斯（呕吐浆果) 通常都值得舍弃：

AllowedItems = 蘑菇*,覆盆子,蓝莓,云莓,蜂蜜,呕吐莓

弹药 + 饲料

排除弹药 = true 允许物品 = 蘑菇*,覆盆子,蓝莓,云莓,蜂蜜,木箭,燧石箭

贵重物品 / 名称族群

排除物品 = 金币,龙蛋

排除物品 = *奖杯*,龙*,*蛋

排除物品类型 = 奖杯,杂项

新手预设——早点存放采集物，保留食物/蜂蜜酒/装备

[快速存放 - 排除项] 排除消耗品 = true 排除弹药 = true 排除装备 = true 排除工具 = true 排除物品类型 = 排除物品 = 金币,龙蛋 允许物品 = 蘑菇*,树莓,蓝莓,云莓,蜂蜜,呕吐果

展开 允许物品 随着你的进度推进（胡萝卜/洋葱→法师帽/巨人→灰烬之地采集物），当这些堆叠物变成杂物，而不再是你手头还需要留用的材料时。

空间站燃料与矿石

当你与燃料开关、火源或灯具互动时，你会 不 已经拥有所需物品，模组可以拉取 一 从附近符合条件的宝箱中匹配物品放入你的物品栏，以便原版机制可以消耗它。

这涵盖了英灵神殿的共享组件（燃料类型来自预制件，而非硬编码列表）：

建筑	组件	常见燃料 / 输入物
熔炉、炭窑、高炉、以太精炼厂	冶炼厂	煤炭／木材（燃料）＋矿石／废料（可选矿石辅助）
营火、壁炉、木制/铁制火把、火盆（含蓝色）	壁炉	木材、树脂、煤炭、灰矮人之眼等。
使用自身燃料的烹饪台	烹饪台	预制体 燃料物品
护盾生成器	护盾生成器	预制体 燃料物品 列表

不可再填充的/无限燃料的灯笼和微光留给原版处理。没有后台“保持一切点亮”的自动补充燃料（仅客户端限制）。

辅助功能仅对本地玩家生效，且仅在站点实际接受燃料/矿石时才会运行（未满、非壁炉点击切换）。箱子取用是在客户端尽力而为的——与附近制作消耗的模式相同——如果其他玩家正在使用同一个箱子，在某些专用服务器设置下可能会出现不同步。

[空间站燃料] 启用 = true 从箱子中启用矿石 = true

道具定位（附近)

找出附近符合条件的宝箱和停放的推车中哪些含有某物品，并让最近的匹配项发光（范围和容器筛选条件与制作时相同）。

命令	效果
附近的树脂 / 附近树脂	按预制体/共享名称搜索（* 允许使用通配符，与快速存款列表相同）
附近 / 附近	搜索当前持有/选中的物品
附近安全 / 清除附近	立即清除高亮

定位 是……的别名 附近 （相同参数）。

匹配使用快速存放模式 * 通配符，并且还将通配符之间的文本视为子字符串——因此 焰灵, 焰灵*，以及 *翻涌* 全部找到两者 焰核 和 浮游炮奖杯还会匹配 本地化显示名称 （例如 威严甲壳 发现 女王之心 / 女王探求者掉落物），以及预制体和共享/令牌名称。仅搜索玩家建造的容器库存（壁挂式奖杯架不包括在内）。

高亮会在配置的持续时间后自动清除。新的搜索会替换上一组结果。反馈仅为本地聊天栏中的一行（例如 在3个宝箱中找到了树脂。）。 发光颜色 接受十六进制或RGB，规则与快速存入相同 高亮颜色.

[物品定位] 已启用 = true 最大高亮数 = 10 持续秒数 = 15 发光颜色 = #8C731A 发光透明度 = 1

配置

附近的制作分支包含以下选项：

• 启用或禁用该模组。
• 启用或禁用附近资源建筑。
• 正在更改附近容器范围。
• 忽略正在使用中的船只和推车（停放着的推车仍可选中）。
• 忽略歼灭者（默认开启）。
• 要求容器必须由玩家建造。
• 启用或禁用制作需求指示器修复。
• 启用或禁用批量快速存放。
• 正在更改批量快速存放快捷键。
• 可选的快速存放箱子/推车发光、十六进制颜色、不透明度和持续时间（默认关闭）。
• 快速存入类型排除以及单个物品的排除/允许列表。
• 从附近箱子获取站点燃料/矿石辅助。
• 物品定位（附近 命令）发光和持续时间。
• 当以下文件发生变化时自动重新加载配置： .cfg 磁盘上的更改。
• 可选的手动重新加载配置热键（默认未设置）。
• 巴尔隆德建筑兼容性。
• 调试日志记录。

配置文件生成于：

BepInEx/config/com.sonicdm.valheim.nearbycraftingforked.cfg

设置也可以通过兼容的模组配置界面进行更改（例如官方 BepInEx 配置管理器）。

配置重载

[常规] AutoReloadConfig = true ReloadConfigHotkey =

• 自动重载配置 （默认 真）注视着 .cfg 并在你保存后不久重新加载。
• 重载配置快捷键 是可选的，并且 默认未设置 这样就不会与其他模组冲突。如果你想要手动强制重新装填，请分配一个未占用的按键。
• 重新加载后容器缓存失效。

安装

模组管理器（r2modman / Thunderstore）

1. 禁用或卸载原版 附近制作 如果存在包裹，请打包。
2. 安装 附近制作分叉 （或将本地包 / DLL 导入配置文件）。
3. 先启动一次以生成配置文件，然后根据需要编辑排除项。
4. 与 自动重载配置 = 真，保存配置无需重启 Valheim 即可应用更改。

推荐的r2modman插件布局（与其他受管理的模组相同模式）：

BepInEx/plugins/SonicDM-NearbyCraftingForked/ NearbyCraftingForked.dll manifest.json README.md CHANGELOG.md icon.png

手动

1. 为英灵神殿安装 BepInExPack。
2. 放置 附近制作分支.dll 在 BepInEx/plugins/ （或如上所述的子文件夹）。
3. 移除所有原始 附近制作.dll 从个人资料中。

笔记

• 附近制作分支使用英灵神殿的配方需求逻辑，因此英灵神殿1.0中引入的条件配方需求能够被正确处理。
• 资源消耗可以在玩家背包和附近的多个符合条件的容器之间分摊。
• 歼灭者（焚化炉）默认通过以下方式忽略： 容器.忽略歼灭者 （快速存放、制作/建造，以及站点燃料/矿石辅助）。
• 这可能会破坏其他类似CraftFromChests的插件，这些插件也会修改制作、建造或站点燃料补充。
• 如需排查问题，请在模组配置中启用调试日志记录，并检查 BepInEx/LogOutput.log.
• 启用 调试容器详情 仅在需要时；它很吵。

制作人员

• 作者： 索尼克DM
• 原版模组： 附近制作 由 IPA38 / mikeg 制作 (com.mikeg.valheim.nearbycrafting）。
• 此分支新增了快速存放排除控制、允许列表例外、通配符、配置实时重载，以及以独立插件身份从箱子中存取空间站燃料和矿石的功能。

构建（开发者）

默认 Valheim / BepInEx 参考文件夹：

E:\Scripts\Valheim Mods\Reqs

.\build.ps1 .\build.ps1 -Package .\package.ps1 .\package.ps1 -SkipBuild .\build.ps1 -LibDir "D:\Somewhere\ValheimRefs"

package.ps1 在以下位置生成与Thunderstore兼容的zip文件： dist/ 每 Thunderstore 包文档:

• manifest.json, README.md, 图标.png （256×256），可选 更新日志.md，以及 附近制作分支.dll 在 压缩包根目录
• 打包前校验清单字段、UTF-8 自述文件及图标尺寸

发行（开发者）

GitHub 托管的 Actions 不能 编译这个模组（Valheim 已管理 动态链接库保留在本地）。发布版本从你的机器上切出：

1. 撞击 插件版本，csproj <版本>、 清单.json 版本号 一起。
2. 添加一个 ## X.Y.Z 到 更新日志.md.
3. 本地打包（.\package.ps1），然后发布：

.\release.ps1 -SkipPackage # 使用已有的 dist\NearbyCraftingForked-X.Y.Z.zip # 或 .\release.ps1 # 先打包再发布

release.ps1 验证版本、标签 vX.Y.Z推送并创建 GitHub Release，其正文为对应的 CHANGELOG 部分，并附带 Thunderstore zip 包。该 释放 标签推送触发的工作流会在标签先到达时刷新那些注释。