🧪 PotionEffectsSet

Transform any item into legendary equipment! ✨

PotionEffectsSet allows you to attach custom potion effects to any item in the game using a simple datapack system. Whether you want a sword that poisons enemies or armor that heals you when struck, you can configure it easily.

---

✨ Features

• ⚔️ Slot-Specific Triggers: Effects only activate when the item is in the correct slot (Mainhand, Offhand, Armor, etc.).
• 🎲 Multiple Trigger Types:
  • Passive: Constant effect while equipped.
  • On Hit: Chance to apply effect to the target when attacking.
  • On Hurt: Chance to apply effect to self when taking damage.
• 💍 Curios API Support: Fully compatible with rings, necklaces, belts, and other accessories.
• 📝 Datapack Driven: No hardcoding! easy JSON configuration.
• 🔄 Hot Reload: Tweak values live using /reload.

---

📋 Usage Examples

Copy these into your datapack JSON files to get started immediately.

⚔️ Example: Diamond Sword with Poison

This configuration makes any Diamond Sword apply Poison II for 5 seconds (30% chance) when hitting enemies.

{
  "minecraft:diamond_sword": {
    "on_hit_effects": [
      {
        "effect": "minecraft:poison",
        "amplifier": 1,
        "duration": 100,
        "chance": 0.3,
        "slot": "mainhand"
      }
    ]
  }
}

🛡️ Example: Tank Chestplate

Grants permanent Resistance I. When you get hit, there is a 50% chance to gain Regeneration II.

{
  "minecraft:diamond_chestplate": {
    "passive_effects": [
      {
        "effect": "minecraft:resistance",
        "amplifier": 0,
        "permanent": true,
        "slot": "chest"
      }
    ],
    "on_hurt_effects": [
      {
        "effect": "minecraft:regeneration",
        "amplifier": 1,
        "duration": 100,
        "chance": 0.5,
        "slot": "chest"
      }
    ]
  }
}

👟 Example: Speed Boots

Gives Speed II while worn.

{
  "minecraft:golden_boots": {
    "passive_effects": [
      {
        "effect": "minecraft:speed",
        "amplifier": 1,
        "permanent": true,
        "slot": "feet"
      }
    ]
  }
}

💍 Example: Invisibility Ring (Curios)

Grants Invisibility while worn in a 'ring' slot.

{
  "curios:ring_gold": {
    "passive_effects": [
      {
        "effect": "minecraft:invisibility",
        "amplifier": 0,
        "permanent": true,
        "slot": "ring",
        "is_curio": true
      }
    ]
  }
}

---

🔧 Configuration Guide

📁 Location

world/datapacks/<name>/data/potioneffectsmodify/potion_effects/your_file.json

⚙️ Options

Property	Type	Description
effect	ID	The potion effect ID (e.g., minecraft:strength)
amplifier	Int	Level of the effect (0 = Level I, 1 = Level II)
duration	Int	Duration in ticks (20 ticks = 1 second)
chance	Float	Probability (0.0 to 1.0) for On Hit/On Hurt
slot	String	Required slot (mainhand, head, feet, curios:ring, etc.)
permanent	Bool	If true, effect refreshes automatically (for passive)
is_curio	Bool	Set to true if targeting a Curios slot

---

📦 Installation

1. Download the mod and place it in your mods folder.
2. (Optional) Install Curios API if you want accessory support.
3. Launch the game.
4. Create your JSON configs in a datapack (see examples above).
5. Run /reload in-game to apply changes instantly!

---

Please join our Discord for support, suggestions, or to share your configs!