RS Integration - RS Integration（RS 整合）

RS Integration 让 Refined Storage 能够操作其他模组的机器。在 JEI 中选择物品后，它会检查材料、解析前置配方、操作已绑定的机器，并将产物送回 RS 网络。

要求

主要功能

递归远程合成

即使没有 RS 无线终端，也能直接使用玩家背包中的材料递归合成普通配方。

• 在 JEI 中点击 RSI 操作即可预览并开始合成。
• 解析工作台、模组机器、虚拟交换和多方块结构的前置需求。
• 执行前显示完整步骤列表、缺失材料、替代配方，以及可缩放的依赖图。
• 并行运行相互独立的图节点，并在兼容机器之间均衡分配重复工作。
• 跟踪材料来源，并执行事务式预留、回滚、退款和产物交付。
• 每个实体机器输入槽始终使用同一种具体物品变体；不同合成网格槽则可以混用标签兼容的材料，例如不同种类的木板。
• 按 P 查看进度；可从进度界面、聊天操作或 /rsi cancel 取消。

机器绑定与远程访问

• 手持 Network Linker 对受支持的方块按住 Shift 并右键，即可绑定或解除绑定。
• 绑定会保留维度和坐标信息；方块被破坏后会清除失效条目。
• 可从 RS 界面远程打开兼容机器的 GUI；关闭后返回终端。
• 使用可搜索的 Machine Management Center 查看状态、收取产物、访问 GUI，以及通过数字键选择。
• 机器标签页可将手持物品放入输入槽；Shift 操作也可以补充燃料。
• 多台兼容机器会均衡分配工作，并可在机器协议允许时分摊重复任务。
• 远程操作遵循 FTB Chunks 和 Cadmus 的领地保护规则，且不会强制加载未加载的目标区块。

JEI 与 RS 界面工具

• 在 JEI 中拖动选择多个材料，可批量收藏或隐藏。
• Alt-单击材料可按模组筛选 JEI；Alt-中键单击可清除搜索。
• Ctrl+T 将当前显示的 JEI 配方传输到 RS 合成网格。
• 按住 Ctrl 并在 RS 槽位上左键拖动，可从经过的每个槽位提取一个物品。
• 可拖动的侧面板能在其他界面中显示 RS 内容和机器标签页，并支持拼音搜索。

自动进食

打开 RS 合成网格，即可直接消耗网络中的食物：

• 饮食多样性适用于 SolCarrot，会选择尚未记录的食物。
• 堆叠盛宴会持续食用选定的食物，直到饱食或达到单次使用上限。
• 均衡饮食适用于 Diet，会优先选择营养组数值较低的食物。
• 食物和状态效果黑名单可避免食用不想要的食物。
• 碗、瓶子和其他剩余物品会在可能时送回 RS 网络。
• 服务器可配置启用条件、执行消耗和单次使用上限。

补货与物品管理

• 村民补货：选择一项交易并按 Space，从背包和 RS 中补齐交易所需物品；缺失物品会在 JEI 中收藏。
• 重铸补货：在 Apotheosis 或 Ancient Reforging 界面按 Space，从 RS 中取出重铸材料；缺失物品会在 JEI 中收藏。
• 远程侧面板：按 Y，即可在其他界面中浏览和搜索 RS 内容，并打开 JEI 用途或配方。

Apotheosis 刷怪笼升级

• 手持有效的 RS 网络物品，对 Apotheosis 刷怪笼按住 Shift 并右键，即可打开升级界面。
• 界面会列出可用的正面升级、当前完成情况、所需材料及 RS 库存。
• 可选择多个升级，并在确认前预览完整依赖计划。
• 可用材料会从已连接的 RS 网络中提取；若存在有效配方图，缺少的升级材料会通过递归合成获得。
• 每次扫描和执行都会在服务器端验证玩家、网络、维度、距离、刷怪笼状态及预览中的选择。

一键容器传输

• 在箱子、机器输入界面或其他容器中按 F，即可将其中物品传输到当前目标。
• 按 G 可在已绑定的 RS 网络和 Sophisticated Backpack 之间切换目标。
• 传输遵循过滤器、物品黑名单和目标容量限制；被拒绝的物品会留在源容器中。
• 在聊天、搜索框和其他文本字段中输入时，传输按键会被禁用。

RS 侧面板与 Machine Management Center

• 按 Y 可显示或隐藏侧面板，无需离开当前界面。
• 浏览 RS 物品数量和已绑定机器。
• 支持按名称、拼音、数字或物品 ID 搜索，在大型整合包中也能保持实用。
• 将鼠标悬停在物品上并按 U 查看用途，或按 R 查看配方，直接打开 JEI。
• 可从机器标签页远程打开机器界面；失效或被破坏的绑定会自动清除。
• 按 H 可打开机器状态、产物收取、GUI 访问和数字键选择界面，并支持搜索。
• 网络中有 Resonance Disk 时，可从 Machine Management Center 打开其 Resonance Backpack。

鼠标与快捷键操作

• 按住 Ctrl 并在 RS 网格槽位上拖动，可从经过的每个槽位提取一个物品。
• 在侧面板物品上拖动可将物品平均分配给已绑定的机器；左键提取一组，右键提取一个。
• JEI 支持框选批量收藏或隐藏，以及按模组快速筛选。
• 计划节点支持右键折叠或展开、右键拖动平移、Ctrl + 滚轮缩放，以及滚轮调整重复次数。

Resonance Disk

Resonance Disk 是一种 RS 存储磁盘，其中的内容可以视同由玩家随身携带。

• 提供兼容的属性、物品栏刻效果、事件触发被动效果，以及物品或资源查询。
• 对已配置的物品持久化保存变更，而不是对临时副本执行刻更新。
• 默认支持 Apotheosis 药水护符、Muyimeng 融合药水护符、Reliquary 的 Pyromancer Staff、Enigmatic Addons 的 Artificial Flower，以及 Forbidden & Arcanus 的 Spectral Eye Amulet 的被动效果。
• 支持 Chapter of Yuusha/Moonstone Nine Sword Books、Wizard Terra Curios 的 BuffItem 物品，以及 Terra Equipment 堆叠的无限药水。
• 递归合成时支持粉雪桶、源流体和毒液等兼容的存储资源。
• 磁盘可通过 RS 提供时，支持通过井的交互获取 Malum Void Favor。
• 每个 RS 网络只启用一个 Resonance Disk，避免被动效果和资源查询重复触发。

Sophisticated Backpack 升级

• 提供四种专用于 RS 的 Sophisticated Backpack 升级：
• Dimensional Magnet：将附近符合过滤条件的物品直接送入 RS。
• Dimensional Pickup：遵循背包拾取规则，通过 RS 转送拾取的掉落物。
• Dimensional Feeding：从 RS 中消耗符合过滤条件的食物来喂饱玩家。
• Dimensional Restock：在背包需要物品时从 RS 中补充。
• Dimensional Magnet 不会将已接收的掉落物存入背包；其范围和过滤槽数量均可配置。
• Dimensional Pickup 会将符合条件的掉落物直接存入 RS，同时保留 Sophisticated Backpack 的过滤规则。
• Dimensional Feeding 和 Dimensional Restock 会优先使用 RS 资源，并通过过滤器限制可用物品。
• 对 RS 控制器按住 Shift 并右键可绑定这些升级；升级界面可控制启用状态并筛选物品。
• Compact­ing 增强：安装 Majrusz's Accessories 后，Compacting 会按品质等级逐步合并符合条件的配饰，直到达到 100% 或无法继续合并。
• 兼容的 Magnet、Pickup、Feeding、Refill 和 Restock 升级可改为从 RS 网络获取物品。
• Deposit 升级可以将物品直接送入 RS。
• Compacting 可以自动合并符合条件的 Majrusz's Accessories 物品。

FTB Quests 物品追踪

• 追踪由合成、容器传输、磁铁或拾取流程及其他外部移动造成的真实 RS 存入。
• 模拟存入、虚空处理、退款和恢复不会增加任务进度。
• 使用 FTB Quests 的物品过滤器和 NBT 匹配规则。
• 提交任务时可直接从 RS 中消耗缺失物品；缺少的需求物品会在 JEI 中收藏。
• 分别统计合成物品和外部获取物品，避免重复计入进度。
• 需要 FTB Quests 和 FTB Teams；若安装了其他兼容的自动检测器，RSI 会让其优先处理。

快速开始

• 建立并启动 Refined Storage 网络。
• 获取 RSI Network Linker。
• 对受支持的机器按住 Shift 并右键进行绑定。
• 在 JEI 中打开配方并使用 RSI 合成操作。
• 查看生成的计划，选择替代方案或重复次数，然后开始合成链。
• 按 P 查看进度；完成的产物会送回 RS；若没有网络，则送给玩家。

配置

配置文件内附有注释和验证范围说明：

• config/rs_integration/common.toml：功能开关、可选集成、被动效果、自动进食、侧面板和机器 GUI 允许列表。
• saves//serverconfig/rs_integration/server.toml：配方选择、超时、递归深度和步骤限制、DAG 并发、保护储备及机器专属策略。
• config/rs_integration/client.toml：侧面板位置、大小、显示状态和 HUD 偏好设置。

重要的服务器端选项包括配方优先级和黑名单、重复次数限制、解析预算、并发图节点和操作、按模组设置的并行策略，以及全局合成链超时。新增默认项时，不会覆盖现有配置文件；请手动合并新增列表项，或重新生成配置文件。

诊断

• /rsi cancel：取消玩家当前的合成链。
• /rsi_debug：权限等级为 2 的管理员可查看合成链、账本、配方索引、处理器、绑定、跟踪、审计、Embers 缓存与锁，以及性能诊断信息。
• 排查问题时，可启用 diagnosticVerboseLogging 以记录详细的解析器和分发器日志。

发布版 JAR 会写入 build/libs/，并由构建任务 verifyReleaseJar 进行验证。

许可证

保留所有权利。