自动化UI - 机器自动化

仓库自动化

仓库自动化帮助你实现星露谷物语农场的自动化。通过将箱子与机器连接，你可以自动将原材料装载到机器中，并将成品收获回箱子中。

安装：下载 zip 文件并解压到你的 StardewValley/Mods 文件夹中。

如何使用（通过一个简单示例）

[b]让我们设置一个简单的熔炉来自动为你冶炼铜锭：[/b]

1. 放置物品：放置一个箱子和一个熔炉。
2. 为箱子贴标签：将鼠标悬停在箱子上并按 H。为它输入一个名字，例如 MyChest，然后按 Enter。
3. 为熔炉贴标签：将鼠标悬停在熔炉上并按 T。为它输入一个名字，例如 MyFurnace，然后按 Enter。
4. 按 U 打开仓库菜单用户界面。你可以在模组文件夹的 config.json 中更改快捷键（游戏首次启动后会生成该文件）。
5. 添加规则：按快捷键 U 打开菜单，然后点击 添加规则。填写以下字段：
   • 分组：冶炼
   • 输入：铜矿-5;煤炭-1
   • 输入箱子标签：MyChest
   • 机器标签：MyFurnace
   • 输出箱子标签：MyChest
   • 点击 保存。
6. 观察运行：将你的铜矿和煤炭放入箱子。模组会自动抓取它们，喂给熔炉，并将成品铜锭放回你的箱子中！
7. 在模组文件夹的 config.json 中编辑快捷键。游戏首次启动后生成该文件，然后编辑你的快捷键。

[b]模组功能[/b]

• 箱子与机器网络：在你已贴标签的箱子和机器之间自动移动物品。
• 简易规则编辑器：输入你的配方，选择你的机器分组，并决定物品的流向。
• 箱子和机器可以放在任何地方，无需并排放置。
• 仅收集/“空”规则：在输入字段中输入“Empty”、“None”或“Blank”。这告诉模组仅收集物品，而不会尝试放入任何东西。对于虫桶、蘑菇树桩和蜂房来说非常完美！
• 本地化复选框：通过仓库界面上简单的复选框，即时开启或关闭任何规则。
• 物品储备：保护你的物品。告诉模组“在我的箱子里至少保留 20 个木材”，你的机器就永远不会触碰这些受保护的物品。
• 分组下拉菜单：通过一个干净的下拉列表，轻松地将你的规则组织到文件夹或类别中。
• 随处可用：你已贴标签的箱子和机器可以在你农场的任何地方工作，包括在棚屋、温室、畜棚或地窖内。

[b]生产流程示例（机器链）[/b]

你可以将多台机器链接起来，创建全自动的生产线！以下是一些设置方法：

1. 冶炼线（硬木 ➔ 木材 ➔ 煤炭 ➔ 铜锭）

此设置自动将你的硬木转化为木材，再将木材转化为煤炭，然后用这些煤炭来冶炼你的铜矿——全程仅使用一个箱子！

• 箱子设置：放置一个箱子并将其标记为 Chest1。
• 机器设置：将碎木机标记为 Chipper1，将木炭窑标记为 Kiln1，将熔炉标记为 furnace1。
• 创建以下 3 条规则：
  • 规则 1（碎木机）：
    • 输入：硬木-1
    • 输入箱子：Chest1
    • 机器标签：Chipper1
    • 输出箱子：Chest1
  • 规则 2（木炭窑）：
    • 输入：木材-10
    • 输入箱子：Chest1
    • 机器标签：Kiln1
    • 输出箱子：Chest1
  • 规则 3（熔炉）：
    • 输入：铜矿-5;煤炭-1
    • 输入箱子：Chest1（确保你同时将铜矿也放在这个箱子里）
    • 机器标签：furnace1
    • 输出箱子：Chest1

工作原理：只需将你的生硬木和铜矿放入 Chest1。模组会取出硬木制造木材，取出木材制造煤炭，最后将这些煤炭与你的铜矿结合，最终在 Chest1 中留下成品铜锭！ [img]https://staticdelivery.nexusmods.com/mods/1303/images/47840/47840-1781779577-353305598.png[/img]

以下是用于全自动蜂蜜酒酿造厂的逐步设置，它会被动收集蜂蜜，将其酿造成蜂蜜酒，并在酒桶中陈酿至完美：

[b]2. 蜂蜜 ➔ 蜂蜜酒 ➔ 陈酿蜂蜜酒（蜂蜜酒酿造厂）[/b]

此设置被动收获蜂蜜，将其酿造成蜂蜜酒，并在酒桶中陈酿至铱星品质——全部利用一个箱子！

• 箱子设置：放置一个箱子并将其标记为 Chest1。
• 机器设置：将你的蜂房标记为 BeeGrid1，将你的小桶标记为 MeadKegs1，将你的地窖木桶标记为 AgingCasks1。
• 创建以下 3 条规则：
  • 规则 1（蜂房）：
    • 输入：空（被动收集蜂蜜，不消耗任何东西）
    • 输入箱子：（输入“Empty”）
    • 机器标签：BeeGrid1
    • 输出箱子：Chest1
  • 规则 2（小桶）：
    • 输入：野蜂蜜-1（或任何特定的蜂蜜类型）
    • 输入箱子：Chest1
    • 机器标签：MeadKegs1
    • 输出箱子：Chest1
  • 规则 3（木桶）：
    • 输入：蜂蜜酒-银星-1（仅喂给银星品质的蜂蜜酒）
    • 输入箱子：Chest1
    • 机器标签：AgingCasks1
    • 输出箱子：Chest1

工作原理：当你的蜂房生成蜂蜜时，模组会收集并存入 Chest1。然后立即装入你的小桶制作蜂蜜酒，再将蜂蜜酒放回 Chest1。最后，蜂蜜酒被送入地窖木桶中陈酿，你优质的、高价值的陈酿蜂蜜酒便会安全地存回 Chest1！

[b]3. 诱饵收获（虫桶）[/b]

由于虫桶不需要输入物品，我们可以使用“Empty”规则来安全地收获诱饵，而不会破坏虫桶的蠕动动画。

• 规则设置：
  • 输入：Empty
  • 输入箱子标签：（输入“Empty”）
  • 机器标签：WormFarm
  • 输出箱子标签：BaitChest

[b][u]UI 0.3.0 说明[/u][/b]

[b][u][img]https://staticdelivery.nexusmods.com/mods/1303/images/47840/47840-1782028685-757615443.png[/img][/u][/b]

[b]1. 实时搜索栏[/b] [list] [][b]作用：* 允许你实时过滤规则。[/] [][b]通俗解释：** 如果你有几十条自动化规则，只想找到你的冶炼设置，只需在此框中输入“熔炉”或“铜”。列表会立即缩小，只显示匹配的规则。[/*] [/list]

[b]2. 可折叠规则分组（例如：- 默认，- HW TO CB）[/b] [list] [][b]作用：* 让你将规则分类到自定义命名的文件夹中。[/] [][b]通俗解释：** 你可以按类型对规则进行分组（例如“农作物”、“动物产品”或“冶炼”）。点击分组名称旁边的减号 - 或加号 +，可以折叠或展开该类别，保持你的控制面板干净整洁。[/*] [/list]

[b]3. 自动化路线（文本行）[/b] [list] [][b]作用：* 精确显示物品的移动内容、起点和终点以及方式。[/] [][b]通俗解释：** 它从左到右读起来像一个句子： [list] []示例：牛奶(银星/金星) [auto1] -> cheese1 (产出: 奶酪) -> auto1[/] []这意味着：从名为 auto1 的箱子中取出*牛奶（特别指定仅限银星或金星品质），喂给名为 cheese1 的机器（将产出奶酪），然后将成品奶酪自动收获回名为 auto1 的箱子中。[/] [/list][/] [/list]

[b]4. 实时状态与故障排除[/b] [list] [][b]作用：* 精确告诉你自动化引擎在任何时刻正在做什么。[/] [][b]通俗解释：** 如果规则未生效，状态文本会以纯文本形式告诉你原因，你无需猜测： [list] []状态：需要 牛奶(银星/金星) 0/1 - 你的箱子里没有足够符合条件的牛奶。[/] []状态：等待中：机器忙碌 - 机器正在处理物品。[/] []状态：未找到机器 'charcoal1' - 你为名为“charcoal1”的机器设置了规则，但地图上不存在带有该标签的机器。[/] []状态：就绪（仅收集） - 该规则没有输入原料，仅在成品准备好时收集它们。[/] [/list][/*] [/list]

[b]5. 行级操作（右侧按钮）[/b] [list] [][b]启用/禁用复选框（绿色勾/灰色叉）：* 点击可临时暂停或恢复特定规则，无需删除。[/] [][b]CPY（复制/克隆按钮）：** 立即复制该规则。如果你想为不同的机器设置完全相同的路线而无需重新输入所有内容，此功能非常有用。[/] [][b]...（编辑按钮）：** 打开规则编辑器表单，你可以在其中修改原料、机器名称、箱子标签或切换出货选项。[/] [][b]X（删除按钮）：** 永久删除该自动化规则。[/*] [/list]

[line]

[b]6. 底部导航按钮[/b] [list] [][b]添加规则：* 打开一个干净的表单，你可以在此构建全新的自动化规则。你可以直接从你的物品栏下拉菜单中选择物品，无需手动输入物品名称。[/] [][b]清除所有：** 安全地清除你配置的所有规则，让你重新开始（内置安全确认弹窗，防止误点）。[/] [][b]储备：** 打开你的物品储备菜单。在此你可以为任何物品设置“安全数量”（例如“保留 50 个煤炭”），这样自动化系统就不会处理这些物品，确保你自用无忧。[/] [][b]关闭：** 关闭菜单并返回游戏。[/*] [/list]

规则页面： [img]https://staticdelivery.nexusmods.com/mods/1303/images/47840/47840-1782029112-596601447.gif[/img]

当你点击 添加规则 或编辑现有规则时，将进入此表单。它允许你使用简单的下拉菜单构建自定义的智能自动化线路——无需编程知识！ [line]

[b]1. 分组选择[/b] [list] [][b]作用：* 将你的规则放入主控制面板上的一个特定文件夹中。[/] [][b]通俗解释：** 从你的下拉菜单中选择一个现有分类（例如“HW TO CB”或“默认”），或者在此框中输入一个全新的名称以自动创建新分组。[/*] [/list]

[b]2. 输入语法（你的自动化代码）[/b] [list] [][b]作用：* 显示模组在后台读取的原始文本指令。[/] [][b]通俗解释：** 你无需在此输入任何内容！当你在下方的可视化构建器中选择物品时，此框会自动实时更新。（高级用户如果更喜欢，仍可直接点击并编辑此文本）。[/] []需要更多消耗品，可直接添加到输入语法中。[/*] [/list]

[b]3. 可视化物品构建器（物品与数量行）[/b] [list] [][b]物品选择下拉菜单（物品 1）：* 点击下拉箭头 v 打开一个可搜索过滤的你拥有物品的列表。你可以直接在列表顶部的搜索栏中输入内容，快速找到所需物品，无需滚动。[/] [][b]数量框：** 输入每个周期所需原料的确切数量（例如 5 个铜矿或 10 个木材）。[/] [][b]添加 (+) 和移除 (-) 按钮：** 想为需要多种不同原料的机器（如鱼熏炉或重型熔炉）进行配置吗？点击 + 按钮即可动态展开另一个带有自身物品选择器和数量框的行。[/*] [/list]

[b]4. 品质复选框（普通到铱星）[/b] [list] [][b]作用：* 限制你的规则仅处理特定品质的物品。[/] [][b]通俗解释：** 如果你只想处理普通牛奶来制作奶酪，但想保留珍贵的铱星品质牛奶用于烹饪或送礼，只需取消选中“铱星品质”框即可。模组会安全地跳过你的铱星牛奶，仅提取你勾选了品质的牛奶。[/*] [/list]

[b]5. 标签字段（输入箱子、机器和输出箱子）[/b] [list] [][b]输入箱子标签：* 包含你原料的箱子名称。如果留空，模组将安全地搜索你农场上的所有箱子。[/] [][b]机器标签：** 你分配给机器的唯一标签（例如“woodchip1”或“furnace_shed”）。[/] [][b]输出箱子标签：** 你想要成品（如煤炭或奶酪）放置到的特定箱子。[/*] [/list]

[b]6. 溢流控制（存储管理）[/b] [list] [][b]溢流箱子标签（可选）：* 当你的主输出箱子满了时，物品将流向的备用箱子。[/] [][b]溢流限制：** 设置一个上限数值（例如 200）。一旦你的主输出箱子里有了200个已生产物品，所有后续物品将自动路由到你的备用溢流箱子，以防止堆积。[/*] [/list]

[b]7. 直接出货与溢流出货选项[/b] [list] [][b]直接出货到出货箱：* 勾选此框可完全绕过箱子，将所有成品直接发送到刘易斯镇长的出货箱，以便过夜盈利。[/] [][b]出货超额物品（溢流）：** 当设置了溢流限制时出现。勾选此项会将超出限制的任何物品直接发送到出货箱，同时保持你的主箱子库存达到你的上限。[/*] [/list]

[b]8. 保存与取消按钮[/b] [list] [][b]保存：* 验证你的输入。如果一切正确（机器和箱子存在于你的地图上），它会保存你的规则并关闭。如果出现问题，它会在底部打印红色警告，解释缺少什么。[/] [][b]取消：** 关闭表单并放弃所有未保存的更改。[/*] [/list]

储备菜单： [img]https://staticdelivery.nexusmods.com/mods/1303/images/47840/47840-1782029359-50648351.png[/img]

是否担心自动化系统会消耗你所有的煤炭、木材或矿石，让你在手工制作或建筑时一无所有？这个菜单就是你的安全网。 设置一个 储备数量 可以告诉模组：“自动处理这些物品，但始终在我的箱子里至少保留这么多供个人使用。” [line]

[b]1. 搜索物品[/b] [list] [][b]作用：* 快速过滤物品网格。[/] [][b]通俗解释：** 如果你想找到“煤炭”，只需在此输入“煤炭”，下方的大型物品网格就会立即过滤，只显示煤炭，省去你翻阅大量物品页面的麻烦。[/*] [/list]

[b]2. 物品网格（第 1/6 页）[/b] [list] [][b]作用：* 显示当前存在于你的玩家物品栏或农场中任何箱子里的所有独特物品。[/] [][b]通俗解释：** 这是你的活跃目录。你可以使用底部的左 (<) 和右 (>) 箭头按钮翻页。点击任何物品图标可将其选中进行配置。[/*] [/list]

[b]3. 已选物品预览卡片[/b] [list] [][b]作用：* 显示你刚刚在网格中点击的物品的大图预览。[/] [][b]通俗解释：** 确认你选择了哪个物品（例如上图中的“木材”），以免错误地为其他物品设置限制。[/*] [/list]

[b]4. 储备数量与设置按钮[/b] [list] [][b]储备数量框：* 输入你想要锁定的确切数量（例如“200”或“50”）。 设置按钮：单击此按钮保存限制。[/] [][list] []示例：如果你将木材设置为 100，则仅当你拥有超过 100 个木材时，模组才会允许机器从你的箱子中消耗木材。当你的木材总数降到 100 时，自动化系统就会停止触碰它。[/] [/list][/*] [/list]

[b]5. 活跃储备列表[/b] [list] [][b]作用：* 显示你所有激活的物品保护列表。[/] [][b]通俗解释：** 显示你当前的规则（例如上图中的 铜矿：30 和 木材：250）。[/] [][b]管理/删除：** 你可以使用页面箭头浏览你的激活保护。如果你想移除保护，让模组再次处理该资源，只需点击该物品旁边的红色小按钮 X 即可删除储备。[/*] [/list]

[b]6. 关闭按钮[/b] [list] [][b]作用：* 保存你的所有储备并返回主控制面板菜单。[/*] [/list]

[b]规则编辑器输入文本语法指南[/b]

模组使用灵活的文本解析器来确定需要哪些原料、需要多少数量以及允许哪些作物品质。

1. [u]“仅收集”规则（无输入）[/u]

当你希望机器被动自主运行时使用此规则。模组只在机器准备好时收获，永远不会尝试向机器内放入物品。

• 关键词：Empty、None 或 Blank（不区分大小写）
• 含义：模组检查机器，收集其产出，并重新启动它（如果它支持标准的被动循环，如虫桶或蘑菇树桩）。
• 示例：Empty

2. [u]标准单一物品规则[/u]

标准加工中最常用的语法。

• 语法：[物品名称]-[数量]
• 含义：机器需要指定数量的该物品。它接受任何品质（无星、银星、金星或铱星）。
• 示例：
  • 蛋-1（装载 1 个任何品质的蛋）
  • 铜矿-5（装载 5 个任何品质的铜矿）

3. [u]带品质过滤的单一物品[/u]

使用此规则来限制允许送入机器的星级品质。

• 语法：[物品名称]-[品质]-[数量]
• 品质关键词：
  • normal、regular 或 0（普通，无星）
  • silver 或 1（银星）
  • gold 或 2（金星）
  • iridium 或 4（铱星，紫色）
• 使用多个允许的品质：你可以列出多个品质，并用反斜杠 \ 或正斜杠 / 分隔。
• 示例：
  • 甜瓜-normal-1（仅装入无星的普通甜瓜）
  • 奶酪-normal\silver\gold-1（允许普通、银星或金星奶酪，但保护优质的铱星奶酪不被放入机器）
  • 南瓜-0/1-1（仅装入普通 [0] 或银星 [1] 品质的南瓜）

4. [u]多物品规则（复杂配方）[/u]

用于需要多种原料才能开始处理的机器。

• 语法：[第一物品]-[数量];[第二物品]-[数量]
• 规则：
  • 使用分号 ; 分隔每种原料。
  • 你可以在同一行中混合使用标准物品和品质过滤器。
• 示例：
  • 铜矿-5;煤炭-1（需要 5 个铜矿和 1 个煤炭）
  • 大壶牛奶-normal\silver-1;糖-5（需要 1 个普通或银星品质的大壶牛奶和 5 个糖）

5. [u]名称中带连字符的物品[/u]

解析器被设计得很智能。如果物品名称自然包含连字符，只要你使用的品质过滤器关键词如上所述是正确的，代码会自动检测到该连字符是名称的一部分，而不是分隔符。

• 示例：
  • 史前头骨-5（解析器成功将名称读作“史前头骨”，数量读作 5）
  • 怪异玩偶-normal-1（解析器成功将名称读作“怪异玩偶”，允许品质为普通，数量为 1）

摘要速查表

输入文本	机器要求	允许品质
Empty	无（仅收集）	无
小麦-1	1 个小麦	普通、银星、金星、铱星
杨桃-normal-1	1 个杨桃	仅普通品质
鲑鱼-gold\iridium-1	1 条鲑鱼	仅金星或铱星品质
铁矿-5;煤炭-1	5 个铁矿 和 1 个煤炭	两者任意品质

[b]高级功能：分组与储备[/b]

随着你的农场扩张，你自然会添加更多的机器和箱子网络。为了防止列表变得杂乱，并保护你重要的手工材料，本模组包含两个内置的组织工具：分组和储备。

1. [u]规则分组[/u]

分组允许你直接在仓库列表视图中将自动化规则整理到文件夹中。

工作原理：

• 创建：在规则编辑器中，你可以在“分组”字段中输入任何名称（或从下拉列表中选择一个现有的名称）。如果留空，则默认为“Default”。
• 折叠与展开：在你的主仓库列表（U）中，规则会按其分组名称进行排序。你可以点击任何分组标题来折叠或展开它。
  • 分组名称旁边的 + 符号表示已折叠。
  • - 符号表示已展开。
• 组织：这使得清理你的用户界面变得非常容易。例如，当你正在积极编辑或审查“冶炼”组规则时，你可以折叠整个“酿造”组规则。

示例分组：

• 冶炼（熔炉、木炭窑）
• 工匠（小桶、腌制罐、压酪机、蛋黄酱机）
• 钓鱼（蟹笼、虫桶）
• 种子制造（种子生产器）

2. [u]物品储备[/u]

储备系统充当安全锁。它允许你告诉自动化网络：“除非我有超过这个特定数量的物品，否则永远不要让我的机器触碰这些物品。”

为什么需要它：

如果你将熔炉自动化以将铜矿和煤炭变成铜锭，你的系统会自动消耗你所有的煤炭。这意味着你将没有剩余的煤炭来制作火把、种子生产器或腌制罐。通过设置储备限制，你可以保护你的个人手工库存。

工作原理：

1. 打开你的仓库菜单（U）并点击“储备”按钮。
2. 从你连接的库存网格中选择任何物品（例如煤炭）。
3. 在“储备数量”框中，输入你的限制（例如 50）。
4. 点击“设置”。

后台发生的情况：

模组使用以下公式计算你的可用物品： 可用物品 = 箱子中总物品数 - 储备限制

如果你的煤炭总数量降至 50 或以下，你的熔炉将立即暂停冶炼并等待，在你的规则列表中显示状态：需要 煤炭 (保留 50)。只有当你向箱子中放入超过 50 个煤炭时，熔炉才会再次开始冶炼。

有用的储备建议：

• 煤炭：设置为 50（保护煤炭用于标准制作）。
• 木材 / 硬木：设置为 100（保护木材用于建筑升级和制作栅栏/小桶）。
• 金矿 / 铱矿：设置为 20（保护矿石用于制作超级炸弹或升级工具）。
• 鱼饵：设置为 100（确保你总是有剩余的鱼饵用于你的个人钓鱼竿）。