PotionLimiter: The Ultimate Brewing Restriction Plugin for Minecraft

PotionLimiter

Managing potion balance on a Minecraft server can be a constant headache. Whether you run a competitive PvP arena, a peaceful roleplay world, or a custom minigame network, certain potions can quickly ruin the experience. PotionLimiter is a lightweight, modern plugin built for Paper 1.21.1+ that puts you back in charge of every brewing stand on your server. With an intuitive configuration, world‑based restrictions, and beautiful in‑game notifications, it is the go‑to tool for server administrators who demand precision without performance overhead.

Why PotionLimiter Stands Out

Unlike generic anti‑cheat or all‑or‑nothing brewing bans, PotionLimiter lets you blacklist specific potion types down to their variants. You can block STRENGTH but allow LONG_STRENGTH, or disable every form of invisibility while keeping swiftness untouched. The plugin uses the updated 1.21 potion names (SWIFTNESS, HEALING, LEAPING, HARMING) and fully supports the new experimental effects like Wind Charged, Weaving, Oozing, and Infested. Everything runs on modern Java 21 with no NMS, so updates are smooth and future‑proof.

Key Features at a Glance

• Granular potion blacklisting – block any PotionType, including LONG and STRONG variants.
• World‑based control – use blacklist or whitelist mode to enable restrictions only where you need them.
• Ingredient preservation – when a brew is blocked, the ingredients stay in the stand; nothing is wasted.
• Player notifications – customizable MiniMessage alerts with gradients, hover text, and radius settings.
• Admin‑friendly commands – reload configs on the fly, list blocked potions, and enjoy full tab completion.
• Performance optimized – minimal memory footprint (under 5 MB) and negligible CPU impact.

How to Install PotionLimiter for Minecraft

Getting started is straightforward. First, make sure your server meets the requirements: you need Paper (or a fork like Purpur or Pufferfish) running Minecraft 1.21.1 through 1.21.11, and Java 21 or newer. Then follow these steps:

1. Download PotionLimiter – grab the latest .jar file from your trusted source.
2. Place the file into your server’s plugins/ folder.
3. Start or restart the server. The plugin will generate a default config.yml inside plugins/PotionLimiter/.
4. Open that config file, add the potion types you want to block, and adjust world settings.
5. In‑game, run /plimit reload to apply changes instantly – no full restart needed.

If you use the foxygame.net launcher, PotionLimiter appears right in the add‑on catalog, so you can install it with a single click and keep it automatically updated across all your server instances. That means you never have to worry about version mismatches or manual file transfers again.

World‑Based Brewing Management

One of the most powerful aspects of PotionLimiter is its per‑world logic. You can operate in two modes:

Blacklist Mode

Set blacklist-mode: true and list the worlds where the plugin should be disabled. For example, you might allow unrestricted brewing in a creative building world or a lobby, while keeping survival worlds locked down. Any world not on the blacklist will enforce the potion restrictions.

Whitelist Mode

Switch blacklist-mode: false and the listed worlds become the only places where PotionLimiter is active. This is perfect for a single survival world where you want strict control, leaving all other dimensions (like minigame arenas) completely open.

Commands and Permissions

PotionLimiter keeps administration simple with just a handful of commands, all accessible via /plimit:

• /plimit reload – reloads the configuration without restarting the server.
• /plimit list – displays every blocked potion and the current world restrictions.
• /plimit help – shows a quick reference of available commands.

Tab completion works out of the box, and all actions are logged clearly in the console, making troubleshooting a breeze.

Real‑World Configuration Examples

To give you a head start, here are a few common scenarios and the corresponding YAML snippets. All potion names follow the 1.21 convention – remember, SPEED is now SWIFTNESS, INSTANT_HEAL is HEALING, and so on.

Balanced PvP: Block Strength and Harming

blacklisted-potions:
  - STRENGTH
  - LONG_STRENGTH
  - STRONG_STRENGTH
  - HARMING
  - STRONG_HARMING

This prevents the most overpowered combat potions while leaving utility brews like fire resistance untouched.

Peaceful Roleplay: Disable All Harmful Effects

blacklisted-potions:
  - HARMING
  - STRONG_HARMING
  - POISON
  - LONG_POISON
  - STRONG_POISON
  - WEAKNESS
  - LONG_WEAKNESS
  - SLOWNESS
  - LONG_SLOWNESS
  - STRONG_SLOWNESS

Disable the New 1.21 Potions

blacklisted-potions:
  - WIND_CHARGED
  - WEAVING
  - OOZING
  - INFESTED

Player Notifications and MiniMessage Magic

When a player attempts a blocked brew, PotionLimiter can send a stylish message to everyone within a configurable radius. The plugin uses Kyori Adventure’s MiniMessage, so you can craft gradients, rainbows, bold text, and even hover tooltips. For instance:

blocked-message: "<gradient:#ff0000:#ffff00>⚠ This potion is banned!</gradient>"

You can also include the potion name dynamically with the <potion> placeholder, making every alert clear and informative.

Performance and Compatibility

PotionLimiter is built with a clean, dependency‑injected architecture that avoids NMS entirely. It hooks into the brewing recipe prediction system to cancel events before ingredients are consumed, so there is zero item loss. On a typical server, the plugin uses less than 5 MB of memory and has a CPU impact below 0.1%. It is fully compatible with Paper 1.21.1–1.21.11 and any Paper‑based fork, ensuring you can run it alongside your existing suite of plugins without conflict.

Final Thoughts

If you have ever wished for a simple, reliable way to control exactly which potions players can brew, PotionLimiter for Minecraft is the answer. Its world‑aware design, ingredient‑safe cancellation, and modern chat formatting make it a standout choice for server owners who value both balance and player experience. Download PotionLimiter today, drop it into your plugins folder, and take full command of your brewing stands.