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) - **(https://modrinth.com/mod/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`: <details> <summary>Loot Settings</summary> ```toml coatingChance = 0.08 # 8% chance for coating/curse curseChance = 0.01 # 1% chance for curse instead of coating minAmplifier = 0 maxAmplifier = 1 effectBlacklist = ``` </details> <details> <summary>Weapon Coating Settings</summary> ```toml effectBlacklist = weaponBlacklist = appliedEffectDurationHitBased = 1.0 # seconds appliedEffectDurationTimeBased = 3.0 # seconds ``` </details> <details> <summary>Tool Coating Settings</summary> ```toml enabled = true applyOnBlockBreak = true effectBlacklist = toolBlacklist = appliedEffectDurationHitBased = 1.0 # seconds appliedEffectDurationTimeBased = 3.0 # seconds ``` </details> <details> <summary>Armor Coating Settings</summary> ```toml requireFullSet = false effectBlacklist = armorBlacklist = appliedEffectDurationHitBased = 1.0 # seconds appliedEffectDurationTimeBased = 3.0 # seco