Skip to content

Component Types

This page documents the various component types added by Scorchful.

Item Components

These are the new component types added for items. For the full format in Vanilla, see: https://minecraft.wiki/w/Data_component_format

Drink Level

Available 1.21.1+

Sets how much water this item should restore to players when consumed. This does not apply if a thirst mod like Dehydration is installed.

  • {} components: Parent tag.
    • E scorchful:heat_resistance: One of parching, refreshing, sustaining, or hydrating. The final water replenishing values are set by config.

Num Drinks

Available 1.21.1-1.21.3. Replaced with scorchful:drink_container in 1.21.4.

Sets the number of drinks in a Water Skin.

  • {} components: Parent tag.
    • I scorchful:num_drinks: Integer in the range [0, 16]. Used by the Water Skin item to determine how many drinks it has left.

Drink Container

Available: 1.21.4+, use scorchful:num_drinks in previous versions.

Sets the current and max number of drinks in a drinkable item, such as a Water Skin. This component cannot exist on a stackable item stack.

  • {} components: Parent tag.
    • {} scorchful:drink_container: A compound component.
      • I num_drinks: Integer in the range [0, max_drinks]. Determines the number of drinks left in this item container.
      • I max_drinks: Optional positive integer. The maximum number of drinks this container may have. Defaults to 16.

Alternative format:

  • {} components: Parent tag.
    • I scorchful:drink_container: Integer in the range [0, 16]. Determines the number of drinks left in this item container.

Heat Resistance

Available: 1.21.1+

This component adds Heat Resistance and Environment Heat Resistance attribute modifiers to items. This does not modify the underlying minecraft:attribute_modifiers component, it only applies modifiers when the item is equipped or displayed in a tooltip.

The attributes are documented on the Thermoo Wiki.

  • {} components: Parent tag.
    • {} scorchful:heat_resistance: A compound component.
      • D heat_resistance: The heat resistance value to add to the entity when this item is worn.
      • D environment_heat_resistance: The environment heat resistance value to add to the entity when this item is worn.

The final attribute modifiers are applied as an add_value modifier for the thermoo:heat_resistance1 and thermoo:environment_heat_resistance1 attributes with modifier IDs of scorchful:base_heat_resistance/${slot_id} and scorchful:base_environment_heat_resistance/${slot_id}, respectively.

Tip

These base values are not currently configurable. If you wish to have more fine-grained control over the item attribute modifier values, you will need to use another mod like Default Components to set the default value to 0 in this component, and then add a regular attribute modifier to the underlying minecraft:attribute_modifiers component using a mod like CIA or Default Components.

Default Item Heat Resistance List
Item/Armor tier Heat resistance modifier
All Chainmail Armor Neutral
All Golden Armor Neutral
All Iron Armor Harmful (-0.5 HR, -0.125 EHR)
All Leather Armor Harmful (-0.5 HR, -0.125 EHR)
All Diamond Armor Harmful (-0.5 HR, -0.125 EHR)
All Fur Armor (Frostiful) Very Harmful (-1 HR, -0.25 EHR)
All Fur Padded Chainmail Armor (Frostiful) Very Harmful (-1 HR, -0.25 EHR)
Ice Skates (Frostiful) Very Harmful (-1 HR, -0.25 EHR)
Armored Ice Skates (Frostiful) Very Harmful (-1 HR, -0.25 EHR)
All Netherite Armor Protective (+0.5 HR, +0.125 EHR)
Turtle Shell Very Protective (+1 HR, +0.25 EHR)
All other Turtle Armor Very Protective (+1 HR, +0.25 EHR)

Sun Hat Renderer

Available: 1.21.4+

When present, replaces normal item rendering with that of the sun hat when the item is worn on an entity's head. This includes a 3D sun hat model, a tooltip, and adjusting the opacity of the camera_overlay texture (if an equippable component is present).

  • {} components: Parent tag.
    • {} scorchful:has_sun_hat_model: Compound component.
      • T/F replace_armor_model: Optional boolean, whether the regular armor model should be replaced with the Sun Hat. If false, a Sun Hat will be rendered in addition to the regular armor model when worn. Defaults to true.
      • T/F show_tooltip: Optional boolean, whether to show the tooltip Reduces heat from the Sun when worn. Defaults to true.

  1. In 1.21.1 and below, these attribute IDs are thermoo:generic.heat_resistance and thermoo:generic.environment_heat_resistance. ↩↩