Beyond storage addon

Beyond Storage Addon

这是一个为 Beyond Dimensions 开发的附属模组：在普通容器界面提供按钮和快捷键，把物品一键存入维度网络。

功能概览

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

支持版本

与 Beyond Dimensions 的发布矩阵对齐：

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

使用方法

安装

1. 安装 Beyond Dimensions 与本模组（客户端与服务端都需要）。
2. 启动游戏后，打开任意普通容器（箱子、熔炉、背包界面上的其他容器等）。
3. 使用下方按钮、快捷键或命令完成存入。

按钮与快捷键

补充说明：

• 快捷键总开关：/bs_addon hotkey on|off 或配置 enableHotkey。
• 默认在搜索框/输入框聚焦时不会触发快捷键（ignoreHotkeyWhenTyping=true），避免在精妙存储等界面输入 F 时误存。
• 部分界面可通过配置隐藏按钮、禁用快捷键，或完全禁用一键存入（见下方配置）。
• 按钮开关需要重新打开容器界面后才会显示/隐藏；快捷键与目标网络等修改会立即生效。
• 服务端有请求冷却（默认 250ms），同一玩家在同一容器内高频连按会被限流。

整理存入 vs 全部存入

• 整理存入（smart）：只转移「目标维度网络里已经存在」的物品。网络没有的物品会尝试放回玩家背包；背包满则留在原容器，不会丢弃或复制。
• 全部存入（all）：在安全槽位策略允许的前提下，尽可能把容器内物品全部存入网络。

• 匹配模式影响「网络是否已有」的判断（仅整理存入）：

  • same 同类匹配（默认）：同物品 ID 即视为已有；不同附魔书、不同耐久工具等同 ID 物品也会按已有同类处理。潜在容器/存储类物品仍更严格。
  • exact 精确匹配：物品 ID 与 NBT/组件都必须一致。

目标网络

• 默认 targetNetworkId=-1：跟随当前 Beyond Dimensions 主网络。
• `/bs_addon target set `：绑定到指定网络 ID。
• /bs_addon target clear：清除绑定，恢复跟随主网络。
• /bs_addon target status：查看当前绑定状态。

游戏内命令一览（/bs_addon）

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

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

配置

配置文件路径：

config/beyondstorage.properties

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

Обзор настроек

Правила сопоставления префиксов классов:

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

Безопасное поведение по умолчанию (работает без настройки):

• По умолчанию пропускается инвентарь игрока (если только storePlayerInventory=true), собственные контейнеры Beyond Dimensions, слоты, из которых нельзя забрать предмет, а также небезопасные выходные/виртуальные слоты.
• Перед складыванием сначала симулируется вместимость сети, извлекается только то количество, которое реально можно положить; остаток при неудаче возвращается в исходный слот.
• При сортированном складывании предметы, которых нет в сети, пытаются вернуться в инвентарь, а если инвентарь полон — остаются в исходном контейнере.

Зависимости

• Обязательно: Beyond Dimensions
• Этот мод не заменяет сетевые терминалы, воронки, насосы и другие функции основной модификации, а лишь добавляет лёгкое улучшение «обычный контейнер → измеренческая сеть».

Beyond Storage Addon (English)

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

Обзор возможностей

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

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

Синхронизировано с Beyond Dimensions:

Для 1.21.11 требуется соответствующая сборка Beyond Dimensions (включая alpha). Скачайте файл, подходящий вашей версии игры и загрузчику.

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

Установка

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

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

Заметки:

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

Сортировочный склад против полного склада

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

• Режим совпадения (только для сортировочного склада):

  • same (по умолчанию): совпадение по id предмета считается наличием; защищённые контейнеры и предметы типа хранилищ остаются строже.
  • exact: должны совпадать id предмета и 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 debug current → скопируйте стабильный префикс пакета в hideButtonInScreens, disableHotkeyInScreens или disableQuickStoreInContainers.

Конфиг

Файл:

config/beyondstorage.properties

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

Все ключи

Сопоставление по префиксу:

• Сопоставляет имя класса Screen/Menu и его суперклассы по префиксу.
• Разделяйте несколько префиксов через , или ;.
• Для определения имён классов лучше используйте /bs_addon debug current.

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

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

Зависимости

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