Itematic 0.9.0 Preview 5 for 26.3
Curse Maven Snippet
What's new
Itematic 0.9.0 Preview 5 for 26.3
17th of November 2026
What do you mean Mojang added a data-driven dispense behaviour registry to 26.4?! It's enchantments all over again, but worse as this touches several systems in my mod... Oh well, it had to happen at some point; Glad it exists in vanilla now. Now I get to have extra fun when porting to 26.4.
This preview moves all of the remaining item behaviour to data components! This means that the item behaviour system now only provides data components, matching the entirety of vanilla once again ever since data components were introduced in 1.20.5.
Changes
- Removed the
minecraft:smithing_templateregistry and moved its elements to data-driven smithing template display assets on the client.
Item Behaviour
- Added the following item behaviour:
minecraft:glider_fuelminecraft:sign_modifier
- Renamed
minecraft:map_holdertominecraft:map_decoration_holderand made additional changes, present below. - Renamed
minecraft:smithing_template_providertominecraft:smithing_template_displayand made additional changes, present below. - Removed the following item behaviour:
minecraft:mappable- This behaviour has been moved to the new
minecraft:fill_mapitem modifier, similar to theminecraft:exploration_mapitem modifier. - So if you had this:
You now have to use this item modifier combined with the{ "minecraft:mappable": { "transforms_into": "minecraft:filled_map" } }minecraft:useitem event instead:[ { "type": "minecraft:split", "count": 1 }, { "type": "minecraft:set_item", "item": "minecraft:filled_map" }, { "type": "minecraft:fill_map", "position": "this", "zoom": 0 } ] - See the Item Modifiers section for more information on the
minecraft:fill_mapitem modifier type.
- This behaviour has been moved to the new
minecraft:unlock_recipes- This behaviour has been moved to the
minecraft:recipesdata component and would not provide a meaningful default value. - Instead, its data must be set on individual item stacks using the
minecraft:recipesdata component and its behaviour will work on that item stack automatically.
- This behaviour has been moved to the
minecraft:attack_blocking
- Made it so the
minecraft:blocks_attacksdata component this behaviour component provides determines the behaviour rather than the behaviour component itself, matching vanilla again.
minecraft:banner_pattern_holder
- Made it so the
minecraft:banner_patternsdata component this behaviour component provides determines the behaviour rather than the behaviour component itself, matching vanilla again. - Moved all of its recipe and Loom behaviour to the new
minecraft:banner_base_colordata component. - Renamed the
colorfield tobanner_base_color.- This matches with the new
minecraft:banner_base_colordata component.
- This matches with the new
- Now no longer provides a specialised translation key. Instead, the
minecraft:base_colordata component provides this translation key now, making it work on any item stack. - Now provides the new
minecraft:banner_base_colordata component if thebanner_base_colorfield is specified.
So if you had this:
{
"minecraft:banner_pattern_holder": {
"color": "orange"
}
}
You now have to use this instead:
{
"minecraft:banner_pattern_holder": {
"banner_base_color": "orange"
}
}
minecraft:brush
- Moved all of its behaviour to the new
minecraft:block_brusherdata component. - Its value is now also a
minecraft:block_brusherdata component. See the Data Components section for more information. - Now provides the new
minecraft:block_brusherdata component.
Example:
{
"minecraft:brush": {
"sweep_count": 10
}
}
minecraft:castable
- Moved all of its behaviour to the new
minecraft:castabledata component. - Its value is now also a
minecraft:castabledata component. See the Data Components section for more information. - Now provides the new
minecraft:castabledata component.
Example:
{
"minecraft:castable": {
"cast_sound": "minecraft:entity.fishing_bobber.throw",
"fish_experience": "minecraft:fishing/experience",
"fish_loot_table": "minecraft:gameplay/fishing",
"retrieve_sound": "minecraft:entity.fishing_bobber.retrieve"
}
}
minecraft:damageable
- Made it so the
minecraft:max_damageandminecraft:damagedata components this behaviour component provides determines the behaviour rather than the behaviour component itself, matching vanilla again. - Moved all of its item preservation behaviour to the new
minecraft:preserve_damaged_itemdata component. - Now provides the new
minecraft:preserve_damaged_itemdata component if thepreserve_itemfield is set totrue.
minecraft:debug_stick
- Moved all of its behaviour to the
minecraft:debug_stick_statedata component.
minecraft:dye
- Moved its behaviour to modify a Sign's text colour to the
minecraft:sign_modifierdata component. - This behaviour does not provide that data component; The new
minecraft:sign_modifieritem behaviour must be used instead.
So if you had this:
{
"minecraft:dye": "orange"
}
You now have to use this instead:
{
"minecraft:dye": "orange",
"minecraft:sign_modifier": {
"apply_sound": "minecraft:item.dye.use",
"color": "orange"
}
}
minecraft:firework
- Moved all of its behaviour to the
minecraft:entity_placerand newminecraft:glider_fueldata components. - This behaviour does not provide the
minecraft:entity_placerandminecraft:glider_fueldata components; Theminecraft:entityand newminecraft:glider_fuelitem behaviour must be used instead. - Added a field:
default.- Its value is a
minecraft:fireworksdata component and is the default Firework present on each item stack.
- Its value is a
Example:
{
"minecraft:firework": {
"default": {
"flight_duration": 1
}
}
}
So if you had this:
{
"minecraft:firework": {}
}
You now have to use this instead if you want to use the entity placement behaviour:
{
"minecraft:entity": {
"entity": {
"entity": "minecraft:firework_rocket",
"spawn_rules": "minecraft:firework_rocket"
}
}
}
Or this if you want to use the glider fuel behaviour:
{
"minecraft:glider_fuel": {
"constantly_added_speed": "minecraft:glider/firework_rocket_constantly_added_speed",
"target_speed": "minecraft:glider/firework_rocket_target_speed",
"target_speed_factor": "minecraft:glider/firework_rocket_target_speed_factor"
}
}
minecraft:glider
- Made it so the
minecraft:gliderdata component this behaviour component provides determines the behaviour rather than the behaviour component itself, matching vanilla again.
minecraft:glider_fuel
- Allows this item to be used as a speed booster when gliding with a
minecraft:glider. - Format: A
minecraft:glider_fueldata component.
Example:
{
"minecraft:glider_fuel": {
"constantly_added_speed": "minecraft:glider/firework_rocket_constantly_added_speed",
"target_speed": "minecraft:glider/firework_rocket_target_speed",
"target_speed_factor": "minecraft:glider/firework_rocket_target_speed_factor"
}
}
minecraft:map_decoration_holder
- Provides an empty
minecaft:map_decorationsdata component as a default value. - Format: An empty map.
minecraft:potion_holder
- Now no longer provides a specialised translation key. Instead, the
minecraft:potion_contentsdata component provides this translation key now, making it work on any item stack.
minecraft:repairable
- Made it so the
minecraft:repairabledata component this behaviour component provides determines the behaviour rather than the behaviour component itself, matching vanilla again.
minecraft:sign_modifier
- Allows this item to modify a Sign's text-related properties.
- Format: A
minecraft:sign_modifierdata component.
Example:
{
"minecraft:sign_modifier": {
"apply_sound": "minecraft:item.honeycomb.wax_on",
"can_apply_without_text": true,
"wax": true
}
}
minecraft:smithing_template_display
- Makes this item display a tooltip and slot textures when placed in the first slot of a Smithing Table.
- Format: An identifier pointing to a smithing template display in a resource pack.
- Provides the
minecraft:smithing_template_displaydata component.
Example:
{
"minecraft:smithing_template_display": "minecraft:netherite_upgrade"
}
minecraft:suspicious_effect_ingredient
- Inlined the
effectsfield, making the item behaviour's format aminecraft:provides_suspicious_stew_effectsdata component instead. - Now provides the new
minecraft:provides_suspicious_stew_effectsdata component. - Also adds the
minecraft:provides_suspicious_stew_effects's data to theminecraft:suspicious_stew_effectsdata component in the Creative inventory when aminecraft:suspicious_effect_ingredientitem group entry type is used. Note that it uses theminecraft:provides_suspicious_stew_effectsdata component for this and not the item behaviour component.
So if you had this:
{
"minecraft:suspicious_effect_ingredient": {
"effects": [
{
"id": "minecraft:saturation",
"duration": 140
}
]
}
}
You now have to use this instead:
{
"minecraft:suspicious_effect_ingredient": [
{
"id": "minecraft:saturation",
"duration": 140
}
]
}
Data Components
- Added the following data components:
minecraft:banner_base_colorminecraft:block_brusherminecraft:castableminecraft:glider_fuelminecraft:preserve_damaged_itemminecraft:provides_suspicious_stew_effectsminecraft:sign_modifierminecraft:smithing_template_display
minecraft:blocks_attacks
- Now works without needing the
minecraft:attack_blockingitem behaviour, matching vanilla again.
minecraft:banner_base_color
- Determines the base colour used in banner-related recipes.
- Allows this item to be placed in a Loom to apply banner patterns to it.
- Format: A dye colour.
Example:
{
"minecraft:banner_base_color": "orange"
}
minecraft:block_brusher
- Allows an item stack to brush blocks and retrieve items from suspicious blocks.
- Format: A map with fields:
sweep_count: A positive int. The amount of times the block brusher should sweep a suspicious block before taking the item out.
Example:
{
"minecraft:brush": {
"sweep_count": 10
}
}
minecraft:castable
- Allows an item stack to be cast and catch items from bodies of water.
- Format: A map with fields:
cast_sound: A sound event or inline sound event. The sound to play when the item is cast.retrieve_sound: A sound event or inline sound event. The sound to play when the item is retrieved.fish_loot_table: A loot table. The loot table providing the caught items when a Player successfully catches something.fish_experience: An integer or context int provider. The amount of experience to give to the Player when they catch something.
Example:
{
"minecraft:castable": {
"cast_sound": "minecraft:entity.fishing_bobber.throw",
"fish_experience": "minecraft:fishing/experience",
"fish_loot_table": "minecraft:gameplay/fishing",
"retrieve_sound": "minecraft:entity.fishing_bobber.retrieve"
}
}
minecraft:debug_stick_state
- Now works without needing the
minecraft:debug_stickitem behaviour.
minecraft:glider_fuel
- Allows this item to be used as fuel when gliding with a
minecraft:glider.- Format: A map with fields:
constantly_added_speed: A float or context float provider. The speed to add every tick until the stable speed fromtarget_speedis reached.- When computed, the resulting value will be non-negative. The stable target speed to reach.
target_speed: A float or context float provider.- When computed, the resulting value will be non-negative.
target_speed_factor: A float or context float provider. How fast to reach the target speed.- When computed, the resulting value will be clamped between 0 and 1.
- A value of 1 instantly reaches the target speed.
- A value of 0 never reaches the target speed.
- Format: A map with fields:
- These values will only be computed once and are then stored on the Firework Rocket to be reused.
- To calculate the theoretical maximum (stable) speed when using the item as a booster you can use
(constantly_added_speed / target_speed_factor) + target_speed. - Note that this speed may not be reached as the fuel may not run for long enough. This depends on the
flight_durationfield in theminecraft:fireworksdata component.
Example:
{
"minecraft:glider_fuel": {
"constantly_added_speed": "minecraft:glider/firework_rocket_constantly_added_speed",
"target_speed": "minecraft:glider/firework_rocket_target_speed",
"target_speed_factor": "minecraft:glider/firework_rocket_target_speed_factor"
}
}
minecraft:max_damage
- Now works without needing the
minecraft:damageableitem behaviour, matching vanilla again.
minecraft:preserve_damaged_item
- Prevents the item stack from breaking by always limiting the remaining durability to 1.
- Note that this does not prevent the item stack from being used. This must be checked for separately.
- Format: An empty map.
minecraft:provides_suspicious_stew_effects
- Makes this item provide suspicious stew effects when used on a brown Mooshroom.
- Format: A
minecraft:suspicious_stew_effectsdata component.
Example:
{
"minecraft:provides_suspicious_stew_effects": [
{
"id": "minecraft:saturation",
"duration": 140
}
]
}
minecraft:repairable
- Now works without needing the
minecraft:repairableitem behaviour, matching vanilla again.
minecraft:sign_modifier
- Allows this item to modify a Sign's text-related properties.
- Format: A map with fields:
color: An optional dye colour. When set, will set the Sign's text colour on the interacted side to the specified colour.glow: An optional boolean. When set, will set the Sign's glow on the interacted side to the specified value.wax: An optional boolean. When set, will set the Sign's waxed state to the specified value.apply_sound: A sound event or inline sound event. The sound to play when successfully modifying the Sign.can_apply_without_text: An optional boolean defaulting tofalse. Whentrue, allows this modifier to be applied even when no text is present on the interacted side.
Example:
{
"minecraft:sign_modifier": {
"apply_sound": "minecraft:item.honeycomb.wax_on",
"can_apply_without_text": true,
"wax": true
}
}
minecraft:smithing_template_display
- Makes this item display a tooltip and slot textures when placed in the first slot of a Smithing Table.
- Format: An identifier pointing to a smithing template display in a resource pack.
Use Duration Providers
- The
minecraft:tridenttype now uses the appropriate data components (minecraft:max_damage,minecraft:damageandminecraft:preserve_damaged_item) to determine whether the item can be used, instead of using theminecraft:damageableitem behaviour.
Entity Spawn Rule Sets
- Added the
minecraft:firework_rocketentity spawn rule set.
Entity Spawn Rules
- Added the
minecraft:offset_spawn_position_by_interacted_sideentity spawn rule. - Renamed
minecraft:offset_spawn_position_to_exact_ytominecraft:set_spawn_position_to_interacted_positionand made additional changes, present below.
minecraft:offset_spawn_position_by_interacted_side
- Offsets the spawn position by the specified amount on the interacted side.
- Format: A map with fields:
distance: A positive double. The distance to offset the position from the current position based on the interacted side.
minecraft:set_spawn_position_to_interacted_position
- Sets the spawn position to the interacted position if enabled for that coordinate.
- Format: A map with fields:
x: A boolean defaulting tofalse. Whentrue, sets the x coordinate to the interacted x coordinate.y: A boolean defaulting tofalse. Whentrue, sets the y coordinate to the interacted y coordinate.z: A boolean defaulting tofalse. Whentrue, sets the z coordinate to the interacted z coordinate.
- This entity spawn rule adds more options than
minecraft:offset_spawn_position_to_exact_yand corrects the name.
So if you had this entity spawn rule:
{
"type": "minecraft:offset_spawn_position_to_exact_y"
}
You now have to use this instead:
{
"type": "minecraft:set_spawn_position_to_interacted_position",
"y": true
}
Entity Initialisers
- Firework Rockets now automatically set the owner if
minecraft:this_entityis present in the context.
Context Parameter Sets
- Added the
minecraft:glider_boostcontext parameter set, which is used when calculating the numbers when boosting aminecraft:gliderwith aminecraft:glider_fuel.
minecraft:glider_boost
| Parameter | Value | Required |
|---|---|---|
minecraft:this_entity |
The user boosting their equipped minecraft:glider. |
Yes |
minecraft:origin |
The position of the user boosting. | Yes |
minecraft:tool |
The fuel item used to boost the minecraft:glider with. |
Yes |
Actions
- Added the following actions:
minecraft:wax_block, which invokes actions present in the#minecraft:wax_blockaction tag and passes for the first successful one.minecraft:wax_copper_block, which waxes Copper blocks.minecraft:unwax_copper_block, which unwaxes Copper blocks.
- Updated
minecraft:unwax_blockto invoke actions present in the#minecraft:unwax_blockaction tag instead of just unwaxing Copper blocks and passes for the first successful one.- This means that the action can be extended by adding entries to the action tag.
- To unwax Copper blocks specifically, the
minecraft:unwax_copper_blockaction must be used instead.
- Removed the following action types:
minecraft:modify_sign- This action type has been moved to the new
minecraft:sign_modifierdata component and item behaviour component. - So if you had this action:
You now have to use this item behaviour component instead:{ "type": "minecraft:modify_sign", "position": "interacted", "wax": true }{ "minecraft:sign_modifier": { "apply_sound": "minecraft:item.honeycomb.wax_on", "can_apply_without_text": true, "wax": true } }
- This action type has been moved to the new
minecraft:wax_block- This has been replaced by the
minecraft:wax_blockaction instead.
- This has been replaced by the
Number Providers
- Added the
minecraft:fishing/experiencecontext int provider. - Added the following context float providers:
minecraft:glider/firework_rocket_constantly_added_speedminecraft:glider/firework_rocket_target_speedminecraft:glider/firework_rocket_target_speed_factor
Item Modifiers
- Added the
minecraft:fill_mapitem modifier.
minecraft:fill_map
- Fills the item stack with new map data at the specified block position.
- Format: A map with fields:
position: An entity source or position source. Determines the block position to use for the map data.- When an entity source (
"this","attacker","target_entity", etc.) is used, the entity's block position is provided. - When a position source (
"origin","interacted"or"spawned") is used, the block position containing the actual position is provided. - If no position could be provided from the context, the item stack is not modified.
- When an entity source (
zoom: An optional byte defaulting to 2. The zoom level of the resulting map.track_position: An optional boolean defaulting totrue. Whether to track the position of the map's holder.unlimited_tracking: An optional boolean defaulting tofalse. Whether to continue tracking the position of the map's holder when they are not within the map's bounds.
Example:
{
"type": "minecraft:fill_map",
"position": "this",
"zoom": 0
}
Changes
Predicates
Item Predicates
- Removed the
behaviorfield.- Appropriate data component predicates should be used instead.
- This makes it far more dynamic as you can check for behaviour and data separately.
So if you had this:
{
"behavior": [
"minecraft:item_holder"
]
}
You now have to use this instead:
{
"predicates": {
"minecraft:bundle_contents": {}
}
}
Note that in this example, checking for the minecraft:item_holder_rules data component is also an option if you want to check for the item holder behaviour, rather than the presence of its contents.
Smithing Template Displays
- They provide the tooltips and slot textures for the base and additions slots in a Smithing Table.
- They are placed under the
smithing_template_displaydirectory in a resource pack. - Format: A map with fields:
base_slot: A smithing template slot. The slot display for the base slot.additions_slot: A smithing template slot. The slot display for the additions slot.
Smithing Template Slots
- Provides the tooltip and slot textures for a slot in a Smithing Table.
- Format:
description: A text component. The tooltip to display when hovering over the slot.empty_textures: A list of identifiers pointing to entries in theminecraft:guiatlas. The textures to display in the slot when no item has been placed inside.
Example:
{
"additions_slot": {
"description": {
"translate": "item.minecraft.smithing_template.netherite_upgrade.additions_slot_description"
},
"empty_textures": [
"minecraft:container/slot/ingot"
]
},
"base_slot": {
"description": {
"translate": "item.minecraft.smithing_template.netherite_upgrade.base_slot_description"
},
"empty_textures": [
"minecraft:container/slot/helmet",
"minecraft:container/slot/sword",
"minecraft:container/slot/chestplate",
"minecraft:container/slot/pickaxe",
"minecraft:container/slot/leggings",
"minecraft:container/slot/axe",
"minecraft:container/slot/boots",
"minecraft:container/slot/hoe",
"minecraft:container/slot/shovel",
"minecraft:container/slot/nautilus_armor",
"minecraft:container/slot/spear"
]
}
}
Fixes
- Placed entities now spawn at their correct position again under specific circumstances.
- You can now use sign modifier items on signs again without needing to crouch.
- The fishing hook now renders in the correct hand again.
- Static tooltips now display again.
- The Netherite Upgrade item now has the same tooltip formatting as vanilla.
- The Banner duplicate recipe now properly leaves the existing banner again if no explicit remainder was specified.
This mod has no additional files