xH_PB Potion Box Plugin

A potion storage and management plugin designed for Minecraft servers. Store potions in a virtual warehouse and gain permanent potion effects based on the stored amount.

Features

• Potion Storage System: Store excess potions in a virtual warehouse to save inventory space
• Permanent Effect System: Automatically gain permanent potion effects of corresponding levels based on stored potion count
• GUI Management: Intuitive graphical interface supporting click-to-deposit/withdraw
• Batch Operations: Supports Shift+click for batch deposit/withdraw
• Highly Configurable: Effect level thresholds, maximum storage amounts, etc. are all customizable
• Data Persistence: Player data is automatically saved and will not be lost after server restart

Supported Potion Types

• Speed
• Strength
• Regeneration
• Fire Resistance
• Night Vision
• Water Breathing
• Jump Boost
• Resistance

Effect Level System

Level	Required Potion Count	Effect Level
I	5 bottles	Effect I
II	15 bottles	Effect II
III	30 bottles	Effect III

Thresholds can be customized in the configuration file

Installation

1. Download the xh_pb-0.0.1.jar file
2. Place the JAR file into the server's plugins folder
3. Restart the server or load the plugin
4. Edit plugins/xH_PB/config.yml for custom configuration (optional)

Usage

Open Potion Box

/xhpotionbox

Or use the shorthand:

/xhpb

Deposit Potions

1. Open the Potion Box GUI
2. Click potions from your inventory into the lower slots of the GUI
3. Potions will be automatically stored in the corresponding warehouse

Withdraw Potions

1. Open the Potion Box GUI
2. Click the potion icon in the upper slots
3. Left-click to withdraw one bottle, Shift+click to withdraw a stack (16 bottles)

View Effects

After storing enough potions, permanent effects will automatically take effect. You can view current effects in the game's effect bar.

Configuration File

# Potion Box GUI settings
potionbox:
  title: "&aPotion Box"
  size: 54
  shift-click-amount: 16
  max-storage-amount: 9999

# Allowed potion types
allowed-potions:
  - SPEED
  - STRENGTH
  - REGENERATION
  - FIRE_RESISTANCE
  - NIGHT_VISION
  - WATER_BREATHING
  - JUMP_BOOST
  - RESISTANCE

# Effect level threshold settings
effect-levels:
  SPEED:
    level-1: 5
    level-2: 15
    level-3: 30
  # ... other potion types

Permissions

Permission	Description
xhpb.use	Use the Potion Box command
xhpb.admin	Admin permissions (reload config, etc.)

Command List

Command	Description
/xhpotionbox	Open the Potion Box GUI
/xhpotionbox reload	Reload the configuration file (requires admin permission)

Technical Information

• Development Platform: Paper/Spigot 1.21+
• Java Version: Java 21
• Development Method: AI-assisted development

Copyright

Copyright (c) 2026 liyughj All rights reserved.

This plugin was developed with AI assistance.

This plugin is free to use and share, but without permission you may not:

• Decompile
• Claim it as your own work

The author is not responsible for any issues caused by using this plugin.

Contact

• GitHub: https://github.com/liyughj