MatrixStorage

MatrixStorage 是 Matrix 系列的统一仓储插件，围绕邮箱、个人仓库、待收区、实体仓库和 MatrixShop 外部投递工作。

文档	Release Notes	Releases	依赖
Docs	1.1.0	GitHub Releases	MatrixLib 1.5.0

当前发布

• 当前版本：1.1.0
• 必需前置：MatrixLib 1.5.0
• 后端支持：sqlite / mysql / redis / yaml
• 可选集成：MatrixShop / Vault / CraftEngine / ItemsAdder / Nexo

功能定位

• 玩家邮箱
• 个人仓库与待收区
• 仓库 / 邮箱格子解锁
• 位置型实体仓库
• MatrixShop 外部仓库投递对接
• CraftEngine / ItemsAdder / Nexo 自定义方块与家具接入

bStats 遥测

• Plugin ID: 30559
• 遥测通过 MatrixLib 的 MatrixBStats API 注册

当前图表：

Chart ID	类型	含义
storage_backend	SimplePie	当前仓储状态后端
matrixshop_bridge	SimplePie	MatrixShop 桥接是否就绪
warehouse_definition_count	SingleLineChart	已加载仓库定义数量
mailbox_count	SingleLineChart	当前邮箱消息数量
block_warehouse_count	SingleLineChart	当前实体仓库数量
warehouse_definition_sources	AdvancedPie	仓库定义来源分布

预留图表位：

预留 Chart ID	计划用途
unlock_rule_count	统计邮箱 / 仓库扩容规则数量
placement_mode_distribution	统计 terminal / location 模式分布
pending_delivery_target	统计待收区 / 邮箱投递分布

自动更新

MatrixStorage 当前接入 MatrixLib 的共享更新器。

• 检查：/matrixlib update check MatrixStorage
• 审批下载：/matrixlib update approve MatrixStorage
• 更新包下载到 plugins/update/

稳定 API 命名空间

MatrixStorage 当前新增稳定公开层：

• com.y54895.matrixstorage.api
• com.y54895.matrixstorage.api.model

文档入口

• 概览
• 1.1.0 发布说明
• bStats 与遥测
• Matrix 插件总文档入口