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
Download

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.

ADS