Numerical Item IDs

Overview ​

Item IDs (not to be confused with type IDs) are an older system which are mainly used to render items with JSON UI nowadays. All items & blocks (Even custom ones!) have their own unique ID.

ID Formatting ​

• Vanilla items & blocks have IDs from -1198 to 879.
• Vanilla IDs from -1198 to 849 are stable: custom add-on items do not shift them. The runtime texture slot for an item with raw ID n in this range is simply n * 65536.
• Vanilla IDs from 850 to 879 are shifted upward by the number of custom add-on items registered before them in the resource-pack stack. The 30 items currently in this range are all the spears, all the bundles, breeze_rod, ominous_trial_key, trial_key, wind_charge, apple, glow_berries. At runtime, an item whose raw ID is n in this range is rendered at (n + customItemCount) * 65536.
• If the world has more than 1569 custom items, the shift saturates at 1569 custom items. The first 1569 custom items, in resource-pack stack order, claim slots 850..2418, pushing the 30 vanilla items originally at 850..879 to slots 2419..2448. Any additional custom items (1570 and beyond) are inserted at slots >= 2449 and no longer push vanilla IDs higher.
• All custom items take slots in the same ID space as vanilla items, in resource-pack stack order. Effectively, each custom item claims the next free slot starting from 850, pushing the vanilla item that previously occupied that slot up by one position, until the 1569-item saturation is reached.
• The Experimental Fall Drop 2026 world-settings toggle enables two upcoming items: red_shrub (raw ID 850) and shelf_mushroom (raw ID 851). When this toggle is on, both items are inserted as if they were custom add-on items, which shifts every vanilla item with raw ID 850..879 up by 2 (so copper_spear moves to 852, ..., glow_berries moves to 881).

Vanilla ID List ​

Note for this list that a namespace of minecraft: is assumed for all items & blocks.