InventoryObject

Exposes normalized player inventory sections and items through player.inventory. Its ItemObject values provide item properties and version-dependent NBT data.

player.inventory provides the selected mainhand item, offhand item, hotbar, main inventory, and armor. Items are represented by ItemObject values even when originally read from older versions of Minecraft.

InventorySection also supports specific membership checks such as 'diamond_sword' in player.inventory.hotbar. player.inventory itself can be iterated, tested for membership, or queried through the following methods.

View the source: InventoryObject

Methods

player.inventory.items()

Returns a list of valid ItemObject instances in the inventory. InventorySection.items() returns an iterator

player.inventory.find(item_id)

Returns a list of items whose ID matches item_id, or [] if none

player.inventory.count(item_id=None)

Counts the total quantity of an item (if item_id is str), the combined quantity of several items (if item_id is a list / tuple of str), or the total number of all items when unspecified. Returns int of the count

player.inventory.give(item, preserve_slot=False)

Gives the connected player an ItemObject, retaining item metadata supported by that Minecraft version. To place it in its original slot, set preserve_slot=True (Minecraft 1.8 or later). This complements ItemObject.take()

player.inventory.clear()

Clears the online player’s inventory. The target player must still be connected for give() and clear() to work

Attributes

Attribute	Type	Description
player.inventory.selected_item	ItemObject	Item currently held in the main hand
player.inventory.offhand	ItemObject	Item currently held in the offhand
player.inventory.hotbar	InventorySection	Slots 0–8; supports indexing, iteration, items(), find() and count()
player.inventory.inventory	InventorySection	Main inventory, slots 0–26
player.inventory.armor	InventorySection	Slots head, chest, legs, and feet

Examples

Item transfer example:

# Transfer every item from one player's inventory to another
player_1 = server.get_player('player_1')
player_2 = server.get_player('player_2')

for item in player_1.inventory:
    player_2.inventory.give(item.take())

Caution

Make sure both players are connected before modifying inventory data. The command syntax and supported NBT formats differ between Minecraft versions; older versions cannot preserve every item property, and the abstraction cannot guarantee that every raw NBT field transfers unchanged.