Mastering Server Potion Control with DisabledPotions
Potion effects can completely shift the balance of a Minecraft server. Whether it's a chaotic minigame, a survival world, or a competitive PvP arena, certain brews like instant damage or invisibility can cause more headaches than fun. The DisabledPotions plugin hands control back to server admins, allowing you to selectively disable any potion type—from drinkable and splash to dispenser-fired varieties—without touching a single vanilla game file.
What Is DisabledPotions?
DisabledPotions is a lightweight Bukkit/Spigot plugin that lets you blacklist specific potion effects across your entire server. If a player tries to drink a forbidden potion, throw a splash version, or even trigger one through a dispenser, the plugin instantly cancels the action and can optionally replace the item with something harmless. The result is a cleaner, more controlled gameplay experience without the need for complicated command block setups or region restrictions.
Key Features and Commands
Once installed, the plugin introduces a handful of intuitive commands, all accessible through the /dpotions base. Here is a quick overview:
- /dpotions – Displays the author and a list of all available commands. No special permission required.
- /dpotions version – Shows the current plugin version and config version. Permission:
disabledpotions.version. - /dpotions info – Lists every potion type, its active/disabled status, and the replacement item if that feature is enabled. Permission:
disabledpotions.info. - /dpotions reload – Reloads the configuration file on the fly, applying any changes without a server restart. Permission:
disabledpotions.reload.
All messages, including the prefix, permission-denied warnings, and the potion-blocked notification, are fully customizable inside the configuration. The default prefix &4--- [&bDisabledPotions&4] --- appears before every command output, while players who attempt to use a disabled potion will see &cYou can't use this potion.
Configuration Deep Dive
The heart of the plugin lies in its config.yml, which uses a simple true/false system for each potion effect at both level 1 and level 2. For example, you can disable Strength II while leaving Strength I untouched, or turn off Invisibility entirely. The list of controllable effects is extensive:
- INCREASE_DAMAGE (Strength)
- FIRE_RESISTANCE
- HARM (Instant Damage)
- HEAL (Instant Health)
- INVISIBILITY
- JUMP (Jump Boost)
- NIGHT_VISION
- POISON
- REGENERATION
- SLOW (Slowness)
- SPEED
- WATER_BREATHING
- WEAKNESS
Setting a potion to false immediately blocks its use. There is also a handy replacement item feature: when enabled, any disabled potion is swapped for an item of your choice (defined by its numeric ID). This prevents players from hoarding useless bottles and keeps inventories tidy. The version_config field is managed automatically by the plugin’s update system—do not edit it manually.
Managing Permissions with Precision
DisabledPotions uses a straightforward permission node structure, so you can delegate control to moderators without giving them full operator access. The reload permission is especially useful for quickly testing new potion restrictions during an event. A common setup might grant disabledpotions.info to all staff and reserve disabledpotions.reload for head admins. The plugin also handles console execution gracefully, displaying a “You should be a player!” message when a command can only be run in-game.
Getting the plugin onto your server is straightforward. You can grab the latest JAR from the developer’s page, and for those who like to manage everything from a unified dashboard, this mod can be easily installed via the foxygame.net launcher — a convenient, flexible, and modern Minecraft launcher where you can download mods right from the menu. Once the file is placed in your server’s plugins folder, a restart or /reload will generate the default configuration, and you can start tweaking potion rules immediately.
Why Every Server Admin Needs Potion Control
Without a dedicated tool, policing potions often means disabling entire brewing stands or writing fragile command block chains. DisabledPotions eliminates that overhead. It is particularly valuable for:
- PvP Arenas: Remove strength and healing potions to create fairer duels.
- Adventure Maps: Prevent players from breaking puzzles with invisibility or night vision.
- Roleplay Servers: Restrict magical effects that clash with a medieval theme.
- Survival Worlds: Temporarily disable harmful potions during community events.
The automatic update system, introduced in version 0.2, ensures you always run the latest build with minimal effort. Updates are downloaded into the plugins/update/ folder, ready to be applied at your convenience. Combined with the replace-item functionality, the plugin provides a seamless way to enforce potion rules without frustrating your players with broken items.
Conclusion
DisabledPotions transforms a complex administrative task into a few lines of configuration. Its granular control over every vanilla potion type, support for splash and dispenser interactions, and clear permission system make it an essential addition to any server where balance matters. Whether you are fine-tuning a competitive minigame or simply tired of invisible griefers, this plugin gives you the power to say exactly which brews are welcome—and which are not.