Compatibility
Minecraft: Java Edition
1.20.5–1.20.6
Platforms
Supported environments
Creators
Details
Licensed Apache-2.0
Published 3 months ago
Updated last week
Changelog
A new year, a new preview! In this preview the item holder rules were split into their own data component with a minor change to the rules themselves.
Changes
Item Behaviour Components
minecraft:item_holder
- Rules are now modifiable for indivial item stacks with the
minecraft:item_holder_rulesdata component instead of being part ofminecraft:bundle_contents. - All item holders now use the same default
minecraft:bundle_contentsdata component again.
Data Components
- Added the following data components:
minecraft:item_holder_rules
minecraft:bundle_contents
- Reverted the component to its previous form by moving the rules to their own data component.
minecraft:item_holder_rules
- Specified and used by the
minecraft:item_holderbehaviour component. - If removed, the item holder behaviour will no longer work.
- Its value is a list of item holder rules.
Example:
[
{
"type": "minecraft:reject",
"condition": {
"items": "#minecraft:banned_bundle_items"
}
},
{
"type": "minecraft:occupancy_held_items_with_penalty",
"condition": {
"behavior": [
"minecraft:item_holder"
]
},
"penalty": {
"denominator": 16,
"numerator": 1
}
},
{
"type": "minecraft:fraction",
"condition": {
"data_components": [
"minecraft:bees"
]
},
"fraction": {
"denominator": 1,
"numerator": 1
}
}
]
Item Holder Rules
- Renamed the
minecraft:fraction_with_occupancy_held_itemstype tominecraft:occupancy_held_items_with_penalty.- The
fractionfield was also renamed topenaltyto show the use of the field more.
- The
So if you had this:
{
"type": "minecraft:fraction_with_occupancy_held_items",
"fraction": {
"denominator": 16,
"numerator": 1
}
}
You now have to use this instead:
{
"type": "minecraft:occupancy_held_items_with_penalty",
"penalty": {
"denominator": 16,
"numerator": 1
}
}
Fixes
- Updating the item holder rules retains the old rules on item stacks that already have contents (#54)
Dependencies
Files
Metadata
Release channel
BetaVersion number
0.3.0-preview.3Loaders
Game versions
1.20.5–1.20.6Environment
Client and server, required on both
Downloads
5Publication date
January 5, 2026 at 10:48 PMPublisher
ErrorCraft
Member


