自动存储
将所有远征资源放在一个地点即可自动存储所有物品。即插即用。支持模组兼容性、灵活选项与个人偏好、编辑配方、简单用户界面以及完整的本地化支持。
查看大图
📦 自动存储：快速易用
AutoStorage 是一款轻量、高效、强大的模组，可自动在箱子之间分类物品。
将远征资源全部丢在一个位置，即可自动存储所有物品。
🚀 工作原理？
- 在二级工匠台上制作 自动存储箱。
- 在基地中放置它。
- 将物品放入自动存储箱，它就会将物品分配到附近兼容的箱子中。
- 潜行 + 互动 (F) 对箱子进行配置。
✨ 特性
- 📦 自动将物品分配到附近的箱子 （兼容带有容器的模组）
- 🧠 智能目标：物品会被存入已含有相同类型物品的箱子中
- 🧩 两种分类模式：精确物品 ID 或物品类别
- ⏱️ 可服务器配置的转移速率（按组或物品数量）
- ⚡ 事件驱动架构：无后台轮询（与类似插件不同），服务器负载极低
- 🧱 智能转移：尊重你的箱子组织方式。先填满已有物品堆，再使用空槽位
- 🖥️ 游戏内 UI 用于逐箱配置 （潜行 + F）
- 🎛️ 通过 UI 设置每个箱子的分类模式
- 💩 箱子上的独立选项，例如：“若无匹配则转移至空箱子”或“忽略此箱子”
- 📏 每个箱子可分别控制水平/垂直范围，带 +/- 按钮
- 🔗 实时显示范围内已链接的箱子数量，并显示范围
- ⚙️ 丰富的配置选项和灵活性，可满足大型和小型服务器的需求
- 📝 配置中的高级过滤，可指定允许或禁止转移的物品容器 ID
- 🏢 安全机制避免任何复制。优化以实现低 CPU 占用
- 🟢 与 SimpleClaims 模组兼容，防止恶意破坏
- 🌍 本地化 UI 和物品名称：AR / BG / CS / DE / EL / EN / ES, PE / ET / FR / IT / NL / PL / PT / RU / SK / SV / TR / UK（由 ChatGPT 辅助，抱歉）。
🐞 错误报告与建议
发现错误、有想法或想请求功能？
- ✅ 最佳方式： 加入我的 Discord 并在相应频道发帖
🧰 命令
| 命令 | 描述 |
|---|---|
/autostorage reload |
重载插件配置 （别名：/as reload） |
🔐 权限
| 功能 | 权限 |
|---|---|
| 授权制作自动存储 （当制作被禁用时） | autostorage.craft |
| 打开任何自动存储的配置 （当 onlyStorageOwnerCanConfig 启用时） | autostorage.config.any |
⚙️ 配置
配置文件按章节组织。
每个设置都可完全自定义以满足您的服务器需求。
radius
游戏内 UI 允许玩家将每个自动存储的范围调整至最大值。
控制服务器上所有自动存储箱的最大范围。
| 键 | 描述 | 默认值 | 范围 |
|---|---|---|---|
horizontalRadiusMax |
最大水平半径（方块数） | 18 |
1 到 200 |
verticalRadiusMax |
最大垂直半径（方块数） | 15 |
1 到 200 |
| defaultHorizontalRadius | 放置自动存储箱时的默认水平半径 | 14 | 1 到 200 |
| defaultVerticalRadius | 放置自动存储箱时的默认垂直半径 | 6 | 1 到 200 |
每个箱子的默认半径
- ↔️ 水平：14 个方块
- ↕️ 垂直：6 个方块
🔁 transferConfig
控制物品如何以及何时转移。
| 键 | 描述 | 默认值 | 范围 |
|---|---|---|---|
transferImmediate |
true：容器变化时立即转移。false：最后一次交互后延迟。 | true |
x |
transferAfterLastInteractionInSeconds |
需要 transferImmediate = false 才能应用最后一次交互后的延迟（秒） |
3 |
0 到 60 |
transferOnlyWhenClose |
仅当箱子关闭时转移 | false |
x |
transferMode |
转移单位：STACKS：每次迭代转移一组（更多控制，更少泛滥）。ITEMS：每次迭代最多转移 N 个单独物品。 | STACKS |
x |
transferAmountPerTransfer |
每次转移迭代的组数/物品数量 | 1 |
1 到 1000 |
transferIntervalMs |
成功转移之间的冷却时间（毫秒） | 1000 |
50 到 5000 |
🧩 分类设置
| 键 | 描述 | 默认值 | 范围 |
|---|---|---|---|
defaultSortingMode |
全局默认分类模式：ITEM_ID：精确物品匹配（铁剑仅匹配铁剑）。ITEM_CATEGORY：基于类别的分类（所有武器在一起，所有工具在一起）。 | ITEM_ID |
x |
idleRetryMs |
没有物品移动时的重试间隔（毫秒） | 5000 |
250 到 60000 |
idleRetryBackoffMaxMs |
对于长时间未找到物品而休眠的自动存储箱的最大重试间隔（毫秒） | 60000 | 250 到 60000 |
| targetScanCacheMaxAgeMs | 15000 | 250 到 60000 | |
onlyStorageOwnerCanConfig |
只有放置自动存储箱的玩家才能打开 UI | false |
x |
🛠️ 制作
| 键 | 描述 | 默认值 |
|---|---|---|
itemIsCraftable |
启用/禁用自动存储物品的制作 | true |
craftRequiresPermission |
需要权限才能查看/制作自动存储 | false |
craftRequiresPermissionName |
启用时使用的权限节点 | autostorage.craft |
| craftOutputQuantity | 每次制作产出的自动存储箱数量 | 1 |
🧪 recipeOverride（可选）
自动存储制作配方的可选覆盖（物品 ID：Furniture_AutoStorage）。
启用时，插件会生成一个物品覆盖文件并重载物品资产。
| 键 | 描述 | 默认值 |
|---|---|---|
enabled |
启用覆盖 | false |
timeSeconds |
制作持续时间（秒） | 2.0 |
input |
材料列表 (itemId, quantity) |
x |
benchRequirement |
工作台要求 (id, type, categories, requiredTierLevel) |
x |
🎯 targetFilter
控制哪些目标容器被认为是有效的。
匹配顺序为：
- 按精确方块 ID 拒绝
- 按 ID 包含拒绝
- 按精确方块 ID 允许
- 按 ID 包含允许
| 键 | 描述 | 默认值 |
|---|---|---|
| allowBlockIdsEnabled | 启用或禁用 allowBlockIds 过滤器 | false |
| denyBlockIdsEnabled | 启用或禁用 denyBlockIds 过滤器 | false |
| allowIdContainsEnabled | 启用或禁用 allowIdContains 过滤器 | false |
| denyIdContainsEnabled | 启用或禁用 denyIdContains 过滤器 | true |
allowBlockIds |
要允许的精确方块 ID（完整 ID 字符串） | [] |
denyBlockIds |
要拒绝的精确方块 ID（完整 ID 字符串） | [] |
allowIdContains |
如果方块 ID 包含这些标记之一则允许 | [] |
denyIdContains |
如果方块 ID 包含这些标记之一则拒绝 | ["autostorage", "salvage", "campfire", "furnace", "tanery"] |
📜 模组兼容性
| 键 | 描述 | 默认值 |
|---|---|---|
| claimModCompatibility | 启用或禁用与领地模组的兼容性 | false |
📐 分类规则
自动存储分配物品时遵循以下规则：
- ✅ 物品仅转移到已含有该物品类型的箱子
- ✅ 自动存储箱永远不会相互转移物品
- ✅ 先填满现有物品堆，再使用空槽位
- ✅ 优先选择拥有该物品类型最多的箱子
- ✅ 尊重物品堆叠限制（因物品而异）
- ✅ 如果主要目标已满，则回退到次要目标
- ✅ 保持条件一致：完好 → 完好，损坏 → 损坏
🖥️ 用户界面
🔓 打开 UI
潜行（蹲下）+ 互动 (F) 一个自动存储箱，打开原生配置 UI。
如果启用了
onlyStorageOwnerCanConfig，只有放置该自动存储箱的玩家才能打开此 UI。
↔️ 显示范围
🧾 分类模式 (UI)
| 模式 | 描述 |
|---|---|
| 相同物品 | 按精确物品 ID 分类（严格匹配） |
| 物品类别 | 按类别分类（武器、工具、护甲等）——包含关于不一致类别的警告 |
📏 范围控制
每个自动存储箱都有自己的搜索半径：
- ↔️ 水平范围：1 到
horizontalRadiusMax个方块（默认：14） - ↕️ 垂直范围：1 到
verticalRadiusMax个方块（默认：6）
使用 UI 中的 + 和 - 按钮进行调整。更改会自动保存。
✅ 选中的模式和范围按箱子保存，并覆盖全局设置。
💾 持久化
📌 追踪的箱子
- 被追踪的箱子会自动保存到
tracked_autostorage.json - 服务器启动时，插件会重新加载所有被追踪的箱子
🧾 每个箱子保存的数据
| 存储的数据 | 备注 |
|---|---|
| 世界名称 | x |
| X, Y, Z 坐标 | x |
| 拥有者 UUID | 当可用时 |
| 分类模式覆盖 | 按箱子 |
| 水平/垂直半径 | 按箱子 |
🧪 制作配方（默认）
✅ 所有内容均可在配置中编辑。
| 属性 | 值 |
|---|---|
| 制作时间 | 2 秒 |
| 工作台 | 工匠台（二级以上） |
| 存储容量 | 36 个槽位 |
| 最大堆叠 | 2 |
📜 材料
- 5* 浓缩生命精华
- 20* 铜锭
- 20* 铁锭
- 1* 金锭
🌍 语言文件
该插件提供本地化的物品名称和 UI 文本。
它会自动检测您的游戏语言。（感谢 ChatGPT！）
🧩 查看我的其他模组
如果您喜欢 自动存储，您可能也会喜欢我的其他模组：
- 🔥 打开背包与检查装备
- ⛏️ 逃生绳：快速离开洞穴
👉 我努力使我的模组易于使用、轻量、可配置且对服务器友好。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表，这里同步展示。