启程行囊数据
为职业行囊配置通用补给与可选的成套行装。
旅人踏上尘世后,可以打开职业行囊,领一套行装和随行补给。将魔杖与刻有相应法术的书放在同一套行装内。
文件放在哪里
每个行囊在 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}"
}
]
}
]
}
字段
| 字段 | 类型 | 默认值 | 用途 |
|---|---|---|---|
supplies | array<object> | 必填 | 随任意选择发放的物品堆,可为空。 |
presets | array<object> | 必填 | 按展示顺序列出 1 至 5 套行装,只能选一套。 |
presets[].id | identifier | 必填 | 同一行囊内唯一。名称和介绍的翻译键以 lootbag.<namespace>.<path> 开头,分别追加 .title 和 .description。 |
presets[].icon | object | 必填 | item 与 texture 必须且只能填一个。物品图标使用对应的 GUI 模型和光照。 |
presets[].icon.item | identifier | 无 | 未填 texture 时必填。须为已注册物品,不能填空气。 |
presets[].icon.nbt | string | 无 | 展示物品使用的 SNBT 复合标签,可含自定义模型数据。仅适用于 item,不影响实际发放的物品堆。 |
presets[].icon.texture | identifier | 无 | 未填 item 时必填。插画纹理路径,包含 textures/ 与 .png。 |
presets[].color | string | 必填 | 卡片强调色,格式为 #RRGGBB。 |
presets[].items | array<object> | 必填 | 至少一项,整组一并发放。 |
item | identifier | 必填 | 两种物品列表均使用已注册物品,不能填空气。 |
count | integer | 1 | 数量为 1–64,超过单堆上限会分堆发放。 |
nbt | string | 无 | 复制到各物品堆的 SNBT 复合标签,可含已刻录法术。 |
校验
物品缺失、复合标签无效、方案 ID 重复、行装为空或颜色格式有误,均会停用对应行囊并记录文件名。图标必须填写为对象;混用物品与插画字段,或填写未知的图标字段,也会使整个行囊加载失败。尝试打开时,行囊仍留在手中。
重载
数据重载后须重新打开行囊。服务器在领取时检查手持行囊和个人的 isekaiexpansion:chapter_01/departed 里程碑。背包放不下的物品会掉落在玩家身旁。
物品图标采用资源包提供的模型,并保留外观 NBT。模型截图随卡片一起裁切、缩放和淡入淡出,客户端资源重载后会重新生成。