红米的插件文档

Appearance

储物袋配置 ​

储物袋配置文件放在：

text
plugins/RedmiStorageBag/储物袋配置/

你可以在这个目录里新建多个 .yml 或 .yaml 文件，方便把不同类型的储物袋分开管理。

配置示例 ​

yaml
基础储物袋:
  物品匹配:
    Name: "§e基础储物袋"
    Lore: "§7右键打开"
    ItemID: ""
  行数: 3
  格子数: 18

上面的配置表示：

  • 物品名称必须是 §e基础储物袋；
  • 物品任意一行 Lore 中要包含 §7右键打开；
  • 打开后显示 3 行界面；
  • 其中前 18 格可以存放物品，其余格子显示为未开启。

物品匹配 ​

插件可以按物品名称、Lore 内容和红米物品 ID 识别储物袋。

不需要的匹配项可以留空，但至少要填写一项。

按名称匹配 ​

yaml
物品匹配:
  Name: "§e基础储物袋"

物品名称必须和配置完全一致，包括颜色代码。

按 Lore 匹配 ​

yaml
物品匹配:
  Lore: "§7右键打开"

插件会逐行检查物品 Lore，只要其中一行包含这段文字就能匹配，不要求整行完全一样。

按红米物品 ID 匹配 ​

如果储物袋由 RedmiAssyLib 的物品系统生成，可以直接填写物品 ID：

yaml
物品匹配:
  ItemID: "[rm]基础储物袋"

[rm] 是固定前缀，不能省略。

同时填写多个条件 ​

如果同时填写了多个条件，物品需要全部符合。

例如：

yaml
物品匹配:
  Name: "§e基础储物袋"
  Lore: "§7右键打开"
  ItemID: "[rm]基础储物袋"

此时名称、Lore 和红米物品 ID 都要正确。

注意

如果 Name、Lore、ItemID 全部留空，这条配置会被插件拒绝加载，防止所有物品都被误认为储物袋。

设置行数和格子数 ​

yaml
行数: 3
格子数: 18

行数 ​

行数决定储物袋界面的大小，可以填写 1 到 6。

每行有 9 个格子：

行数界面总格数
19
218
327
436
545
654

格子数 ​

格子数决定实际开放多少个存储格。

例如：

yaml
行数: 3
格子数: 18

界面一共有 27 格，其中：

  • 前 18 格可以存放物品；
  • 后 9 格显示 config.yml 中配置的未开启物品；
  • 未开启的格子不能放入或取出物品。

如果不填写 格子数，默认会开放当前界面的全部格子。

范围限制

格子数最少为 1，最多不能超过 行数 × 9，插件总容量上限为 54 格。

多种储物袋 ​

一个文件中可以配置多个储物袋：

yaml
小型储物袋:
  物品匹配:
    Name: "§a小型储物袋"
  行数: 2
  格子数: 9

大型储物袋:
  物品匹配:
    Name: "§6大型储物袋"
  行数: 6
  格子数: 54

也可以拆成多个文件：

text
储物袋配置/
├─ 基础储物袋.yml
├─ 活动储物袋.yml
└─ 高级储物袋.yml

修改完成后使用：

text
/rmsbag reload

新储物袋和旧储物袋的区别 ​

玩家第一次右键一件还不是储物袋的物品时，插件才会按这里的条件进行匹配。

匹配成功后，插件会把以下信息写入物品：

  • 独立 UUID；
  • 界面行数；
  • 可用格子数；
  • 储物内容。

物品成功变成储物袋后，行数、容量和内容都会保存在物品自身的数据里。以后再次打开时，不会重新套用配置文件。

因此，修改配置中的行数或格子数后：

  • 新初始化的储物袋使用新配置；
  • 已经使用过的储物袋保持原来的大小；
  • 已有储物袋不会因为重载配置而被缩容或清空。

常见配置错误 ​

物品没有反应 ​

请检查：

  • 名称和颜色代码是否完全一致；
  • Lore 是否确实存在；
  • ItemID 是否带有 [rm] 前缀；
  • 是否至少填写了一种匹配条件；
  • 修改配置后是否执行了 /rmsbag reload。

提示配置异常 ​

可能存在以下问题：

  • 多个储物袋配置同时匹配了同一件物品；
  • 行数不在 1–6 之间；
  • 格子数大于 行数 × 9；
  • 红米物品 ID 写法错误。

发生配置错误时，控制台会显示对应的文件名、配置名称和错误原因。