Beyond Storage Addon connects any container directly to your Beyond Dimensions network, allowing for instant, one-click storage management.
这是一个为 Beyond Dimensions 开发的附属模组：在普通容器界面提供按钮和快捷键，把物品一键存入维度网络。
F 默认只把目标网络里已有同类的物品存入网络。Ctrl+F 与界面「全部存入」按钮，一键存入符合安全规则的全部物品。/bs_addon 系列命令，无需先改配置文件。
与 Beyond Dimensions 的发布矩阵对齐：
| Minecraft | 加载器 | 文件 |
|---|---|---|
| 1.20.1 | Forge | BS_addon_forge-1.20.1-1.3.0.jar |
| 1.21.1 | NeoForge | BS_addon_neoforge-1.21.1-1.3.0.jar |
| 1.21.11 | NeoForge | BS_addon_neoforge-1.21.11-1.3.0.jar |
| 26.1.2 | NeoForge | BS_addon_neoforge-26.1.2-1.3.0.jar |
| 26.2 | NeoForge | BS_addon_neoforge-26.2.0-1.3.0.jar |
1.21.11 需配合对应版本的 Beyond Dimensions（含 alpha）。请下载与你游戏版本、加载器一致的文件。
| 操作 | 默认行为 | 说明 |
|---|---|---|
| 界面「全部存入」按钮 | 全部存入 | 行为固定为全部存入；开关见 showButton / /bs_addon button |
普通 F | 整理存入 | 只把目标网络里已有同类的物品存入；可用 /bs_addon mode normal 改 |
Ctrl+F | 全部存入 | 存入符合安全规则的全部物品；可用 /bs_addon mode ctrl 改 |
补充说明：
/bs_addon hotkey on|off 或配置 enableHotkey。ignoreHotkeyWhenTyping=true），避免在精妙存储等界面输入 F 时误存。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 | 输出上次打开界面的 Screen / Menu 完整类名（便于填配置前缀） |
/bs_addon debug last | 输出上次成功发起存入时的 Screen / Menu 类名 |
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 | （空） | 隐藏按钮的 Screen/Menu 类名前缀列表，逗号或分号分隔。示例：net.p3pp3rf1y.sophisticatedstorage. |
disableHotkeyInScreens | （空） | 禁用快捷键的 Screen/Menu 类名前缀列表。写法同上。 |
storePlayerInventory | false | 打开容器时是否也从玩家自己的背包槽位存入网络。默认关闭，避免误清空背包。 |
requireSlotMayPlace | true | 只移动「允许放回同类物品」的槽位。用于规避机器输出槽、虚拟槽等不安全槽位。建议保持开启。 |
requestCooldownMs | 250 | 同一玩家在同一容器内一键存入请求的冷却（毫秒），范围 0–5000。高延迟服务器可适当加大。 |
disableQuickStoreInContainers | com.wintercogs.beyonddimensions. | 完全禁用一键存入的容器类名前缀（按钮、快捷键、服务端请求全部拦截）。默认屏蔽 Beyond Dimensions 自身界面。旧键名 blockedContainerClassPrefixes 仍可读。 |
类名前缀匹配规则：
, 或分号 ; 分隔。/bs_addon debug current 查看完整类名，再截取稳定包前缀填写。安全相关默认行为（无需配置即可生效）：
storePlayerInventory=true）、Beyond Dimensions 自身容器、不可拾取槽位，以及不安全的输出/虚拟槽位。An addon for Beyond Dimensions that adds a button and hotkeys on normal container screens to store items into a Dimension Network.
F only stores items that already exist in the target network (by match mode).Ctrl+F and the GUI button store all eligible items./bs_addon commands write config/beyondstorage.properties.Aligned with Beyond Dimensions:
| Minecraft | Loader | File |
|---|---|---|
| 1.20.1 | Forge | BS_addon_forge-1.20.1-1.3.0.jar |
| 1.21.1 | NeoForge | BS_addon_neoforge-1.21.1-1.3.0.jar |
| 1.21.11 | NeoForge | BS_addon_neoforge-1.21.11-1.3.0.jar |
| 26.1.2 | NeoForge | BS_addon_neoforge-26.1.2-1.3.0.jar |
| 26.2 | NeoForge | BS_addon_neoforge-26.2.0-1.3.0.jar |
1.21.11 requires a matching Beyond Dimensions build (including alpha). Download the file that matches your game version and loader.
| Action | Default | Notes |
|---|---|---|
| GUI Full Store button | Full store | Always full store; toggle with showButton / /bs_addon button |
Plain F | Sort store | Only items already present in the target network; change with /bs_addon mode normal |
Ctrl+F | Full store | All eligible items; change with /bs_addon mode ctrl |
Notes:
/bs_addon hotkey on|off or enableHotkey.ignoreHotkeyWhenTyping=true).smart): only move items the target network already has. Missing items try to return to the player inventory; if full they stay in the container — no drop, no duplication.all): store every item allowed by the safe-slot policy.same (default): same item id counts as existing; protected container/storage-like items stay stricter.exact: item id and NBT/components must match.targetNetworkId=-1: follow Beyond Dimensions primary network./bs_addon target set <id>: bind to a network id./bs_addon target clear: clear binding./bs_addon target status: show current binding./bs_addon)Client-side config commands; they write config/beyondstorage.properties.
| Command | Effect |
|---|---|
/bs_addon or /bs_addon help | Show help |
/bs_addon status | Button, hotkey, normal mode, ctrl mode, match mode |
/bs_addon button on | Show the Full Store button (reopen container) |
/bs_addon button off | Hide the button (reopen container) |
/bs_addon hotkey on | Enable hotkeys |
/bs_addon hotkey off | Disable hotkeys |
/bs_addon mode status | Show F / Ctrl+F / match modes |
/bs_addon mode normal smart | Plain F = sort store |
/bs_addon mode normal all | Plain F = full store |
/bs_addon mode ctrl smart | Ctrl+F = sort store |
/bs_addon mode ctrl all | Ctrl+F = full store |
/bs_addon match same | Sort store uses same-item matching |
/bs_addon match exact | Sort store uses exact matching |
/bs_addon target status | Bound id or primary network |
/bs_addon target set <id> | Bind target network (id ≥ 0) |
/bs_addon target clear | Clear binding |
/bs_addon debug current | Print last opened Screen / Menu class names |
/bs_addon debug last | Print last store attempt Screen / Menu class names |
Tip: open a problematic UI → run /bs_addon debug current → copy a stable package prefix into hideButtonInScreens, disableHotkeyInScreens, or disableQuickStoreInContainers.
File:
config/beyondstorage.properties
Created automatically on first launch. Some keys can be changed via /bs_addon; others need editing this file.
| Key | Default | Description |
|---|---|---|
showButton | true | Show the Full Store button. /bs_addon button on|off. Reopen container after change. |
enableHotkey | true | Enable hotkeys. /bs_addon hotkey on|off. |
targetNetworkId | -1 | Network id for quick-store. -1 = BD primary. /bs_addon target set|clear. |
normalStoreMode | smart | Plain F: smart = sort store, all = full store. /bs_addon mode normal ... |
ctrlStoreMode | all | Ctrl+F: smart / all. /bs_addon mode ctrl ... |
existingItemMatchMode | same | Sort-store matching: same or exact. /bs_addon match ... |
ignoreHotkeyWhenTyping | true | Ignore hotkeys while a text field is focused. |
hideButtonInScreens | (empty) | Screen/Menu class-name prefixes that hide the button. Comma or semicolon separated. Example: net.p3pp3rf1y.sophisticatedstorage. |
disableHotkeyInScreens | (empty) | Prefixes that disable the hotkey. Same syntax. |
storePlayerInventory | false | Also store from the player's own inventory slots while a container is open. Off by default. |
requireSlotMayPlace | true | Only move slots that can accept the same item back. Avoids unsafe machine output/virtual slots. Keep enabled. |
requestCooldownMs | 250 | Per-player per-container cooldown in ms (0–5000). Raise on high-latency servers. |
disableQuickStoreInContainers | com.wintercogs.beyonddimensions. | Prefixes that fully block quick-store (button, hotkey, and server requests). Defaults to BD’s own UIs. Legacy key blockedContainerClassPrefixes is still read. |
Prefix matching:
, or ;./bs_addon debug current to discover class names.Built-in safety (no config required):