🧪 PotionFilter

Take absolute control over how status effects are distributed on your Minecraft server. PotionFilter is a lightweight, highly flexible, and granular solution designed for server administrators who need more than just a simple "enable/disable" switch for potions.

Whether you want to balance your PvP meta by disabling drinkable Strength II potions while keeping splash potions enabled, or completely block specific newer 1.21 effects like Trial Omen or Oozing, PotionFilter allows you to customize every single scenario.

✨ Features

Granular Delivery Control: Decide how an effect is blocked. Toggle individual rules for:

🥤 Drinking (Normal Potions)

💥 Splash (Splash Potions)

☁️ Lingering (Area Effect Clouds)

🏹 Tipped Arrows (Bow/Crossbow projectiles)

Per-Effect Customization: Every single Minecraft status effect up to version 1.21.1+ is supported, including the latest Tricky Trials and Ominous Event effects.

Lightweight & High-Performance: Built on the modern EntityPotionEffectEvent API. The plugin checks the source of the effect directly, ensuring zero server lag or performance overhead.

Smart Filtering: Bypasses non-potion sources. Natural game mechanics like Beacons, Apple consumption, or Admin Commands (/effect) will continue to work perfectly unless they originate from a potion tool.

⚙️ Configuration (config.yml)

The configuration is incredibly intuitive. Simply list the effect in uppercase and set the delivery method to true to block it, or false to allow it:

YAML

• PotionFilter Configuration

• true = Blocked (Effect will NOT be applied via this method)

• false = Allowed (Effect works normally)

• effects:

  • STRENGTH:
    • drink: true
    • splash: false
    • lingering: false
    • tipped_arrow: false
  • SPEED:
    • drink: false
    • splash: true
    • lingering: false
    • tipped_arrow: false

🚀 Installation

Download the PotionFilter.jar file.

Drop the file into your server's plugins folder.

Restart or start your server to generate the default config.yml.

Open plugins/PotionFilter/config.yml, adjust the toggles to your liking, and restart the server to apply the changes!

💻 Compatibility

Supported Versions: Minecraft 1.21 and higher.

Software: Spigot, Paper, Purpur, and any other Paper forks.