Slot Sources

A slot source selects inventory slots: the slots of an entity or a block entity, the items stored inside an item, or a filtered, limited or merged mix of them. The same builders are used in four places:

Several sources in one block are concatenated. A slot source file is written as one object (several sources are wrapped in a group), a field takes a single source as an object and several as an array.

Reference: Slot source

Slot Source Files

slotSource writes data/<namespace>/slot_source/<name>.json and returns its SlotSourceArgument:

val hands = slotSource("hands") {
	slotRange(WEAPON.all())
}

{
	"type": "minecraft:slot_range",
	"slots": "weapon.*"
}

A file is always one source object. Several sources, or a lone reference, are written as a group, which Kore does for you: slotSource("alias") { reference(hands) } is written as

{
	"type": "minecraft:group",
	"terms": "<namespace>:hands"
}

Another slot source points to a file with reference(hands), which writes the bare string "<namespace>:hands", see Reference. A slotSource { } without any source throws when the pack is generated, empty() selects no slot.

In Commands

/item and /execute if items|slots take a SlotsArgument, which is one of:

• a slot or a range, written as a slot string: ARMOR.CHEST is armor.chest, HOTBAR and HOTBAR.all() are hotbar.*;
• a slot source file, like hands above;
• an inline slot source, inlineSlotSource { ... }, written as SNBT. A lone reference(hands) is the quoted ID: item fill entity @s "my_pack:hands" with minecraft:stone.

function("give_kit") {
	items.fill(self(), HOTBAR, Items.BREAD) // item fill entity @s hotbar.* with minecraft:bread
	items.override(self(), hands, Items.STONE_SWORD) // item override entity @s my_pack:hands with minecraft:stone_sword

	execute {
		ifCondition { slots(self(), inlineSlotSource { slotRange(ARMOR) }) }
		run { say("Wearing armor") }
	}
}

items.replace, items.fill and items.override spread the source items over the destination slots differently, here with destination slots [12345] and source items (ABC):

/execute if slots counts the selected slots that exist on the target, /execute if items the selected slots whose item matches the predicate. Slot sources used by commands are evaluated with the command_slot_source loot context.

Slot Source Types

Slot Range

Selects the slots of a slot string from an inventory. Without an origin, it reads the loot context's container: the target of the command, or the inventory a loot table runs on.

slotSources {
	// Every hotbar slot of the context's container
	slotRange(HOTBAR)

	// One slot of the block entity
	slotRange(SlotSourceOrigin.BLOCK_ENTITY, ARMOR.HEAD)

	// A raw slot string from the looting entity
	slotRange(SlotSourceOrigin.THIS, "container.*")
}

Available origins: ATTACKING_ENTITY, BLOCK_ENTITY, CONTAINER, DIRECT_ATTACKER, INTERACTING_ENTITY, LAST_DAMAGE_PLAYER, TARGET_ENTITY, THIS.

Contents

Selects the slots stored in the inventory component of the items selected by slotSource:

slotSources {
	contents(InventoryComponentType.CONTAINER) {
		slotSource {
			slotRange(SlotSourceOrigin.BLOCK_ENTITY, "container.*")
		}
	}
}

Available component types: BUNDLE_CONTENTS, CHARGED_PROJECTILES, CONTAINER.

Empty

An empty selection containing no slots:

slotSources {
	empty()
}

Filtered

Keeps only the selected slots whose item matches itemFilter:

slotSources {
	filtered {
		slotSource {
			slotRange(SlotSourceOrigin.THIS, HOTBAR)
		}

		itemFilter {
			count = rangeOrInt(16..64)
		}
	}
}

Group

Merges several slot sources into one:

slotSources {
	group {
		slotRange(SlotSourceOrigin.THIS, HOTBAR)
		empty()
	}
}

Limit Slots

Keeps the first limit selected slots:

slotSources {
	limitSlots(5) {
		slotSource {
			slotRange(SlotSourceOrigin.THIS, HOTBAR)
		}
	}
}

Reference

Selects the slots of a slot source file, written as its bare ID. reference(id) takes the SlotSourceArgument returned by slotSource, or a SlotSourceTagArgument to select the slots of every source of a tag:

slotSources {
	reference(hands)  // "my_pack:hands"
}

slotSource("hands_and_hotbar") {
	reference(hands)
	slotRange(SlotSourceOrigin.THIS, HOTBAR)  // { "type": "minecraft:group", "terms": ["my_pack:hands", {"type": "minecraft:slot_range", ...}] }
}

slotSource("armor") {
	reference(SlotSourceTagArgument("armor_slots", "my_pack"))  // { "type": "minecraft:group", "terms": "#my_pack:armor_slots" }
}

Every slot_source field (contents, filtered, limitSlots, the slots loot entry), the terms of a group and an inline slot source accept an ID, a tag, an inline source or a list mixing IDs and inline sources. A tag can't be one of the list's elements, only the whole list. A slot source file doesn't: it is always an object.

A slot source that references itself, directly or through other files, makes the pack fail to load.

See Also

• Loot Tables - The slots entry
• Execute - The items and slots conditions