Item Coating

Item Coating

A mod that allows applying potion effects to weapons, tools, and armor. Effects trigger on attack, block break, or when taking damage.

Key Features

• Apply Coatings: Craft item + potion OR grab potion and right-click item in inventory
• Remove Coatings: Grab milk bucket and right-click item to remove all coatings
• Three Item Types: Weapons (apply on attack), Tools (apply on block break with Inversion), Armor (apply when taking damage)
• Two Effect Types: Time-based (expire by timer) or Hit-based (expire after N hits for instant effects ≤1s)
• Extend Effects: Reapply same effect to extend (time-based: full/1/4 duration, hit-based: +1 hit)
• Loot Coatings: 8% chance for items in loot chests to spawn with coatings (1% chance for Coating Curse instead)
• Better Combat Support: Works with dual wield and offhand attacks

Enchantments

| Enchantment | Max Level | Effect |
|————-|———–|——–|
| Coating Capacity | III | +1 coating slot per level (base 1, max 4) |
| Coating Preservation | V | Extends duration: +5s + 20% × 2 × level (time) or +1 + 2 × level hits |
| Coating Potency | III | +1 effect level per enchantment level |
| Coating Curse | I | Prevents applying coatings (curse) |
| Curse of Inversion | I | Inverts effect application (extremely rare treasure) |
| Curse of Permanence | I | Makes coatings infinite and unremovable (extremely rare treasure) |

Item Types

Weapons

• Trigger: On attack
• Target: Enemy receives effect
• With Inversion: Wielder receives effect

Tools

• Trigger: On block break (requires Inversion curse)
• Target: Player receives effect (only with Inversion)
• Without Inversion: No effect (blocks can’t receive effects)
• Note: Axes are treated as weapons, not tools

Armor

• Trigger: When taking damage
• Target: Attacker receives effect
• With Inversion: Wearer receives effect
• Full Set Mode: Optional config to require all 4 pieces with same effect

Curses

Curse of Inversion

• Effect: Inverts who receives the coating effect
• Weapons: Effects apply to wielder instead of target
• Tools: Effects apply to player when breaking blocks
• Armor: Effects apply to wearer instead of attacker
• Rarity: Extremely rare (1% of normal curse chance)

Curse of Permanence

• Effect: Coatings become infinite and cannot be removed
• Coatings never expire (no duration/hit countdown)
• Milk bucket cannot remove coatings
• Can still add new coatings if capacity allows
• Rarity: Extremely rare (1% of normal curse chance)

Visual Effects

• Particles: Colored particles around coated items (configurable)
• Tooltip: Real-time timer/hit counter, effect icons, Shift for descriptions

How It Works

Applying Coatings

1. Crafting: Item + potion(s) → coated item + empty bottles
2. Quick Apply: Grab potion → right-click item → instant coating
3. Works in any inventory: Player, chest, shulker box, etc.

Mechanics

• Time-based (>1s potions): Shows “Poison II (1:23)”, expires by timer
• Hit-based (≤1s potions): Shows “Strength II (3 hits)”, expires per use
• On Trigger:
• Weapons: Applies effect for 3s (time) or 1s (hit) on attack
• Tools: Applies effect for 1s (time) or 1s (hit) on block break (with Inversion)
• Armor: Applies effect for 3s (time) or 1s (hit) when taking damage
• Extension:
• Time-based: Same level = full duration, different level = 1/4 duration
• Hit-based: +1 hit per potion (regardless of level)

Armor Full Set Mode

Optional config setting armorCoating.requireFullSet:

• Disabled (default): Each armor piece works independently
• Enabled: Effects only apply if all 4 pieces have the same effect

Configuration

Fully customizable via config/itemcoating/itemcoating.toml:

[loot]
coatingChance = 0.08  # 8% chance for coating/curse
curseChance = 0.01    # 1% chance for curse instead of coating
minAmplifier = 0
maxAmplifier = 1
effectBlacklist = ["minecraft:bad_omen"]

[coating]
effectBlacklist = ["minecraft:bad_omen"]
weaponBlacklist = []
appliedEffectDurationHitBased = 1.0  # seconds
appliedEffectDurationTimeBased = 3.0  # seconds

[toolCoating]
enabled = true
applyOnBlockBreak = true
effectBlacklist = ["minecraft:bad_omen"]
toolBlacklist = []
appliedEffectDurationHitBased = 1.0  # seconds
appliedEffectDurationTimeBased = 3.0  # seconds

[armorCoating]
requireFullSet = false
effectBlacklist = ["minecraft:bad_omen"]
armorBlacklist = []
appliedEffectDurationHitBased = 1.0  # seconds
appliedEffectDurationTimeBased = 3.0  # seconds

[particles]
enable = true
interval = 8  # ticks between particles
spread = 0.2
velocity = 0.01
showInOffhand = true
cycleColors = true

[enchantments.capacity]
enabled = true
maxLevel = 3
slotsFormula = "1 + {level}"
minPower = 1
maxPower = 51
availableInBooks = true
availableInTable = true

[enchantments.inversion]
enabled = true
minPower = 80
maxPower = 100
availableInBooks = false
availableInTable = false
lootChanceMultiplier = 0.01  # 100x rarer

[enchantments.permanence]
enabled = true
minPower = 80
maxPower = 100
availableInBooks = false
availableInTable = false
lootChanceMultiplier = 0.01  # 100x rarer
effectBlacklist = ["minecraft:instant_health", "minecraft:instant_damage"]

In-Game Configuration

• Fabric: Access via Mod Menu
• Forge: Access via mod configuration menu
• Edit all settings without restarting the game
• Requires Fzzy Config (included as dependency)

Compatibility

• Minecraft: 1.20.1
• Architectury: Cross-platform (Fabric & Forge)
• Better Combat: Full dual wield and offhand support
• Works with: Any mod using standard Minecraft potion effects

Related Mods

• Effectification – Unifies similar status effects from different mods

Alternative Implementations

If you’re looking for similar functionality, check out:

• Coated Blades – A datapack/mod for Minecraft 1.21+ with comparable coating mechanics~~~~

License

This mod is licensed under MIT License.