共振存储

RS Integration 使精致存储能够操作其他模组的机器。在 JEI 中选择一个物品，它会检查材料、解析前置配方、操作已绑定的机器，并将结果返回至 RS 网络。

当前版本：1.2.9 | Minecraft 1.20.1

需求

依赖项	要求
Minecraft	1.20.1
Forge	47+
精致存储	1.12+；必需
JEI	客户端必需，用于配方操作和计划预览
其他集成	可选；模块仅在其目标模组存在时加载

主要特性

递归远程合成

即使没有 RS 无线终端，也可以从玩家物品栏递归合成普通配方。

• 点击 JEI 中的 RSI 操作以预览并开始合成。
• 解析合成台、模组机器、虚拟交换和多块结构前置。
• 执行前显示完整步骤列表、缺失材料、替代配方和可缩放的依赖关系图。
• 并发运行独立的图节点，并在兼容机器间负载均衡重复工作。
• 追踪材料来源，并执行事务性预留、回滚、退款和输出交付。
• 保持一个物理机器输入槽对应一个具体物品变体，而单独的合成网格槽可以混合使用标签兼容的材料，例如不同种类的木板。
• 按 P 键检查进度；可从进度界面、聊天操作或 /rsi cancel 取消。

机器绑定与远程访问

• 使用网络连接器对支持的方块进行 Shift+右键点击以绑定或解除绑定。
• 绑定保留维度和位置信息，并在方块被破坏时移除失效条目。
• 从 RS 界面远程打开兼容机器的 GUI，并在关闭后返回终端。
• 使用可搜索的机器管理中心查看状态、收集输出、访问 GUI 和数字键选择。
• 机器选项卡可以将手持物品放入输入槽；Shift 操作也可以补充燃料。
• 多个兼容机器会进行负载均衡，并可在机器合约允许的情况下分配重复工作。
• 远程操作尊重 FTB Chunks 和 Cadmus 的领地声明，不会强制加载未加载的目标区块。

JEI 和 RS 界面工具

• 拖选 JEI 物品以进行批量书签/隐藏操作。
• Alt+点击物品可按模组过滤 JEI；Alt+中键点击清除搜索。
• Ctrl+T 将可见的 JEI 配方传输到 RS 合成网格。
• 在 RS 槽位上 Ctrl + 左键拖动可从每个访问过的槽位提取一个物品。
• 可拖动的侧边栏可从其他界面显示 RS 内容和机器选项卡，并支持拼音搜索。

自动进食

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

• 膳食多样性 与 SolCarrot 配合，选择尚未记录的食物。
• 堆叠盛宴 食用一种选定的食物直到饱食或达到每次使用限制。
• 均衡饮食 与 Diet 配合，为营养值较低的组别选择食物。
• 食物和状态效果黑名单可防止意外食用。
• 碗、瓶子和其他残留物在可能的情况下返回 RS 网络。
• 服务器可以配置激活要求、执行成本和每次使用限制。

补充与物品管理

• 村民补货：选择一项交易并按空格键以从物品栏和 RS 中填充其成本；缺失物品会在 JEI 中标记书签。
• 重铸补货：在 Apotheosis 或 Ancient Reforging 界面中按空格键以从 RS 中提取重铸材料；缺失物品会在 JEI 中标记书签。
• 远程侧边栏：按 Y 键可从其他界面浏览和搜索 RS 内容，并打开 JEI 用途或配方。

Apotheosis 刷怪笼升级

• 手持有效的 RS 网络物品并对 Apotheosis 刷怪笼进行 Shift+右键点击以打开升级界面。
• 界面列出适用的正面升级、当前完成度、所需材料和可用的 RS 库存。
• 在确认前可选择多个升级并预览完整的依赖计划。
• 可用材料从绑定的 RS 网络中提取；当存在有效的配方图时，缺失的升级材料会递归合成。
• 每次扫描和执行都会在服务器端针对玩家、网络、维度、距离、刷怪笼状态和预览选择进行验证。

一键容器转移

• 在箱子、机器输入或其他容器中按 F 键将其内容转移到当前目标。
• 按 G 键在绑定的 RS 网络和 Sophisticated Backpack 之间切换目标。
• 转移尊重过滤器、物品黑名单和目标容量；被拒绝的物品保留在源容器中。
• 在聊天、搜索框和其他文本字段中输入时，转移键会被抑制。

RS 侧边栏和机器管理中心

• 按 Y 键显示或隐藏侧边栏，无需离开当前界面。
• 浏览 RS 物品数量和已绑定的机器。
• 按名称、拼音、数字或物品 ID 搜索，在大型整合包中同样实用。
• 悬停物品并按 U 键查看用途或 R 键查看配方，直接打开 JEI。
• 从机器选项卡远程打开机器界面；失效或已销毁的绑定会自动移除。
• 按 H 键打开可搜索的机器状态、输出收集、GUI 访问和数字键选择。
• 当网络包含共振磁盘时，可以从机器管理中心打开其共振背包。

鼠标与快捷键操作

• 按住 Ctrl 并在 RS 网格槽位上拖动，可从每个访问过的槽位提取一个物品。
• 在侧边栏物品上拖动以将它们均匀分配到绑定的机器；左键点击提取一组，右键点击提取一个。
• JEI 支持框选书签/隐藏操作和按模组快速过滤。
• 计划节点支持右键折叠/展开、右键拖动平移、Ctrl + 滚轮缩放，以及滚轮重复次数调整。

共振磁盘

共振磁盘是一种 RS 存储磁盘，其内容可被视为由玩家携带。

• 提供兼容的属性、物品栏 tick 效果、事件驱动的被动效果以及物品/资源查询。
• 为配置的物品持久化变异，而不是 tick 一次性副本。
• 包含对 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 的堆叠无限药水。
• 在递归合成期间支持兼容的存储资源，例如细雪桶、源质流体和毒液。
• 支持通过井交互获得 Malum Void Favor，前提是磁盘可通过 RS 使用。
• 每个 RS 网络仅激活一个共振磁盘，防止被动效果和资源查询重复。

Sophisticated Backpack 升级

• 提供四个特定于 RS 的 Sophisticated Backpack 升级：
• 维度磁铁 将附近通过其过滤器的物品直接发送到 RS。
• 维度拾取 将拾取的掉落物通过 RS 路由，同时保留背包拾取规则。
• 维度喂食 从 RS 消耗过滤后的食物来喂养玩家。
• 维度补货 在背包需要时从 RS 提供物品。
• 维度磁铁将接受的掉落物排除在背包存储之外；其范围和过滤器槽位数可配置。
• 维度拾取将接受的掉落物直接存储在 RS 中，同时保留 Sophisticated Backpack 过滤器。
• 维度喂食和补货优先使用 RS 资源，并使用其过滤器限制符合条件的物品。
• 对 RS 控制器进行 Shift+右键点击以绑定这些升级；其界面控制启用状态和过滤物品。
• 压缩增强：安装 Majrusz's Accessories 后，压缩会通过连续的质量等级合并符合条件的饰品，直到 100% 或无法进一步合并。
• 兼容的 Magnet、Pickup、Feeding、Refill 和 Restock 升级可以重定向到 RS 网络。
• Deposit 升级可以直接将物品发送到 RS。
• 压缩可以自动合并符合条件的 Majrusz's Accessories 物品。

FTB Quests 物品追踪

• 追踪由合成、容器转移、磁铁/拾取流程以及其他外部移动引起的实际 RS 插入。
• 模拟插入、销毁、退款和恢复不会推进任务进度。
• 使用 FTB Quests 物品过滤器和 NBT 匹配规则。
• 显式任务提交可以直接从 RS 消耗缺失的物品；缺失的需求会在 JEI 中标记书签。
• 合成和外部获取的物品分开计算，以防止重复进度。
• 需要 FTB Quests 和 FTB Teams；当安装另一个兼容的自动探测器时，RSI 会让位给它。

快速开始

1. 构建并为一个精致存储网络提供能量。
2. 获取一个 RSI 网络连接器。
3. Shift+右键点击一个受支持的机器以绑定它。
4. 在 JEI 中打开一个配方并使用 RSI 合成操作。
5. 查看生成的计划，选择替代方案或重复次数，然后启动链。
6. 使用 P 键查看进度；完成的输出返回 RS，或者在没有网络时返回玩家。

默认按键

所有按键映射都可以在 Minecraft 控制设置中更改。可配置的数字键码使用 GLFW 值。

操作	上下文	功能
F	容器界面	存入容器内容
G	任意/容器界面	切换 RS / Sophisticated Backpack 转移目标
Y	任意界面	切换 RS 侧边栏
H	任意界面	切换机器管理中心
P	任意界面	打开/关闭当前合成进度
Alt + 左键点击	JEI 物品	按模组过滤
Alt + 中键点击	JEI 物品列表	清除搜索
Ctrl+T	JEI 配方	传输到 RS 合成网格
Ctrl + 左键拖动	RS 网格	滑动提取每种物品各一个
左键拖动，然后 A / H / Esc	JEI 列表	书签 / 隐藏 / 清除框选
U / R	悬停的侧边栏物品	在 JEI 中显示用途 / 配方

合成集成

下表列出了当前代码注册的专用配方集成。仅支持远程 GUI 的方块也可以通过 customGuiMachineMods 添加。

模组	支持的配方或机器
原版 / 红砖熔炉	熔炉、高炉、烟熏炉、营火、酿造台、切石机、锻造台、铁砧、附魔
Iron Furnaces	熔炉、高炉和烟熏模式的各等级熔炉
Botania	魔力池/催化剂、花瓣台、符文祭坛、植物酿造台、精灵交易、泰拉板、纯银雏菊
Ars Nouveau	注魔室和附魔装置
Goety	Necro Brazier、Dark Altar、Cursed Cage、Soul Candlestick 及受支持的仪式配方
Malum	Spirit Altar、Spirit Crucible、Runic Workbench、Spirit Infusion 及相关配方；相邻祭坛独立收集输出
Eidolon	工作台、坩埚和火盆
Forbidden & Arcanus	Hephaestus Forge、Clibano、锻造/应用修饰流程
Wizards Reborn	Wissen Crystallizer、Arcane Iterator、Arcane Workbench、水晶仪式
东方小女仆	女仆祭坛，包括从 RS 自动补充 P 点
Embers Rekindled	炼金台，包括推断和确定性布局
Aetherworks	Aetherium Anvil 和 Tool Station
The Aether	冷冻器、孵化器和祭坛
Crock Pot	炖锅和便携炖锅
农夫乐事	烹饪锅和煎锅
Farmer's Respite	水壶
Youkai's Homecoming	摩卡壶、发酵罐、蒸锅、水壶、烹饪锅、案板
Immortaler's Delight	Enchantal Cooler
Apotheosis	制箭、宝石切割、附魔图书馆扫描/导入、重铸 GUI 访问，以及具有递归材料合成的服务器权威刷怪笼升级
TACZ 及兼容枪包	枪械工台配方，包括带有 NBT 的枪械/弹药
Avaritia	压缩至终极的六级合成台、四级中子压缩机和终极锻造
SlashBlade	NBT 敏感的合成配方
Confluence	工作坊
Distant Worlds	Lithum Altar 及相关交互/HUD 支持
Lychee	虚拟物品内部/浸泡和方块交互配方；方块交互可通过绑定的机械冲压机运行
Farming for Blockheads	市场交易作为虚拟配方和递归合成中间体
Project MMO	概率回收配方，具有递归材料规划、等级检查、经验、次要输出和可配置的多块结构绑定
Crabber's Delight	捕蟹笼处理

自定义 GUI 默认包括 Crabber's Delight、Metal Barrels、PGP、EMX Arms、Apotheosis 和 Ancient Reforging。即使没有自动配方委托，它们也提供绑定和远程 GUI 访问。

配置

配置文件带有注释和验证范围的文档说明：

• config/rs_integration/common.toml：功能开关、可选集成、被动效果、自动进食、侧边栏、GUI 机器白名单。
• saves/<world>/serverconfig/rs_integration/server.toml：配方选择、超时、递归深度/步骤限制、DAG 并发、受保护储备、特定机器策略。
• config/rs_integration/client.toml：侧边栏位置、大小、可见性和 HUD 偏好。

重要的服务器控制包括配方偏好/黑名单、重复限制、解析预算、并发图节点/操作、每个模组的并行策略和全局链超时。当添加新的默认值时，现有配置文件不会被覆盖；请手动合并新的列表条目或重新生成文件。

诊断

• /rsi cancel 取消玩家的活动链。
• /rsi_debug 向权限级别 2 的操作员公开链、分类账、配方索引、处理器、绑定、跟踪、审计、Embers 缓存/锁和性能诊断。
• diagnosticVerboseLogging 在故障排除时启用详细的解析器和调度器日志记录。

构建

.\gradlew.bat test --no-daemon
.\gradlew.bat build --no-daemon

发布 JAR 文件写入 build/libs/ 目录，并通过构建的 verifyReleaseJar 任务进行验证。

许可

保留所有权利。