轻松制作

轻松合成（Effortless Crafting）

---

轻松合成是一个强大的纯客户端合成优化生活质量模组，让合成变得比以往更快、更轻松！除了众多改进之外，它还允许你：

• 直接使用周围可触及箱子中的资源进行合成
• 通过滚轮快速排队/拉取或自动合成特定数量的配方
• 仅使用基础材料请求物品，它将自动逐步合成直至最终结果
• 批量合成繁琐的配方，例如发射器，或从农场箱子中合成数千个金粒为金块

为了尽可能遵循服务器规则，它还会缓存物品以减少开启箱子的操作，并且可以在设置中完全禁用附近箱子的使用。请注意，自动开启箱子可能会在带有反作弊的公共服务器上被标记，并可能导致封禁，因此请在使用附近合成功能时谨慎行事，并了解服务器规则。

---

预告片 / 快速教程

---

视频中未涵盖的一些有用功能

• 链式合成：一种自动合成形式，启用后会自动合成中间的每一步以达到最终所需物品。例如：原木-->木板-->箱子-->漏斗全部自动完成。
• 检索模式：用于从附近箱子中查找并快速拉入已有物品，通过双击 Ctrl 或按住 Ctrl 并点击合成结果槽位来激活。
• 在循环显示的配方上右键点击可打开原版变体选择器，如果你想要一个精确的变体而不是让模组从整个配方系列中解析，这一点很重要。
• 按住空格键在排队或滚轮拉取时充当x16倍率。
• 当请求正在排队时，右键点击或Esc可在松开前取消任何已排队的输入。
• Esc将立即中止由模组发起的任何合成会话。
• 轻按Alt可自动合成当前在合成网格中的物品。
• 按住Alt并点击一个配方可立即合成1个该物品。

---

快速开始

模组的大部分功能来自于配方请求：

1. 将鼠标悬停在一个配方上。
2. 按住一个修饰键。
3. 滚动选择你想要的数量。
4. 松开修饰键以发送请求。

三个主要的修饰键是：

• Shift：排队一个仅使用背包的常规合成
• Ctrl：允许使用附近的容器
• Alt：将合成排队为自动合成请求

如果你更喜欢点击操作，相同的修饰键也会改变配方点击的行为。

---

原有的原版行为

• 本模组不会修改现有的原版配方交互和快捷键。
• 正常的配方点击行为仍与原版相同。
• 原版的Shift + 点击仍然是熟悉的批量合成操作，除非你将其与模组的其他修饰键组合使用。
• 在循环显示的配方上原版右键点击会打开变体选择器。
• 如果你想要一个精确的变体而不是让模组从整个配方系列中解析，该变体选择器很重要。

---

修饰键控制

这些修饰键的组合可以自然叠加。

修饰键	主要含义	点击时	滚动时
Shift	仅背包配方请求	将请求提升为最大合成（一次能放入合成网格的最大数量）	改变排队数量，并在松开所有按住的修饰键时发送请求。
Ctrl	允许使用附近容器	在可访问附近容器的情况下增加1个请求数量	改变排队数量，并在松开所有按住的修饰键时发送可访问附近箱子/木桶等的请求。
Alt	自动合成此请求	如果启用则立即合成1个，否则增加1个请求数量	改变排队数量，并在松开所有按住的修饰键时发送应用了自动合成的请求。

空格键在排队或滚轮拉取时充当x16倍率。 右键点击或Esc可在排队请求时于松开前取消任何已排队的输入。 Esc将立即中止由模组发起的任何合成会话。

---

常用组合

• Ctrl + Shift + 点击：附近最大合成
• 启用批量时Ctrl + Shift + 点击：重复进行附近最大合成，直到资源耗尽或会话停止
• Alt + Shift + 点击：启用自动合成的仅背包最大合成
• Ctrl + Alt + Shift + 点击：启用自动合成的附近最大合成
• Ctrl + Alt + 滚动：附近自动合成请求
• Shift + Alt + 滚动：背包自动合成请求（与仅 Alt + 滚动相同）

---

值得了解

• 打开自动合成会合成当前在合成网格中的任何物品。这使得可以先请求一个配方，然后无需重建请求即可自动合成它。
• 手动放入的配方不会被自动合成，除非在网格中已有物品时打开自动合成。
• 当启用了Alt 点击立即合成时，Alt + 点击可以立即合成1个物品。
• 批量模式移除了正常的排队上限，并支持重复自动合成和重复最大合成。
• 将Shift + 滚动悬停在结果槽位上也可以用作快速滚动拉取合成结果的快捷方式。

---

生活质量改进

智能物品转移

• 快捷栏从左到右：自动放置的合成物品会从左到右填充快捷栏，而不是原版通常的从右到左，以便更容易访问新物品。
• 副手堆叠：合成物品可以直接堆叠到副手槽中，并且适用于2x2和3x3合成网格。

配方手册和界面增强

• 输入搜索：输入可以直接跳转到配方手册的搜索栏，同时忽略不应成为文本输入的按键。
• 搜索历史：使用上下箭头键循环浏览之前的配方手册搜索。
• 3x3自动聚焦：打开合成台时搜索栏会自动聚焦。
• 产量和排队指示器：界面可以直接在配方上显示输出总数和排队数量。
• 聊天反馈：缺少物品的报告和批量合成摘要会显示在聊天中。
• 配方过滤器开关：默认按键空格键在未用于请求缩放时快速切换可合成/不可合成配方过滤器。
• 快速合成快捷键：默认按键B在可能时打开附近的3x3合成台，否则回退到2x2背包网格并聚焦搜索。

---

自动合成

• 按住与切换模式：默认情况下，自动合成使用按住模式。按住Alt表示当前请求使用自动合成行为。如果更倾向于切换模式，也可以在设置中进行配置。当自动合成激活时，结果槽中的箭头会指示。
• 从网格快速自动合成：如果配方已经准备好，轻按Alt即可合成它，无需重建请求。
• 立即合成选项：当启用了Alt 点击立即合成时，Alt + 点击可以立即合成1个悬停的配方。如果禁用，则表现为正常的 Alt 请求点击。
• 智能放置：自动合成的物品会被智能放置，包括从左到右填充快捷栏，而不是原版通常的从右到左行为。
• 副手堆叠：自动合成可以将兼容的输出堆叠到副手槽中，并且适用于2x2和3x3合成网格。
• 手动配方保护：手动放入网格的配方永远不会被自动合成，除非在配方已准备好时打开自动合成。

---

链式合成

链式合成通过在最终配方缺少中间物品时向后追踪可合成的依赖项来扩展自动合成。

• 依赖项合成：如果你请求自动合成类似比较器的物品，但只有原木、红石、石头和石英，模组可以合成木板、木棍、红石火把，然后合成比较器。
• 先询问或始终执行：链式合成可以禁用、询问确认，或从模组设置中自动运行。
• 感知附近的请求：按住Ctrl允许链式规划器使用缓存的附近容器以及你的背包。
• 部分回退：如果无法合成完整请求的数量，但至少可以合成一个最终输出，模组可以提议改为合成可能的数量。
• 保守执行：中间结果会放入你的背包，每一步仍使用正常的自动合成放置和验证路径。
• 当前限制：尚不支持批量链式合成。需要链式合成的批量请求会报告而不是启动批量链式会话。

---

批量合成

• 启用批量模式：按住Alt并点击合成结果箭头。批量模式在箭头周围以橙色轮廓显示。即使松开 Alt 后，它会一直保持开启，直到合成完成或中止，或再次切换关闭。
• 批量的变化：批量取消了正常的排队限制，使得大量合成可堆叠和不可堆叠的物品变得实用，例如发射器或蛋糕（如果你愿意）。
• 批量最大合成：启用批量时Ctrl + Shift + 点击会重复执行附近最大合成，直到资源耗尽或会话中止。
• 动态投入和排出：批量合成会一次尽可能多地投入物品，并在需要时排出输出，以保持大型会话继续进行。
• 变体延续：批量可以继续合成相同的变体，或根据你的设置切换到同一系列中的另一个可用变体。
• 安全关闭：批量会话在完成时、手动按ESC中止时或游戏窗口失去焦点时自动关闭。

---

检索模式

检索模式是附近合成专属的一种状态，允许你直接从附近箱子中拉取已有物品，而不是合成它们。

• 启用检索模式：按住Ctrl并点击结果槽，或双击Ctrl（确保未开启自动合成或批量合成）。
• 检索模式的变化：在结果槽中以'X'表示，此模式告诉配方手册从附近容器中检索物品到你的背包，而不是合成它们。在此模式激活时，手动合成仍然可以。
• 扩展可见性：显示你在游戏中至少见过一次的所有物品的图标，包括那些没有合成配方的物品。
• 可用性指示器：物品图标上的绿点表示该物品当前至少有1个可从附近容器中检索到。

---

滚动拉取

滚动拉取是一种专门的快速输出工作流，与空格键x16倍率配合良好。

• 在结果槽上Shift + 向下滚动会将合成结果拉入你的背包，如果背包空间不足则会将其弹出。
• 在背包槽位上Shift + 向下滚动会尝试将合成结果直接拉入该槽位。
• Shift + 向上滚动会将合成结果附加到你的光标堆叠上。

---

核心机制

智能资源管理

• 变体解析：模组可以根据你的请求、选定的变体、你的设置以及当前可用的资源来解析循环配方变体。
• 智能箱子交互：附近拉取偏好近乎空的槽位，以帮助保持存储整洁和整合。
• 物品归还和背包恢复：模组会记住你的背包和箱子布局，并尝试在合成后将物品返回到原来的位置。
• 高性能缓存：附近容器内容可以被缓存，以加速重复合成并改进可合成性反馈。

附近合成

• 附近容器使用：Ctrl允许配方请求除了你的背包外还使用周围可触及的存储。
• 精确变体请求：在循环配方上右键点击可打开原版变体选择器，当你想要一个精确的配方而不是基于系列解析时。
• 大型附近请求：附近请求可以与自动合成和批量结合，用于大型多阶段合成会话。

---

生活质量改进

智能物品转移

• 快捷栏从左到右：自动放置的合成物品会从左到右填充快捷栏，而不是原版通常的从右到左行为。
• 副手堆叠：合成物品可以堆叠到副手槽中，并且适用于2x2和3x3合成网格。

配方手册和界面增强

• 输入搜索：输入可以直接跳转到配方手册的搜索栏，同时忽略不应成为文本输入的按键。
• 搜索历史：使用上下箭头键循环浏览之前的配方手册搜索。
• 智能配方排序：配方手册可以优先显示最近合成的、可直接合成的、可链式合成的和可附近合成的配方，同时保留原版排序在设置中可用。
• 3x3自动聚焦：打开合成台时搜索栏会自动聚焦。
• 产量和排队指示器：界面可以直接在配方上显示输出总数和排队数量。
• 聊天反馈：缺少物品的报告和批量合成摘要会显示在聊天中。
• 配方过滤器开关：空格键在未用于请求缩放时仍支持可合成/不可合成配方过滤器切换。
• 配方手册导航：滚动或使用箭头键可以轻松翻页浏览配方手册。
• 循环配方菜单和提示：具有多个变体的展开配方现在可以清晰地显示每个变体的准确提示信息。

额外控制

• 快速合成快捷键：默认按键B在可能时打开附近的3x3合成台，否则回退到2x2背包网格并聚焦搜索。

---

自定义和过滤

高度可自定义

轻松合成旨在适应不同的游玩风格。大多数行为都可以通过 Mod Menu 和 Cloth Config 在模组设置中进行调整，包括自动合成处理、变体行为、排队行为以及模组是否完全启用。

容器过滤系统

• 全局容器黑名单：阻止整个容器类型（如漏斗或末影箱）被使用，除非在世界中使用白名单明确允许。
• 世界内黑名单 / 白名单：启用世界内过滤后，在容器界面内按住Ctrl可检查并更改该容器的黑名单、中立或白名单状态，通过容器界面顶部附近的可点击圆点进行操作。
• 可视化线框：可选线框在世界中显示已过滤的容器状态。

---

致谢和许可

本项目基于 LGPL-3.0-or-later 许可。

它借鉴了以下项目的灵感和某些实现模式：

• stack-to-nearby-chests by xiaocihua (LGPL-3.0)

问题

如果你有任何问题，欢迎在 https://www.reddit.com/user/ekra8154/ 给我留言。