Starter satchel data
Define shared supplies and complete starting outfits for a class satchel.
When a traveler reaches the world below, their class satchel offers one outfit to take alongside its provisions. Keep a wand and its inscribed book together in the same outfit.
Where the files live
Each file under data/<namespace>/lootbags/<path>.json defines one bag. The caster item reads isekaiexpansion:starterkits/magic_caster_starterkit. Higher-priority packs replace the whole file.
Minimal example
{
"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}"
}
]
}
]
}
Fields
| Field | Type | Default | Meaning |
|---|---|---|---|
supplies | array<object> | required | Shared stacks awarded with any choice. May be empty. |
presets | array<object> | required | Between 1 and 5 selectable outfits, in display order. Choose one. |
presets[].id | identifier | required | Unique within this bag. Supplies the translation stem lootbag.<namespace>.<path> for the .title and .description keys. |
presets[].icon | object | required | Exactly one of item or texture. Item icons use the item’s GUI model and lighting. |
presets[].icon.item | identifier | absent | Required when texture is absent. Registered item; air is invalid. |
presets[].icon.nbt | string | absent | SNBT compound for the displayed item, including custom model data. Only valid with item; does not change the awarded stacks. |
presets[].icon.texture | identifier | absent | Required when item is absent. Artwork path including textures/ and .png. |
presets[].color | string | required | Card accent in #RRGGBB. |
presets[].items | array<object> | required | At least one stack. All entries are delivered together. |
item | identifier | required | Registered item for either stack list. Air is invalid. |
count | integer | 1 | 1–64 items. Quantities above the item’s stack limit split across stacks. |
nbt | string | absent | SNBT compound copied onto each stack, including inscribed spells. |
Validation
A missing item, malformed compound, duplicate preset ID, empty outfit, or invalid colour disables the affected bag and logs its file. The icon must be an object; mixed item/artwork fields and unknown icon fields also reject the bag. Trying to open it leaves it in hand.
Reloading
After a data reload, reopen any outstanding offer. The server checks the held bag and personal isekaiexpansion:chapter_01/departed milestone at claim time. Overflow drops beside the player.
Item icons follow resource-pack models and keep their appearance NBT. Captured models follow card clipping, scaling and fading, and refresh when client resources reload.