Kzeroko KTM2

启程行囊数据

为职业行囊配置通用补给与可选的成套行装。

更新于 2026/11/5 3 分钟阅读

旅人踏上尘世后,可以打开职业行囊,领一套行装和随行补给。将魔杖与刻有相应法术的书放在同一套行装内。

文件放在哪里

每个行囊在 data/<namespace>/lootbags/<path>.json 下对应一个文件。魔法吟唱者行囊读取 isekaiexpansion:starterkits/magic_caster_starterkit。高优先级数据包替换整个文件。

最小示例

{
  "supplies": [
    {
      "item": "minecraft:bread",
      "count": 4
    }
  ],
  "presets": [
    {
      "id": "isekaiexpansion:traveler",
      "icon": { "item": "minecraft:stone_sword" },
      "color": "#CFA36C",
      "items": [
        {
          "item": "minecraft:stone_sword",
          "nbt": "{Damage:0}"
        }
      ]
    }
  ]
}

字段

字段类型默认值用途
suppliesarray<object>必填随任意选择发放的物品堆,可为空。
presetsarray<object>必填按展示顺序列出 1 至 5 套行装,只能选一套。
presets[].ididentifier必填同一行囊内唯一。名称和介绍的翻译键以 lootbag.<namespace>.<path> 开头,分别追加 .title 和 .description。
presets[].iconobject必填item 与 texture 必须且只能填一个。物品图标使用对应的 GUI 模型和光照。
presets[].icon.itemidentifier无未填 texture 时必填。须为已注册物品,不能填空气。
presets[].icon.nbtstring无展示物品使用的 SNBT 复合标签,可含自定义模型数据。仅适用于 item,不影响实际发放的物品堆。
presets[].icon.textureidentifier无未填 item 时必填。插画纹理路径,包含 textures/ 与 .png。
presets[].colorstring必填卡片强调色,格式为 #RRGGBB。
presets[].itemsarray<object>必填至少一项,整组一并发放。
itemidentifier必填两种物品列表均使用已注册物品,不能填空气。
countinteger1数量为 1–64,超过单堆上限会分堆发放。
nbtstring无复制到各物品堆的 SNBT 复合标签,可含已刻录法术。

校验

物品缺失、复合标签无效、方案 ID 重复、行装为空或颜色格式有误,均会停用对应行囊并记录文件名。图标必须填写为对象;混用物品与插画字段,或填写未知的图标字段,也会使整个行囊加载失败。尝试打开时,行囊仍留在手中。

重载

数据重载后须重新打开行囊。服务器在领取时检查手持行囊和个人的 isekaiexpansion:chapter_01/departed 里程碑。背包放不下的物品会掉落在玩家身旁。

物品图标采用资源包提供的模型,并保留外观 NBT。模型截图随卡片一起裁切、缩放和淡入淡出,客户端资源重载后会重新生成。

相关页面

入门指南 · 法术目录