
Modular Storage System (MSS) 将模组风格的网络存储系统引入你的服务器。使用自定义方块构建网络,在分层磁盘上存储数十万种物品,通过单一终端即可查找所有物品,并自动从箱子、熔炉和酿造台中存取物品。这是一个服务器插件:玩家无需安装任何模组或额外内容。
单个 jar 文件即可运行于 Spigot、Paper 及其衍生版本,支持 Minecraft 1.21 至 26.3。
源代码 | 报告问题 | 更新日志

存储功能
- 网络存储:使用 PoE 线缆连接 Storage Server、Drive Bays 和 Terminals。每个网络最多支持 128 个方块和 800 条线缆,均可配置。
- 四种磁盘层级:1k、4k、16k 和 64k 磁盘每种最多可存储 520,192 个物品。磁盘支持热插拔,清空后可回收分解为其组成部件。
- 终端操作:支持按名称或数量搜索排序,按住 Shift 点击存入物品,直接点击取出物品。每个终端会记住其搜索和排序设置,直到服务器重启。
- 磁盘安全:每张磁盘拥有唯一 ID 并记录制造者信息。管理员可以找回丢失的磁盘且其中的物品保持完整。
自动化功能
- 导入器:从箱子、 barrel、漏斗、熔炉、酿造台等容器中抽取物品到网络中。
- 导出器:将过滤器内的物品推送出去,并可分别针对熔炉燃料槽和输入槽,以及酿造台的各个槽位进行目标投放。
- 经验瓶灌装:放置在熔炉上的导入器可将熔炉中储存的经验值转化为附魔之瓶,并从网络中使用玻璃瓶进行填充。
- 桶排放:导入器可以从熔炉燃料槽中抽取空桶。
安全机制
- 安全终端:可将网络锁定为你本人及你信任的玩家,并分别设置访问权限和建设权限。
- 领地插件兼容:WorldGuard、GriefPrevention、Towny 及其他领地插件开箱即用,得到原生支持。
- 加固优化:经过防复制与物品丢失审计,已在 1.21.x 和 26.1 版本上使用自动化客户端测试,并在 26.2 和 26.3 版本上进行启动测试。
生活质量改进
-
可选资源包:为 MSS 物品以及已放置的服务器、驱动器舱、终端和安全终端提供自定义模型。该资源包随 JAR 文件一同分发。导入器和导出器保留其头部纹理。
-
铁扳手:按住 Shift 并右键点击可拾取任意 MSS 方块。启用资源包后,右键点击可旋转服务器、驱动器舱或终端。
-
电缆管道:启用资源包后,提供具备连接感知功能的可选电缆管道。
-
原版合成表:所有物品均可在合成台中合成,并在通过 /recipe give <玩家> <配方> 解锁后显示于配方书中。每个配方均可在 recipes.yml 中进行配置。
-
可翻译:每条消息都位于 lang/en_US.yml 中。


- 制作一个 存储服务器 并放置。它是控制器,每个网络中恰好有一个。
- 将其相邻放置一个 硬盘柜 并插入存储磁盘。
- 将 终端 放置在网络上,右键点击它以打开你的存储空间。
- 使用 PoE 线缆 连接更远的方块,然后将 导入器 和 导出器 安装在容器的顶部或侧面。
管理员可以使用 /mss recipes 命令列出游戏中所有的合成配方。


你可以直接合成磁盘,或者使用对应层级的磁盘外壳和磁盘盘片来组装它们。每个磁盘的工具提示中都会显示其层级、已使用的单元格以及制造者。按住 Shift 并右键点击空磁盘可以将其分解回原材料。

将导入器或导出器连接到容器上,并通过 PoE 电缆将其接入网络,然后右键点击以设置过滤器。未设置过滤器的导入器会拉取所有物品;而导出器只会推送过滤器中指定的物品。
| 容器 |
导入器 |
导出器 |
| 箱子、桶、漏斗、潜影盒等 |
将物品拉入网络 |
将过滤后的物品推出 |
| 熔炉、高炉、烟熏炉 |
拉取输出物,可选配置经验瓶收集和桶排功能 |
分别设置燃料和输入物品的过滤器 |
| 酿造台 |
从三个瓶子槽位中拉取物品;为每个槽位设置过滤器以仅提取成品药水 |
分别设置原料、燃料和瓶子的过滤器 |

- 未安装安全终端的网络是向所有人开放的。放置一个安全终端可将网络锁定为仅你和受信任的玩家使用,并分别设置开启 MSS 方块以及在网络上建造的权限。
- 当启用
permissions.respect_claims(默认值)时,使用 MSS 方块需要所在位置的建造权限,且任何人无法将线缆接入他们无法建造的领地中的网络,也无法在该领地上安装导入器或导出器。此功能可与任何保护方块不被破坏的领地插件配合使用。
- 拥有管理员权限(Ops)或持有
mss.admin 权限的玩家可绕过网络安全限制。

Oraxen、ItemsAdder 和 Nexo 在音符块上构建自定义方块,MSS 资源包同样如此。MSS 会检测它们并进行适配:
- Coexist(默认):MSS 不再自行使用音符盒,并保留其放置的方块为原版状态。启用资源包后,其物品模型将归入该插件的资源包中。
- Blocks(实验性):MSS 还会向该插件注册其四种立方体方块,因此已放置的 MSS 方块也会获得自定义外观。在首次启动后,请运行一次该插件的重载命令。
这两种模式均基于各插件的公开 API 构建,但尚未在实际使用的插件中进行测试。如果遇到任何行为异常,请报告。


- 服务器软件:Spigot、Paper、Purpur、Pufferfish 以及其他 Paper 分支。
- Minecraft:1.21 至 26.3(来自单个 jar 文件)。1.21.x 服务器需 Java 21,26.x 需 Java 25。
- 数据库:SQLite(默认,零配置)或 MySQL。MariaDB 应该可用,但未经过测试。使用
/mss migratedb 可在不丢失数据的情况下切换后端。
- 已测试版本:Paper 1.21、1.21.11、26.1.2、26.2 和 26.3,以及 Spigot 1.21.1、1.21.11、26.1.2、26.2 和 26.3。
- 不支持将现有数据库从 Paper 迁移到 Spigot。但从 Spigot 迁移到 Paper 是可以的。

除 /mss help 外,所有命令都需要 modularstoragesystem.admin 权限,而 /mss recovery 需要 modularstoragesystem.recovery 权限。
| 命令 |
描述 |
/mss help |
显示帮助菜单 |
/mss give <item> [player] |
给予一个 MSS 物品 |
/mss info |
显示插件和存储统计信息 |
/mss recipes |
列出所有配方 |
/mss recipe <name> |
显示某个配方 |
/mss reload [config, recipes, lang or all] |
重载配置、消息和资源包 |
/mss recovery <disk_id> |
恢复丢失的存储磁盘 |
/mss cleanup |
移除孤立的数据 |
/mss migratedb <sqlite or mysql> [confirm] |
用另一个后端的数据替换当前活动的数据库 |
/mss convert [confirm] |
在启用或禁用资源包后更新已放置的方块 |
/mss give 可使用的物品:server、bay、terminal、security、cable、exporter、importer、wrench、housing、platter1k、platter4k、platter16k、platter64k、disk1k、disk4k、disk16k、disk64k。

| 权限 |
默认值 |
授予 |
modularstoragesystem.admin |
Op |
管理命令 |
mss.admin |
Op |
绕过网络安全 |
modularstoragesystem.recovery |
Op |
/mss recovery |
modularstoragesystem.bypass_cooldown |
Op |
跳过命令和菜单冷却时间 |
modularstoragesystem.use |
Everyone |
使用 MSS 方块(当 permissions.require_use_permission 开启时) |
modularstoragesystem.craft |
Everyone |
合成 MSS 物品(当 permissions.require_craft_permission 开启时) |
mss.craft.<item> 和 mss.use.<item> |
Everyone |
按物品控制,支持 mss.craft.* 和 mss.use.* 通配符 |
两个 require 选项默认均为关闭状态。按物品的节点始终生效,因此拒绝其中一个会阻止非 OP 玩家使用该物品。





更多图片请参阅 画廊。

- 发现了错误或有新想法?请在 GitHub 上提交 Issue。
- 请包含你的服务器软件和版本、MSS 版本,以及控制台中的任何错误日志。
- 更新前请备份
plugins/ModularStorageSystem。数据库会在启动时自动升级。

Modular Storage System (MSS) brings mod style network storage to your server. Build a network out of custom blocks, store hundreds of thousands of items on tiered disks, find anything from a single terminal, and move items in and out of chests, furnaces and brewing stands automatically. It is a server plugin: players need no mods and nothing to install.
One jar runs on Spigot, Paper and Paper forks, Minecraft 1.21 to 26.3.
Source code | Report an issue | Changelog

Storage
- Network storage: link a Storage Server, Drive Bays and Terminals with PoE Cables. Up to 128 blocks and 800 cables per network, all configurable.
- Four disk tiers: 1k, 4k, 16k and 64k disks hold up to 520,192 items each. Disks are hot swappable and recycle into their parts when empty.
- Terminals: search, sort by name or quantity, shift click to deposit, click to withdraw. Each terminal remembers its search and sort until the server restarts.
- Disk safety: every disk has a unique id and records who crafted it. Admins can recover a lost disk with its contents intact.
Automation
- Importers pull items from chests, barrels, hoppers, furnaces, brewing stands and more into the network.
- Exporters push the items in their filter out, and target furnace fuel and input slots or brewing stand slots separately.
- XP bottling: an importer on a furnace turns the furnace's stored XP into Bottles o' Enchanting, using glass bottles from the network.
- Bucket ejection: importers can pull empty buckets out of furnace fuel slots.
Security
- Security Terminal: lock a network to you and the players you trust, with separate access and build permissions.
- Claim plugins: WorldGuard, GriefPrevention, Towny and other claim plugins are respected out of the box.
- Hardened: audited for duplication and item loss, tested with automated clients on 1.21.x and 26.1, and boot tested on 26.2 and 26.3.
Quality of life
- Optional resource pack with custom models for MSS items and for the placed Server, Drive Bay, Terminal and Security Terminal. It ships inside the jar. Importers and exporters keep their head textures.
- Iron Wrench: shift and right click picks up any MSS block. With the resource pack on, right click rotates a Server, Drive Bay or Terminal.
- Cable pipes: optional connection aware cables when the resource pack is on.
- Vanilla recipes: everything crafts at a crafting table and shows in the recipe book once unlocked with
/recipe give <player> <recipe>. Every recipe is configurable in recipes.yml.
- Translatable: every message lives in
lang/en_US.yml.


- Craft a Storage Server and place it. It is the controller, and each network has exactly one.
- Place a Drive Bay touching it and insert storage disks.
- Place a Terminal touching the network and right click it to open your storage.
- Use PoE Cables to reach blocks further away, then attach Importers and Exporters to containers, on top or on a side.
Admins can list every recipe in game with /mss recipes.


Craft disks directly, or assemble them from a Disk Housing and a Platter of the matching tier. Each disk shows its tier, used cells and crafter in its tooltip. Shift and right click an empty disk to recycle it into its parts.

Attach an Importer or Exporter to a container, connect it to the network with a PoE Cable, then right click it to set filters. An importer with no filter pulls everything. An exporter only pushes what is in its filter.
| Container |
Importer |
Exporter |
| Chests, barrels, hoppers, shulker boxes and others |
Pulls items into the network |
Pushes filtered items out |
| Furnaces, blast furnaces, smokers |
Pulls the output, with optional XP bottling and bucket ejection |
Separate fuel and input filters |
| Brewing stands |
Pulls from the three bottle slots; set a filter per slot to take only finished potions |
Separate ingredient, fuel and bottle filters |

- A network without a Security Terminal is open to everyone. Place one to lock the network to you and your trusted players, with separate permissions for opening MSS blocks and for building on the network.
- With
permissions.respect_claims on (the default), using an MSS block needs build access where it stands, and nobody can cable into a network or attach an importer or exporter on land they can't build on. This works with any claim plugin that protects blocks from breaking.
- Ops, or anyone with
mss.admin, bypass network security.

Oraxen, ItemsAdder and Nexo build their custom blocks on note blocks, and so does the MSS resource pack. MSS detects them and adapts:
- Coexist (default): MSS stops using note blocks itself and keeps its placed blocks vanilla. With the resource pack on, its item models go into that plugin's resource pack.
- Blocks (experimental): MSS also registers its four cube blocks with that plugin, so placed MSS blocks get their custom look too. Run that plugin's reload once after the first start.
Both modes are built on each plugin's public API but have not been tested with the real plugins yet. Please report anything that misbehaves.


- Server software: Spigot, Paper, Purpur, Pufferfish and other Paper forks.
- Minecraft: 1.21 to 26.3 from one jar. Java 21 for 1.21.x servers, Java 25 for 26.x.
- Database: SQLite (default, zero setup) or MySQL. MariaDB should work but is untested. Switch backends without losing data using
/mss migratedb.
- Tested on Paper 1.21, 1.21.11, 26.1.2, 26.2 and 26.3, and Spigot 1.21.1, 1.21.11, 26.1.2, 26.2 and 26.3.
- Moving an existing database from Paper to Spigot is not supported. Spigot to Paper works.

Every command except /mss help needs modularstoragesystem.admin, and /mss recovery needs modularstoragesystem.recovery.
| Command |
Description |
/mss help |
Show the help menu |
/mss give <item> [player] |
Give an MSS item |
/mss info |
Show plugin and storage statistics |
/mss recipes |
List all recipes |
/mss recipe <name> |
Show one recipe |
/mss reload [config, recipes, lang or all] |
Reload configuration, messages and the resource pack |
/mss recovery <disk_id> |
Recover a lost storage disk |
/mss cleanup |
Remove orphaned data |
/mss migratedb <sqlite or mysql> [confirm] |
Replace the active database with the other backend's data |
/mss convert [confirm] |
Update placed blocks after turning the resource pack on or off |
Items for /mss give: server, bay, terminal, security, cable, exporter, importer, wrench, housing, platter1k, platter4k, platter16k, platter64k, disk1k, disk4k, disk16k, disk64k.

| Permission |
Default |
Grants |
modularstoragesystem.admin |
Op |
Admin commands |
mss.admin |
Op |
Bypassing network security |
modularstoragesystem.recovery |
Op |
/mss recovery |
modularstoragesystem.bypass_cooldown |
Op |
Skipping command and menu cooldowns |
modularstoragesystem.use |
Everyone |
Using MSS blocks, when permissions.require_use_permission is on |
modularstoragesystem.craft |
Everyone |
Crafting MSS items, when permissions.require_craft_permission is on |
mss.craft.<item> and mss.use.<item> |
Everyone |
Per item control, with mss.craft.* and mss.use.* wildcards |
Both require options are off by default. The per item nodes always apply, so denying one blocks that item for everyone without op.





More in the gallery.

- Found a bug or have an idea? Open an issue on GitHub.
- Please include your server software and version, the MSS version, and any errors from the console.
- Back up
plugins/ModularStorageSystem before updating. The database upgrades itself on start.
评论 0
登录后参与评分
还没有评论,来抢沙发吧