Potion Forge

Potion Forge is a brewing enhancement plugin that allows server administrators to upgrade brewed potion durations and potion amplifier levels beyond vanilla limits. All potion configurations can be adjusted visually using the in-game GUI editor without restarting the server.

Supported Platforms

Minecraft Version: 1.20 through 1.21+
Server Engines: Spigot, Paper, Purpur, Folia

Core Features

In-Game GUI Editor: Open /pf to browse all potion types (Strength, Speed, Invisibility, Regeneration, etc.) and edit their brewing results with visual click controls.
Duration & Amplifier Customization: Increase potion lengths (e.g. Strength II lasting 8 minutes instead of 1:30) or unlock higher amplifier tiers (Level III, IV, etc.).
Zero Client Mods: Fully compatible with vanilla brewing stands and vanilla Minecraft clients.
Automatic Stand Hook: Intercepts brewing stand completion events to apply configured overrides dynamically.

Commands and Permissions

Command	Purpose	Permission
`/potionforge`	Open the interactive potion configuration GUI	`potionforge.gui`
`/potionforge reload`	Reload configuration from disk	`potionforge.reload`

Aliases

/pf, /pforge

Key Permissions

potionforge.gui: Allows opening the PotionForge settings GUI.
potionforge.reload: Allows reloading the plugin configuration.
potionforge.set: Allows modifying and saving potion overrides.
potionforge.info: Allows inspecting specific potion configuration nodes.

Configuration Reference

The configuration file is located at plugins/PotionForge/config.yml:

# =====================================================
#             PotionForge Configuration
# =====================================================
# Only potions configured below are modified.
# Unlisted potions brew according to standard vanilla rules.
#
# Key format:
#   <EFFECT>_1       = Base potion (e.g. STRENGTH_1)
#   <EFFECT>_2       = Amplified potion (e.g. STRENGTH_2)
#   <EFFECT>_1_LONG  = Extended duration potion (e.g. SPEED_1_LONG)

potions:
  STRENGTH_2:
    enabled: true
    amplifier: 1 # 0 = Level I, 1 = Level II, 2 = Level III
    duration-seconds: 480 # 8 minutes

  SPEED_2:
    enabled: true
    amplifier: 1
    duration-seconds: 300 # 5 minutes

  INVISIBILITY_1_LONG:
    enabled: true
    amplifier: 0
    duration-seconds: 900 # 15 minutes