Item Coating
No reviews yet
A mod that allows applying potion effects to weapons, tools, and armor. Effects trigger on attack, block break, or when taking damage.
Community voices
Reviews
Click once to include, again to exclude, again to clear
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
Compatibility
Supported Environments
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
Resources
External Links
About
Description
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
- Crafting: Item + potion(s) → coated item + empty bottles
- Quick Apply: Grab potion → right-click item → instant coating
- 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.
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
- Crafting: Item + potion(s) → coated item + empty bottles
- Quick Apply: Grab potion → right-click item → instant coating
- 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 Settings
[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
[coating]
effectBlacklist = ["minecraft:bad_omen"]
weaponBlacklist = []
appliedEffectDurationHitBased = 1.0 # seconds
appliedEffectDurationTimeBased = 3.0 # seconds
Tool Coating Settings
[toolCoating]
enabled = true
applyOnBlockBreak = true
effectBlacklist = ["minecraft:bad_omen"]
toolBlacklist = []
appliedEffectDurationHitBased = 1.0 # seconds
appliedEffectDurationTimeBased = 3.0 # seconds
Armor Coating Settings
[armorCoating]
requireFullSet = false
effectBlacklist = ["minecraft:bad_omen"]
armorBlacklist = []
appliedEffectDurationHitBased = 1.0 # seconds
appliedEffectDurationTimeBased = 3.0 # seconds
Particle Settings
[particles]
enable = true
interval = 8 # ticks between particles
spread = 0.2
velocity = 0.01
showInOffhand = true
cycleColors = true
Enchantment Settings
[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.
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Want to reach Minecraft players?
We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!
Get in touchGet it on
Available Platforms
On ModDex
Community snapshot
By the numbers
Statistics
Resources