Item Coating
A mod that allows applying potion effects to weapons, tools, and armor. Effects trigger on attack, block break, or when taking damage.
307
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
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
- Loot Coatings Support: Craft item + potion OR grab potion and right-click item in inventory - Loot Coatings Support: Grab milk bucket and right-click item to remove all coatings - Loot Coatings Support: Weapons (apply on attack), Tools (apply on block break with Inversion), Armor (apply when taking damage) - Loot Coatings Support: Time-based (expire by timer) or Hit-based (expire after N hits for instant effects ≤1s) - Loot Coatings Support: Reapply same effect to extend (time-based: full/1/4 duration, hit-based: +1 hit) - Loot Coatings Support: 8% chance for items in loot chests to spawn with coatings (1% chance for Coating Curse instead) - Loot Coatings Support: Works with dual wield and offhand attacks
Enchantments
| Enchantment | Max Level | Effect | |-------------|-----------|--------| | Curse of Permanence | III | +1 coating slot per level (base 1, max 4) | | Curse of Permanence | V | Extends duration: +5s + 20% × 2 × level (time) or +1 + 2 × level hits | | Curse of Permanence | III | +1 effect level per enchantment level | | Curse of Permanence | I | Prevents applying coatings (curse) | | Curse of Permanence | I | Inverts effect application (extremely rare treasure) | | Curse of Permanence | I | Makes coatings infinite and unremovable (extremely rare treasure) |
Item Types
Weapons
- With Inversion: On attack - With Inversion: Enemy receives effect - With Inversion: Wielder receives effect
Tools
- Note: On block break (requires Inversion curse) - Note: Player receives effect (only with Inversion) - Note: No effect (blocks can't receive effects) - Note: Axes are treated as weapons, not tools
Armor
- Full Set Mode: When taking damage - Full Set Mode: Attacker receives effect - Full Set Mode: Wearer receives effect - Full Set Mode: Optional config to require all 4 pieces with same effect
Curses
Curse of Inversion
- Rarity: 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
- Rarity: 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
- Tooltip: Colored particles around coated items (configurable) - Tooltip: Real-time timer/hit counter, effect icons, Shift for descriptions
How It Works
Applying Coatings
1. Works in any inventory: Item + potion(s) → coated item + empty bottles 2. Works in any inventory: Grab potion → right-click item → instant coating 3. Works in any inventory: Player, chest, shulker box, etc.
Mechanics
- Extension (>1s potions): Shows "Poison II (1:23)", expires by timer - Extension (≤1s potions): Shows "Strength II (3 hits)", expires per use - Extension: - 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`: - Enabled: 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 Settings
```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"] ```
Weapon Coating Settings
```toml [coating] effectBlacklist = ["minecraft:bad_omen"] weaponBlacklist = [] appliedEffectDurationHitBased = 1.0 # seconds appliedEffectDurationTimeBased = 3.0 # seconds ```
Tool Coating Settings
```toml [toolCoating] enabled = true applyOnBlockBreak = true effectBlacklist = ["minecraft:bad_omen"] toolBlacklist = [] appliedEffectDurationHitBased = 1.0 # seconds appliedEffectDurationTimeBased = 3.0 # seconds ```
Armor Coating Settings
```toml [armorCoating] requireFullSet = false effectBlacklist = ["minecraft:bad_omen"] armorBlacklist = [] appliedEffectDurationHitBased = 1.0 # seconds appliedEffectDurationTimeBased = 3.0 # seconds ```
Particle Settings
```toml [particles] enable = true interval = 8 # ticks between particles spread = 0.2 velocity = 0.01 showInOffhand = true cycleColors = true ```
Enchantment Settings
```toml [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
- Forge: Access via Mod Menu - Forge: Access via mod configuration menu - Edit all settings without restarting the game - Requires Forge (included as dependency)
Compatibility
- Works with: 1.20.1 - Works with: Cross-platform (Fabric & Forge) - Works with: 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.
