ItemCap

ItemCap Plugin ⚖️

ItemCap is a lightweight but powerful Minecraft plugin focused on keeping your server fair and balanced by limiting how many specific items players can craft or own. It is ideal for competitive environments, helping prevent hoarding of powerful or rare items such as god apples, maces, or other end-game resources.

Designed with flexibility and performance in mind, ItemCap gives server administrators full control while remaining easy to configure and maintain.

---

✨ Key Features

- 🧮 Global & Per-Player Item Limits Restrict how many of an item can exist server-wide or per player to prevent monopolies and abuse.

- 🔄 Smart Item Tracking Automatically tracks crafting, pickups, inventory changes, and item destruction (despawn, void, lava, etc.) to keep limits accurate.

- 👤 Per-Player Limit System Define individual caps per item, ensuring each player can only own a specific amount, regardless of total server count.

- 🖥️ Admin GUI Management Manage item limits, effects, and player data through an intuitive in-game menu.

- 🔐 Permissions & Commands Fine-grained permission control with simple commands and fast config reloads.

- ⚔️ Perfect for Survival, Factions & Minigames Helps maintain balanced economies, fair PvP, and healthier gameplay progression.

- ✅ Bukkit/Folia/Paper/Purpur/Spigot 1.20–1.21+ Works with Bukkit/Folia/Paper/Purpur/Spigot 1.20–1.21+ and is fully configurable via `config.yml`.(tested versions)

Prevent endless fights and resource monopolies. Keep your server fair, competitive, and fun. 🛡️

---

ℹ️ Per-Player Limit Setup Notice

To use enable/edit the per-player limit, you must first: 1. Set the item using `/ic set (item) (ammount)` *(or any desired global amount)* 2. Open `/ic menu` and enable/edit the per-player limit for that item inside the GUI.

Per-player limits will not apply unless the item is registered first. Be advised that -1 means unlimited, and its the default setting for per-player limit

---

📜 Commands *(use `/itemcap` or `/ic`)*

- `/ic reload` (Reloads the plugin configuration)

- `/ic set (item) (amount) (effect) (amplifier)` (Sets a max cap for an item, -1 means unlimited — %%MD0%%)

- `/ic reset (item)` (Resets the current count of a specific item back to 0, or resets %%MD0%% by using `all`)

- `/ic check` (Shows limited items, availability, max caps, and previous leak data)

- `/ic menu` (Opens the admin GUI for item & effect management and plugin reloads)

- `/ic help` (Displays the command list)

- `/ic version` (Shows the plugin version)

- `/chesttracktest` (Debug command to test tracker warning messages)

---

🔑 Permissions

- `ItemCap.reload` — Reload plugin configs - `ItemCap.check` — View current limited items and their status - `ItemCap.set` — Set or modify item caps - `ItemCap.reset` — Reset an item’s current cap - `ItemCap.chesttracktest` — Use chest tracking debug command - `ItemCap.version` — Check plugin version - `ItemCap.admin` — Access the admin GUI (`/ic menu`) - `ItemCap.bypass.ender` — Bypass Ender Chest item restrictions - OPs have all permissions

---

🌍 Translated Languages

- English (en) - German (de) - Spanish (es) - French (fr) - Polish (pl) - Russian (ru) - Turkish (tr) - Portuguese (pt)

---

🤝 Join the Community

Have questions, need help, or want to share feedback and suggestions? Join the Links via the links provided in the Links section on the right.

You can: - 💬 Get support and troubleshooting help - 🐞 Report bugs or issues - 💡 Suggest new features or improvements - 📢 Stay updated with announcements and changes