Item Coating

A mod that allows applying potion effects to weapons. When hitting a target, the weapon applies the effect for several seconds.

Key Features

• Apply Coatings: Craft weapon + potion OR grab potion and right-click weapon in inventory
• Remove Coatings: Grab milk bucket and right-click weapon to remove all coatings
• Two 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)
• Infinite Coatings: 15% chance for weapons in loot chests to spawn with permanent coatings
• Better Combat Support: Works with dual wield and offhand attacks

Enchantments

Visual Effects

• Particles: Colored particles around coated weapons (configurable)
• Tooltip: Real-time timer/hit counter, effect icons, Shift for descriptions
• Colors: Blue (beneficial), Red (harmful)

How It Works

Applying

1. Crafting: Weapon + potion(s) → coated weapon + empty bottles
2. Quick Apply: Grab potion → right-click weapon → instant coating

Mechanics

• Time-based (>1s potions): Shows "Poison II (1:23)", expires by timer
• Hit-based (≤1s potions): Shows "Strength II (3 hits)", expires per attack
• On Hit: Applies effect for 3s (time-based) or 1s (hit-based)
• Extension:
  • Time-based: Same level = full duration, different level = 1/4 duration
  • Hit-based: +1 hit per potion (regardless of level)

Loot Configuration

config/itemcoating/loot_coating.json:

{
  "coatingChance": 0.15,
  "minAmplifier": 0,
  "maxAmplifier": 1,
  "effectBlacklist": ["minecraft:bad_omen", "minecraft:darkness"]
}

Particle Configuration

config/itemcoating/particle_settings.json:

{
  "enableParticles": true,
  "particleInterval": 8,
  "particleSpread": 0.2,
  "particleVelocity": 0.01,
  "showInOffhand": true,
  "cycleColors": true
}