StackablePotions

# StackablePotions

**Stack potions up to 64 — Save inventory space!**

Tired of potions cluttering your entire inventory? This plugin is your solution!

---

## ✨ Features

- **Potion Stacking** — Stack potions up to 64 items
- **Manual Stacking** — Pick up a potion and click on another identical one
- **Auto-stack on Pickup** — Potions automatically merge into existing stacks
- **Auto-stack on Inventory Open** — Potions organize themselves automatically
- **Multi-language Support** — English, German, French, Spanish, Polish, Russian
- ⚙️ **Fully Configurable** — Customize everything via config
- **All Potion Types** — Regular, Splash, and Lingering potions
- **Strict Matching** — Only identical potions stack together
- **Lightweight** — No dependencies, minimal server impact

---

## Supported Languages

| Code | Language |
|------|----------|
| en | English |
| de | Deutsch |
| fr | Français |
| es | Español |
| pl | Polski |
| ru | Русский |

Change language in-game using the command system

---

## Commands

| Command | Description |
|---------|-------------|
| /sp | Show help menu |
| /sp reload | Reload configuration |
| /sp info | Display current settings |
| /sp stack | Manually stack potions in inventory |
| /sp lang | Change language |

**Aliases:** /stackablepotions, /spotions, /stackpotions

---

## Permissions

| Permission | Description | Default |
|------------|-------------|---------|
| stackablepotions.use | Use potion stacking | Everyone |
| stackablepotions.reload | Reload config and change language | OP |

---

## ⚙️ Configuration

The plugin is fully configurable through the config file. You can customize:

- Language selection (en, de, fr, es, pl, ru)
- Maximum stack size (1-64)
- Enable or disable splash potions stacking
- Enable or disable lingering potions stacking
- Auto-stack when picking up items from ground
- Auto-stack when opening inventory
- Strict matching mode (same effects, name, lore)
- List of allowed potions to stack

All settings have detailed comments in the configuration file.

---

## How to Use

### Method 1 — Manual Stacking:
1. Pick up a potion (click on it)
2. Left-click on another identical potion
3. They will merge into one stack!

### Method 2 — Command:
1. Type `/sp stack` in chat
2. All identical potions in your inventory will automatically merge

### Method 3 — Automatic:
- Potions automatically stack when picked up from the ground
- Potions automatically merge when you open your inventory
- Both features can be enabled or disabled in config

---

## Installation

1. Download StackablePotions.jar file
2. Place it in your server's plugins folder
3. Restart the server
4. Configure settings in plugins/StackablePotions/config.yml
5. Change language with `/sp lang` command if needed
6. Use `/sp reload` to apply configuration changes

---

## Compatibility

- **Minecraft:** 1.21 and above
- **Platform:** Paper, Purpur, Folia
- **Java:** 21 or higher
- **Dependencies:** None required

---

## ❓ Frequently Asked Questions

**Q: Do stacked potions work normally?**
A: Yes! Each potion is consumed individually when used. Stacking only affects inventory storage.

**Q: Can I stack custom potions from other plugins?**
A: Yes, if strict-matching is enabled in config, only potions with identical properties will stack together.

**Q: Does this work with splash and lingering potions?**
A: Yes! Both types can be enabled or disabled independently in the configuration.

**Q: Is this compatible with other inventory plugins?**
A: Yes, StackablePotions uses standard Bukkit/Spigot events and is compatible with most plugins.

**Q: Will this cause lag on my server?**
A: No! The plugin is lightweight with minimal performance impact.

---

## Updates & Support

This plugin is actively maintained and updated for the latest Minecraft versions.

**Need help?**
- Check the documentation
- Report issues on the project page
- Join the community discussion

---

Made with ❤️ Grib for the Minecraft community