Beyond storage addon

Аддон за пределами хранилища

这是一个为 **За пределами измерений**开发的附属模组:在普通容器界面提供按钮和快捷键,把物品一键存入维度网络。

功能概览

• 整理存入:普通 F 默认只把目标网络里已有同类的物品存入网络。
• 全部存入:Ctrl+F 与界面「全部存入」按钮,一键存入符合安全规则的全部物品。
• 目标网络: 可绑定指定维度网络, 避免不知道物品进了哪个网络。
• 游戏内配置:/bs_addon 系列命令,无需先改配置文件。
• 匹配模式:同类匹配 / 精确匹配；潜在容器类物品更谨慎。
• 界面控制: Экран/Меню类名前缀隐藏按钮、禁用快捷键或完全禁用一键存入；输入框聚焦时避免误触。
• 安全策略: 服务端校验容器、先模拟网络容量再抽取、跳过不安全槽位，降低复制/吞物品风险。

支持版本

В фильме «За пределами измерений»:

| Майнкрафт | 加载器 | 文件 | | --- | --- | --- | | 1.20.1 | Кузница | BS_addon_forge-1.20.1-1.3.0.jar | | 1.21.1 | НеоФордж | BS_addon_neoforge-1.21.1-1.3.0.jar | | 21.1.11 | НеоФордж | BS_addon_neoforge-1.21.11-1.3.0.jar | | 26.1.2 | НеоФордж | BS_addon_neoforge-26.1.2-1.3.0.jar | | 26,2 | НеоФордж | BS_addon_neoforge-26.2.0-1.3.0.jar |

1.21.11 需配合对应版本的 Beyond Dimensions（含 Alpha）。请下载与你游戏版本、加载器一致的文件。

使用方法

安装

1. 安装 За пределами измерений 与本模组（客户端与服务端都需要）。
2. 启动游戏后,打开任意普通容器（箱子、熔炉、背包界面上的其他容器等).
3. 使用下方按钮、快捷键或命令完成存入。

按钮与快捷键

| 操作 | 默认行为 | 说明 | | --- | --- | --- | | 界面「全部存入」按钮 | 全部存入 | 行为固定为全部存入；开关见 showButton / /bs_addon button | | 普通 F | 整理存入 | 只把目标网络里已有同类的物品存入；可用 /bs_addon mode normal 改 | | Ctrl+F | 全部存入 | 存入符合安全规则的全部物品；可用 /bs_addon mode ctrl 改 |

补充说明:

• 快捷键总开关: /bs_addon hotkey on|off 或配置 enableHotkey。
• 默认在搜索框/输入框聚焦时不会触发快捷键(ignoreHotkeyWhenTyping=true), 避免在精妙存储等界面输入F 时误存。
• 部分界面可通过配置隐藏按钮、禁用快捷键，或完全禁用一键存入（见下方配置). -按钮开关需要重新打开容器界面后才会显示/隐藏；快捷键与目标网络等修改会立即生效。
• 服务端有请求冷却(время 250 мс),

整理存入 против 全部存入

• 整理存入(умный): 只转移「目标维度网络里已经存在」的物品。网络没有的物品会尝试放回玩家背包；背包满则留在原容器,不会丢弃或复制。
• 全部存入(все):在安全槽位策略允许的前提下,尽可能把容器内物品全部存入网络。
• 匹配模式影响「网络是否已有」的判断(仅整理存入):
  • same 同类匹配（默认）:同物品 ID 即视为已有；不同附魔书、不同耐久工具等同 ID物品也会按已有同类处理。潜在容器/存储类物品仍更严格。
  • exact 精确匹配: 物品 ID 与 NBT/组件都必须一致。

目标网络

• 默认 targetNetworkId=-1:跟随当前 Beyond Dimensions 主网络。
• /bs_addon target set <id>: ID карты.
• /bs_addon target clear:清除绑定,恢复跟随主网络。
• /bs_addon target status: 查看当前绑定状态。

游戏内命令一览(/bs_addon)

命令为客户端配置命令,会写入 config/beyondstorage.properties。

| 命令 | 作用 | | --- | --- | | /bs_addon 或 /bs_addon help | 显示帮助 | | /bs_addon status | 显示按钮、快捷键、普通 F 模式、Ctrl+F 模式、匹配模式状态 | | /bs_addon button on | 显示「全部存入」按钮（需重开容器界面） | | /bs_addon button off | 隐藏按钮（需重开容器界面) | | /bs_addon hotkey on | 启用快捷键 | | /bs_addon hotkey off | 禁用快捷键 | | /bs_addon mode status | 查看普通 F / Ctrl+F / 匹配模式 | | /bs_addon mode normal smart | 普通 F = 整理存入 | | /bs_addon mode normal all | 普通 F = 全部存入 | | /bs_addon mode ctrl smart | Ctrl+F = 整理存入 | | /bs_addon mode ctrl all | Ctrl+F = 全部存入 | | /bs_addon match same | 整理存入使用同类匹配 | | /bs_addon match exact | 整理存入使用精确匹配 | | /bs_addon target status | 查看目标网络（绑定 ID 或主网络） | | /bs_addon target set <id> | 绑定目标网络(<id> 为 ≥0 的整数) | | /bs_addon target clear | 清除目标网络绑定 | | /bs_addon debug current | 输出上次打开界面的 Экран/Меню 完整类名（便于填配置前缀） | | /bs_addon debug last | 输出上次成功发起存入时的 Экран/Меню 类名 |

debug 用法示例:打开某个模组的箱子界面 → 聊天栏执行 /bs_addon debug current →把打印的类名（或包名前缀）填进配置的 hideButtonInScreens / disableHotkeyInScreens / disableQuickStoreInContainers。

配置

配置文件路径:

config/beyondstorage.properties

首次启动若文件不存在会自动生成。部分选项可用 /bs_addon命令直接改写；其余选项请编辑本文件后重启客户端/服务端（视选项而定；命令改写的项会立即保存）。

配置项一览

| 配置键 | 默认值 | 说明 | | --- | --- | --- | | showButton | true | 是否在支持的容器界面显示「全部存入」按钮。可用 /bs_addon button on\|off。改后需重开容器界面。 | | enableHotkey | true | 是否启用快捷键。可用 /bs_addon hotkey on\|off。 | | targetNetworkId | -1 | 一键存入使用的网络 ID。-1 = 跟随 BD 主网络。可用 /bs_addon target set\|clear。 | | normalStoreMode | smart | 普通 F 的行为: smart = 整理存入，all = 全部存入。可用 /bs_addon mode normal smart\|all。 | | ctrlStoreMode | all | Ctrl+F 的行为: smart / all。可用 /bs_addon mode ctrl smart\|all。 | | existingItemMatchMode | same | 整理存入时如何判断「网络已有」: same 同类匹配，exact 精确匹配。可用 /bs_addon match same\|exact。 | | ignoreHotkeyWhenTyping | true | 搜索框/文本框聚焦时忽略快捷键，防止输入 F 误触发。 | | hideButtonInScreens | （空） | 隐藏按钮的 Экран/Меню 类名前缀列表，逗号或分号分隔。示例:net.p3pp3rf1y.sophisticatedstorage. | | disableHotkeyInScreens | （空） | 禁用快捷键的 Экран/Меню 类名前缀列表。写法同上。 | | storePlayerInventory | false | 打开容器时是否也从玩家自己的背包槽位存入网络。默认关闭,避免误清空背包。 | | requireSlotMayPlace | true | 只移动「允许放回同类物品」的槽位。用于规避机器输出槽、虚拟槽等不安全槽位。建议保持开启。 | | requestCooldownMs | 250 | 同一玩家在同一容器内一键存入请求的冷却（毫秒）,范围0–5000。 高延迟服务器可适当加大。 | | disableQuickStoreInContainers | com.wintercogs.beyonddimensions. | 完全禁用一键存入的容器类名前缀（按钮、快捷键、服务端请求全部拦截）。默认屏蔽Beyond Dimensions 自身界面。旧键名 blockedContainerClassPrefixes 仍可读。 |

类名前缀匹配规则:

• Экран экрана и меню 的类名及其父类做前缀匹配。
• 多个前缀用英文逗号 , 或分号 ; 分隔。
• 推荐用 /bs_addon debug current 查看完整类名，再截取稳定包前缀填写。

安全相关默认行为（无需配置即可生效):

• 默认跳过玩家背包（除非 storePlayerInventory=true）、За пределами измерений自身容器、不可拾取槽位，以及不安全的输出/虚拟槽位。
• 存入前先模拟网络容量，只抽取实际可存入数量；失败剩余回填原槽位。
• 整理存入时, 网络没有的物品会尝试放回背包, 背包满则留在原容器。

依赖

• 必需: За пределами измерений
• 本模组不替代本体的网络终端、漏斗、泵等功能，只做「普通容器 →维度网络」的轻量增强。

Дополнение Beyond Storage (английский)

Дополнение для Beyond Dimensions, которое добавляет кнопку и горячие клавиши на обычные экраны контейнеров для хранения элементов в сети измерений.

Обзор функций

• Сортировать хранилище: обычный F сохраняет только те элементы, которые уже существуют в целевой сети (по режиму соответствия).
• Полный магазин: Ctrl+F и кнопка графического интерфейса сохраняют все подходящие предметы.
• Целевая сеть: привяжите определенный идентификатор размерной сети.
• Внутриигровая конфигурация: команды /bs_addon записывают config/beyondstorage.properties.
• Режимы совпадения: одинаковый или точный предмет; контейнероподобные предметы остаются более строгими.
• Управление пользовательским интерфейсом: скрыть кнопку / отключить горячую клавишу / полностью отключить быстрое сохранение по префиксу класса экрана или меню; игнорировать горячие клавиши при наборе текста.
• Безопасность: проверка контейнеров на стороне сервера, симуляция емкости перед извлечением, пропуск небезопасных слотов.

Поддерживаемые версии

В соответствии с запредельными измерениями:

| Майнкрафт | Погрузчик | Файл | | --- | --- | --- | | 1.20.1 | Кузница | BS_addon_forge-1.20.1-1.3.0.jar | | 1.21.1 | НеоФордж | BS_addon_neoforge-1.21.1-1.3.0.jar | | 21.1.11 | НеоФордж | BS_addon_neoforge-1.21.11-1.3.0.jar | | 26.1.2 | НеоФордж | BS_addon_neoforge-26.1.2-1.3.0.jar | | 26,2 | НеоФордж | BS_addon_neoforge-26.2.0-1.3.0.jar |

Для версии 1.21.11 требуется соответствующая сборка Beyond Dimensions (включая альфа-версию). Загрузите файл, соответствующий вашей версии игры и загрузчику.

Как использовать

Установить

1. Установите Beyond Dimensions и это дополнение (клиент и сервер).
2. Откройте любой обычный контейнер (сундук, печь и т.п.).
3. Используйте кнопку, горячие клавиши или команды ниже.

Кнопка и горячие клавиши

| Действие | По умолчанию | Заметки | | --- | --- | --- | | Кнопка Полный магазин в графическом интерфейсе пользователя | Полный магазин | Всегда полный магазин; переключиться с помощью showButton / /bs_addon button | | Обычный F | Сортировать по магазинам | Только элементы, уже присутствующие в целевой сети; изменить с помощью /bs_addon mode normal | | Ctrl+F | Полный магазин | Все подходящие предметы; изменить с помощью /bs_addon mode ctrl |

Примечания:

• Главный переключатель горячих клавиш: /bs_addon hotkey on|off или enableHotkey.
• Пока поле поиска/текста находится в фокусе, горячие клавиши по умолчанию игнорируются (ignoreHotkeyWhenTyping=true).
• Поэкранные списки могут скрывать кнопку, отключать горячую клавишу или полностью блокировать быстрое сохранение (см. конфигурацию).
• Для видимости кнопки необходимо повторное открытие контейнера; Изменения горячих клавиш/целей применяются немедленно.
• Время восстановления запроса сервера по умолчанию составляет 250 мс на игрока в контейнере.

Сортировка магазина или полный магазин

• Сортировка магазина (smart): перемещайте только те элементы, которые уже есть в целевой сети. Недостающие предметы пытаются вернуть в инвентарь игрока; если они заполнены, они остаются в контейнере — без удаления и дублирования.
• Полный магазин (all): сохраните все предметы, разрешенные политикой безопасного слота.
• Режим сопоставления (только сортировка магазина):
  • same (по умолчанию): тот же идентификатор предмета считается существующим; защищенные контейнеры/предметы хранения остаются более строгими.
  • exact: идентификатор предмета и NBT/компоненты должны совпадать.

Целевая сеть

• По умолчанию targetNetworkId=-1: следовать за основной сетью Beyond Dimensions.
• /bs_addon target set <id>: привязка к идентификатору сети.
• /bs_addon target clear: четкая привязка.
• /bs_addon target status: показать текущую привязку.

Команды (/bs_addon)

Команды конфигурации на стороне клиента; они пишут config/beyondstorage.properties.

| Команда | Эффект | | --- | --- | | /bs_addon или /bs_addon help | Показать помощь | | /bs_addon status | Кнопка, горячая клавиша, обычный режим, режим Ctrl, режим соответствия | | /bs_addon button on | Показать кнопку «Полный магазин» (переоткрыть контейнер) | | /bs_addon button off | Скрыть кнопку (переоткрыть контейнер) | | /bs_addon hotkey on | Включить горячие клавиши | | /bs_addon hotkey off | Отключить горячие клавиши | | /bs_addon mode status | Показать F / Ctrl+F / режимы сопоставления | | /bs_addon mode normal smart | Обычный F = сортировка магазина | | /bs_addon mode normal all | Обычный F = полный магазин | | /bs_addon mode ctrl smart | Ctrl+F = сортировка магазина | | /bs_addon mode ctrl all | Ctrl+F = полный магазин | | /bs_addon match same | В магазине сортировки используются одинаковые товары | | /bs_addon match exact | В магазине сортировки используется точное соответствие | | /bs_addon target status | Привязанный идентификатор или основная сеть | | /bs_addon target set <id> | Привязать целевую сеть (id ≥ 0) | | /bs_addon target clear | Четкая привязка | | /bs_addon debug current | Печать последних открытий Имен классов экрана/меню | | /bs_addon debug last | Печать последняя попытка сохранения Имена классов экрана/меню |

Совет: откройте проблемный пользовательский интерфейс → запустите /bs_addon debug current → скопируйте префикс стабильного пакета в hideButtonInScreens, disableHotkeyInScreens или disableQuickStoreInContainers.

Конфигурация

Файл:

config/beyondstorage.properties

Создается автоматически при первом запуске. Некоторые клавиши можно изменить с помощью /bs_addon; другим необходимо отредактировать этот файл.

Все ключи

| Ключ | По умолчанию | Описание | | --- | --- | --- | | showButton | true | Покажите кнопку «Полный магазин». /bs_addon button on\|off. После замены снова откройте контейнер. | | enableHotkey | true | Включите горячие клавиши. /bs_addon hotkey on\|off. | | targetNetworkId | -1 | Идентификатор сети для быстрого магазина. -1 = первичный BD. /bs_addon target set\|clear. | | normalStoreMode | smart | Обычный F: smart = хранилище сортировки, all = полное хранилище. /bs_addon mode normal ... | | ctrlStoreMode | all | Ctrl+F: smart / all. /bs_addon mode ctrl ... | | existingItemMatchMode | same | Соответствие сортировки и хранения: same или exact. /bs_addon match ... | | ignoreHotkeyWhenTyping | true | Игнорируйте горячие клавиши, пока текстовое поле находится в фокусе. | | hideButtonInScreens | (пусто) | Префиксы имен классов экрана/меню, которые скрывают кнопку. Разделяются запятой или точкой с запятой. Пример: net.p3pp3rf1y.sophisticatedstorage. | | disableHotkeyInScreens | (пусто) | Префиксы, которые отключают горячую клавишу. Тот же синтаксис. | | storePlayerInventory | false | Также сохраняйте данные из собственных слотов инвентаря игрока, пока контейнер открыт. По умолчанию выключено. | | requireSlotMayPlace | true | Перемещайте обратно только те слоты, которые могут принять тот же предмет. Избегает небезопасного машинного вывода/виртуальных слотов. Оставить включенным. | | requestCooldownMs | 250 | Время восстановления каждого контейнера для каждого игрока в мс (0–5000). Поднимите на серверах с высокой задержкой. |

| disableQuickStoreInContainers | com.wintercogs.beyonddimensions. | Префиксы, которые полностью блокируют быстрое сохранение (кнопки, горячие клавиши и запросы к серверу). По умолчанию используются собственные пользовательские интерфейсы BD. Устаревший ключ blockedContainerClassPrefixes все еще читается. |

Соответствие префиксов:

— Соответствует имени класса Screen/Menu и его суперклассам по префиксу.

• Разделяйте несколько префиксов с помощью , или ;.
• Предпочитайте /bs_addon debug current, чтобы узнать имена классов.

Встроенная безопасность (настройка не требуется):

• По умолчанию пропускает инвентарь игрока, контейнеры BD, слоты, которые нельзя подбирать, а также небезопасные выходные/виртуальные слоты.
• Имитирует пропускную способность сети перед извлечением; оставшиеся стопки возвращаются в исходный слот.
• Магазин сортировки никогда не удаляет и не дублирует элементы, которых еще нет в сети.

Зависимости

• Обязательно: За пределами измерений
• Этот аддон не переопределяет терминалы, воронки или насосы BD — он только ускоряет контейнер → сетевое хранилище.