TFC Hot or Not

This is an addon for TerraFirmaCraft, that makes you unable to hold too hot or too cold items, unless you carry insulating items, such as mittens, tongs or potholders. These items have durability, that are affected by the temperature of the items you want to hold, and can eventually break. Further, the temperature of the insulating items in your offhand will also increase in line with the temperature of the items you want to hold. Eventually you may risk the insulating items burning or melting away.

Gameplay Functionality

Beyond whitelist and blacklist tags, the mod introduces several mechanics that affect how players interact with hot, cold, or gaseous items and fluids.

When Items or Fluids Are Too Hot

• Items or fluids above the configured hot temperature threshold will burn the player.
• The player may catch fire for a short duration if holding these items.
• Tooltips will display a "Too Hot" warning when enabled in configuration.
• Certain items without a measurable temperature (for example, lava buckets) can still be treated as hot if they are whitelisted.

When Items or Fluids Are Too Cold

• Items or fluids below the configured cold temperature threshold will apply negative effects.
• Effects include slowness and weakness, simulating the difficulty of handling freezing objects.
• Tooltips will display a "Too Cold" warning when enabled in configuration.
• Special cases can be whitelisted to always count as cold.

When Items or Fluids Are Gaseous

• Gaseous items or fluids apply a levitation effect, causing the player to float briefly.
• This effect is only applied if gaseous effects are enabled in configuration.
• Tooltips will display a "Too Light" warning when enabled.
• Blacklist tags can be used to exclude specific gases.

Mitigating Burn or Cold Damage

• Insulating items (mittens, potholders, tongs) can be held in the offhand to safely handle hot or cold objects.
• These insulating items absorb durability damage based on the temperature of the object being held.
• Durability values for insulating items are configurable (for example, wooden tongs, potholders, mittens).
• If insulating items break or are not used, the player risks dropping the hot or cold item automatically ("yeeting"), depending on configuration.

Melting Items

• Items with heat capability can melt when their temperature exceeds the recipe threshold.
• Melting may produce a new item stack or a fluid puddle at the player’s feet.
• Fluid puddles are configurable and can be dangerous if molten metals or lava are involved.
• Players receive a warning message when items are close to melting.

Whitelist and Blacklist Tags

The mod uses item and fluid tags to determine when temperature or gaseous effects should be applied. These tags allow pack makers and addon authors to customize behavior without modifying code.

Cold Tags

• cold_whitelist

Items or fluids explicitly treated as cold, even if they do not expose a temperature property. Example: ice blocks, snowballs.

• cold_blacklist

Items or fluids that should never be treated as cold, even if they meet the cold threshold. Blacklist always overrides whitelist and thresholds.

Hot Tags

• hot_whitelist

Items or fluids explicitly treated as hot, even if they do not expose a temperature (for example, lava bucket).

• hot_blacklist

Items or fluids that should never be treated as hot, even if they exceed the hot threshold. Blacklist always overrides whitelist and thresholds.

Gaseous Tags

• gaseous_whitelist

Items or fluids explicitly treated as gaseous. This effect is only applied if gaseous effects are enabled in the configuration.

• gaseous_blacklist

Items or fluids excluded from gaseous effects, even if they appear in the whitelist. Blacklist always overrides.

General Fluid Tags

• fluid_whitelist

A broad whitelist for fluids that should be considered by the system. Used as a filter before applying specific cold, hot, or gaseous checks.

• fluid_blacklist

A broad blacklist for fluids that should be ignored entirely. Useful for excluding modded fluids that should not interact with temperature logic.

Insulating Tag

• insulating

Items that can be used to safely hold hot or cold objects (for example, mittens, potholders, tongs). These items absorb durability damage based on the temperature of what they are holding.

How Tags Are Used

1. Blacklist always wins

If an item or fluid is in a blacklist, it will never apply effects, regardless of whitelist or temperature.

1. Temperature thresholds

Items or fluids with a measurable temperature apply effects if they cross the configured hot or cold thresholds. Whitelist is not required in this case.

1. Whitelist fallback

Items or fluids without a temperature (for example, lava bucket, gas bottle) can still apply effects if they are explicitly whitelisted. If the whitelist tag is empty, all items or fluids are allowed unless blacklisted.

1. Gaseous effects

Only applied if enabled in configuration, and only for items or fluids in the gaseous whitelist, unless blacklisted.

---