ItemStacker Plugin Documentation
This documentation provides detailed information on how to install, configure, and use the ItemStacker plugin for Minecraft (Spigot/Paper 1.20+).

Installation Guide
1️⃣ Download the Plugin

• Download the latest version of ItemStacker.jar.

2️⃣ Upload to Your Server

• Place ItemStacker.jar into your plugins/ folder.

3️⃣ Restart Your Server

• Start or restart your Minecraft server to load the plugin.

4️⃣ Edit Configuration (Optional)

• Open stacks.yml in the plugins/ItemStacker/ folder to configure item stacking.

5️⃣ Save & Restart

• Save any changes and restart your server.

⚙ Configuration (stacks.yml)
The stacks.yml file controls which items can be stacked.

Default Configuration Example:
IRON_INGOT: false
DIAMOND: false
NETHERITE_INGOT: false
GOLD_INGOT: false

How to Enable Stacking?
To enable stacking for an item, set it to true.

IRON_INGOT: true
DIAMOND: true

• ✅ Items with true will automatically stack when dropped.
• ❌ Items with false will remain separate.

Important Notes:

• Only stackable items can be configured (e.g., blocks, ingots, etc.).
• Enchantments and custom item metadata will not be merged.

How It Works

1. When an item is dropped, ItemStacker checks if another similar item is nearby.
2. If stacking is enabled for that item in stacks.yml, the two items merge into one.
3. If stacking is disabled, the item remains separate.
4. The plugin automatically updates the amount displayed above the stacked item.

❌ Commands & Permissions

• No Commands Required! The plugin runs automatically.
• No Permissions Needed! Works for all players without special permissions.

Troubleshooting & FAQ
❓ Why aren't my items stacking?
✔ Check stacks.yml to see if the item is enabled.
✔ Make sure you're using Spigot/Paper 1.20+.
✔ Restart the server after making changes.

❓ Does this work with modded items?
❌ No, this plugin only supports vanilla Minecraft items.

❓ Will items with custom names or enchantments stack?
❌ No, only identical items (without enchantments or custom names) will stack.

Support & Donations
Need help? Join our support Discord: https://discord.gg/fXXV5wSzVR
Want to support development? Donations are appreciated: https://discord.gg/fXXV5wSzVR

ItemStacker – Keep your server clean and optimized!