 |
VOOZH | about |
|
VOOZH | about |
Items models[1], commonly referred to as Client Items, Item definitions or Itemstates, are processor files used by the game to define and select which model to use for rendering items, depending of various criteria such as components, item interactions, their position in the inventory, or numerous other in-game values.
Items models are stored as JSON files in a resource pack in the assets/<namespace>/items folder.
Which items model is used by an item is based on the component minecraft:item_model, which references the identifier of the items model at /assets/<namespace>/items/<id>, and can be changed through commands.
true.false the render will be clipped to the item slot size. Default: false.
1.0.minecraft:model, minecraft:composite, minecraft:condition, minecraft:select, minecraft:range_dispatch, minecraft:empty, minecraft:bundle/selected_item, or minecraft:special.minecraft:composite, minecraft:condition, minecraft:select, or minecraft:range_dispatch), the transformation will be composed with the transformation of the children, except for bundle/selected_item.minecraft:empty, and minecraft:bundle/selected_item type.Render a plain model from the models directory.
minecraft:modeltintindex 0, second one to tintindex 1, etc.). Elements with no tintindex specified remain untinted.
minecraft:constant, minecraft:dye, minecraft:firework, minecraft:grass, minecraft:map_color, minecraft:potion, minecraft:team, or minecraft:custom_model_data.Return a constant RGB color.
minecraft:constant-1) or an array of decimal RGB values, each between 0.0 and 1.0 (e.g. [1, 1, 1])Return value from minecraft:dyed_color component or default if not present
minecraft:dyeReturn average of colors from minecraft:firework_explosion component or default color if there are none.
minecraft:fireworkReturn grass color at specific climate parameters, based on textures/colormap/grass.png
minecraft:grass0.0 and 1.0.0.0 and 1.0.Return value from minecraft:map_color component or default color if component is not present.
minecraft:map_colorReturn color from minecraft:potion_contents component:
minecraft:potionReturns the team color of context entity, if any. Else, when there is no context entity, entity is not in a team or team has no color, return default.
minecraft:teamReturn value from colors list in minecraft:custom_model_data component.
minecraft:custom_model_datacolors. Default: 0.Render multiple sub-models in the same space.
minecraft:composite
minecraft:conditionminecraft:broken, minecraft:bundle/has_selected_item, minecraft:carried, minecraft:component, minecraft:damaged, minecraft:extended_view, minecraft:fishing_rod/cast, minecraft:has_component, minecraft:keybind_down, minecraft:selected, minecraft:using_item, minecraft:view_entity, or minecraft:custom_model_data.true.false.Return true if the item is damageable and has only one use remaining before breaking.
No additional fields for this type.
Return true if bundle is "open", i.e. it has selected item visible in GUI.
No additional fields for this type.
Return true if item is carried between slots in GUI.
No additional fields for this type.
Uses component data component predicates to match item components.
minecraft:data_component_predicate_type registry).Return true if the item is damageable and has been used at least once.
No additional fields for this type.
Return true if player has requested extended details by holding shift key down. Only works when item is displayed in UI. Note: not a keybind, can't be rebound.
No additional fields for this type.
Return true if there is a fishing bobber attached to currently used fishing rod.
No additional fields for this type.
Return true if the given component is present on the item.
Return true if keybind is currently active.
keybind text component.Return true if item is selected on a hotbar.
No additional fields for this type.
Return true if player is currently using this item.
No additional fields for this type.
true if context entity is the local player entity, i.e. the one controlled by client.true if context entity is the spectated entity.false.No additional fields for this type.
Return value from flags list in minecraft:custom_model_data component.
flags. Default: 0.
Render an items model based on discrete property.
minecraft:selectminecraft:block_state, minecraft:charge_type, minecraft:component, minecraft:context_dimension, minecraft:context_entity_type, minecraft:display_context, minecraft:local_time, minecraft:main_hand, minecraft:trim_material, or minecraft:custom_model_data.Return value for some property from minecraft:block_state component.
Values: Any string.
Return charge type stored in minecraft:charged_projectiles component.
No additional fields for this type.
Values:
none: If there are no projectiles or component is not present.rocket: If there is at least one firework rocket.arrow: Any other case.Return value from a component. If the selected value comes from a registry and the current datapacks does not provide it, the entry will be silently ignored.
Values: Depends on the target component type.
Return the ID of the dimension in context, if any.
No additional fields for this type.
Values: Namespaced dimension ID.
Return the holding entity type, if present.
No additional fields for this type.
Values: Namespaced entity type ID.
Return context this item is rendered in.
No additional fields for this type.
Values:
nonethirdperson_lefthandthirdperson_righthandfirstperson_lefthandfirstperson_righthandheadguigroundfixedon_shelfReturns the current time formatted according to a given pattern. The value is updated every second. For full format documentation for locale, time zone and pattern, see ICU (International Components for Unicode) documentation.
"" which means "root" locale (a set of defaults, including English names).
en_US: English language (used for things like week names), formating as in USA.cs_AU@numbers=thai;calendar=japanese: Czech language, Australian formatting, Thai numerals and Japanese calendar.Europe/Stockholm, GMT+0:45yyyy-MM-dd: 4-digit year number, then 2-digit month number, then 2-digit day of month number, all zero-padded if needed, separated by -.HH:mm:ss: current time (hours, minutes, seconds), 24-hour cycle, all zero-padded to 2 digits of needed, separated by :.Values: Any string.
Return main hand of holding player.
No additional fields for this type.
Values: left, or right.
Return value of material field from minecraft:trim component, if present.
No additional fields for this type.
Values: Namespaced ID trim material.
Return value from strings list in minecraft:custom_model_data component.
strings. Default: 0.Values: Any string.
Render an items model based on numeric property. Will select last entry with threshold less or equal to property value.
minecraft:range_dispatchminecraft:bundle/fullness, minecraft:compass, minecraft:cooldown, minecraft:count, minecraft:crossbow/pull, minecraft:damage, minecraft:time, minecraft:use_cycle, minecraft:use_duration, or minecraft:custom_model_data.1.0.Return weight of minecraft:bundle_contents component or 0 if not present.
No additional fields for this type.
Return an angle, scaled from 0.0 to 1.0 in x-z plane between holder position and target. If target is not valid (not present, in other dimension or too close to holder position) random value will be returned.
spawn: points at world spawn.lodestone: points at location stored in minecraft:lodestone_tracker component.recovery: points at last player death location.none: always return an invalid target.true, value will oscillate for some time around target before settling. Default: true.Return remaining cooldown for item, scaled between 0.0 to 1.0.
No additional fields for this type.
Return stack size.
true.
true, return count divided by minecraft:max_stack_size component, clamped to 0.0 to 1.0.false, return count clamped to 0 to minecraft:max_stack_size.Return crossbow-specific use time.
No additional fields for this type.
Return value for minecraft:damage component or 0 if not present.
true.
true, return value of damage divided by minecraft:max_damage component, clamped to 0.0 to 1.0.false, return raw value of damage, clamped to 0 to minecraft:max_damage.Return value of an in-game time, scaled between 0.0 to 1.0.
daytime, moon_phase, or random. For daytime, the source value is the minecraft:visual/sun_angle environment attribute divided by 360.0, meaning 0.0 represents noon and 0.5 represents midnight. For moon_phase, the source value is the minecraft:visual/moon_phase environment attribute, with full_moon, waning_gibbous, third_quarter, waning_crescent, new_moon, waxing_crescent, first_quarter, and waxing_gibbous mapped to 0⁄8, 1⁄8, 2⁄8, 3⁄8, 4⁄8, 5⁄8, 6⁄8, and 7⁄8 respectively. In both cases, the source value will default to 0.0 in locations that don't specify those environment attributes, like the Nether and the End. For random, the source value is a new random value every frame.false, source value will be used directly. If true, value will oscillate for some time around source value before settling. Default: true.Return remaining use ticks modulo period.
1.0.Return item use ticks.
true, returned value will be remaining use ticks, if false - ticks so far. Default: false.Return value from floats list in minecraft:custom_model_data component or 0 if not present.
floats. Default: 0.Does not render anything.
No additional fields for this type.
Render the selected stack in minecraft:bundle_contents component, if present, otherwise does nothing.
No additional fields for this type.
Render a special model.
minecraft:specialminecraft:banner, minecraft:bed, minecraft:bell, minecraft:book, minecraft:chest, minecraft:conduit, minecraft:copper_golem_statue, minecraft:decorated_pot, minecraft:end_cube, minecraft:head, minecraft:player_head, minecraft:shield, minecraft:shulker_box, minecraft:standing_sign, minecraft:hanging_sign, or minecraft:trident.models directory, to providing transformations, particle texture and GUI light.Render a banner with patterns from minecraft:banner_patterns component.
minecraft:bannerground, or wall. Default: ground.Render the animated part of a Bell block.
No additional fields for this type.
Render the book that normally is a part of Enchanting Table and Lectern.
minecraft:book0 means closed, 90 means open flat)0.0 means that the page is at the leftmost position, 1.0 at the rightmost position.Render a single chest.
minecraft:chest.png suffix. By default this includes textures in textures/entity/chest/, without the prefix.single, left, or right. Default: single.0.0 (fully closed) to 1.0 (fully open). Default: 0.0.Render conduit.
No additional fields for this type.
Render a copper golem statue.
minecraft:copper_golem_statuesitting, running, star, or standing..png suffix.Render a decorated pot. Uses values from minecraft:pot_decorations component.
No additional fields for this type.
Render a block-sized starfield cube.
minecraft:end_cubegateway, or portal.Render a head.
minecraft:headskeleton, wither_skeleton, player, zombie, creeper, piglin, or dragon.textures/entity/ prefix and .png suffix.
kind field.kind of head (like Piglin ears or Ender Dragon jaw). Default: 0.0.
Render a player head. Use the data into the minecraft:profile component to select the texture to render.
No additional fields for this type.
Render a shield. Uses patterns from minecraft:banner_patterns component and color from minecraft:base_color component.
No additional fields for this type.
Render a shulker box.
minecraft:shulker_box.png suffix. By default this includes textures in textures/entity/shulker/, without the prefix.0.0 (fully closed) to 1.0 (fully open). Default: 0.0.Render a trident.
No additional fields for this type.
| Java Edition | |||||||
|---|---|---|---|---|---|---|---|
| 1.21.4 | 24w45a | Added Item model definitions. | |||||
| 24w46a | Added holder_type property types.
| ||||||
Added keybind_down boolean property types.
| |||||||
Added standing_sign and hanging_sign special model types.
| |||||||
Added texture field to head special model types.
| |||||||
Removed xmas boolean property, replaced by local_time property model types.
| |||||||
Removed shift_down boolean property, replaced by extended_view boolean property.
| |||||||
| Pre-Release 1 | Added hand_animation_on_swap field to items model definition.
| ||||||
Added empty item model type.
| |||||||
Added team tint sources type.
| |||||||
Added context_dimension property type.
| |||||||
Added view_entity boolean property type.
| |||||||
Renamed holder_type to context_entity_type property type.
| |||||||
Removed natural_only field and added source field in time numeric property type.
| |||||||
Added none to possible values for target field in compass numeric property type.
| |||||||
Added animation field to head special model type.
| |||||||
| 1.21.5 | 25w03a | Added component property type. | |||||
| 25w04a | Added component boolean property type. | ||||||
| 1.21.6 | Pre-Release 1 | Removed the support of loading profile data for head special type to render player head.
| |||||
Added player_head special type.
| |||||||
Added oversized_in_gui field to items model definition.
| |||||||
| 1.21.9 | 25w31a | Added copper_golem_statue special type. | |||||
| 25w33a | Added on_shelf display context. | ||||||
| 1.21.11 | 25w41a | Added swap_animation_scale field to items model definition. | |||||
| 26.1 | snap11 | Added transformation field to Items model object.
| |||||
Added bell, and book special model types.
| |||||||
Added attachment field to banner, and hanging_sign special model types.
| |||||||
Added attachement [sic][4] field to standing_sign special model type.
| |||||||
Added part field to bed special model type.
| |||||||
Added chest_type field to chest special model type.
| |||||||
Removed orientation field from shulker_box special model type. | |||||||
| pre1 | Added end_cube special model types. | ||||||
| 26.2 | snap3 | Removed the bed special model type. | |||||
| snap7 | Removed standing_sign, and hanging_sign special model types. | ||||||
Render one half of a bed. To render both halves, and so the whole bed, use a minecraft:composite model.
Version added: 24w45a. Version removed: 26.2 snapshot 3.
minecraft:bedhead, or foot..png suffix. By default this includes textures in textures/entity/bed/, without the prefix.Renders a standing sign.
Version added: 24w46a. Version removed: 26.2 snapshot 7.
minecraft:standing_signwall, or ground. Default: ground.oak, spruce, birch, acacia, cherry, jungle, dark_oak, pale_oak, mangrove, bamboo, crimson, or warped..png suffix. By default this includes textures in textures/entity/signs/, without the prefix. If present, wood_type field is ignored.Renders a hanging sign.
Version added: 24w46a. Version removed: 26.2 snapshot 7.
minecraft:hanging_signwall, ceiling, or ceiling_middle. Default: ceiling_middle.oak, spruce, birch, acacia, cherry, jungle, dark_oak, pale_oak, mangrove, bamboo, crimson, or warped..png suffix. By default this includes textures in textures/entity/signs/, without the prefix. If present, wood_type field is ignored.
