Kzeroko KTM2

Starter satchel data

Define shared supplies and complete starting outfits for a class satchel.

Updated Nov 5, 2026 2 min read

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

FieldTypeDefaultMeaning
suppliesarray<object>requiredShared stacks awarded with any choice. May be empty.
presetsarray<object>requiredBetween 1 and 5 selectable outfits, in display order. Choose one.
presets[].ididentifierrequiredUnique within this bag. Supplies the translation stem lootbag.<namespace>.<path> for the .title and .description keys.
presets[].iconobjectrequiredExactly one of item or texture. Item icons use the item’s GUI model and lighting.
presets[].icon.itemidentifierabsentRequired when texture is absent. Registered item; air is invalid.
presets[].icon.nbtstringabsentSNBT compound for the displayed item, including custom model data. Only valid with item; does not change the awarded stacks.
presets[].icon.textureidentifierabsentRequired when item is absent. Artwork path including textures/ and .png.
presets[].colorstringrequiredCard accent in #RRGGBB.
presets[].itemsarray<object>requiredAt least one stack. All entries are delivered together.
itemidentifierrequiredRegistered item for either stack list. Air is invalid.
countinteger11–64 items. Quantities above the item’s stack limit split across stacks.
nbtstringabsentSNBT 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.

Start here · Spell catalog