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.

• ✅ Compatibility
  Works with Bukkit/Folia/Paper/Purpur/Spigot 1.20+ 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 per-player item limits, 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 — effects are optional)

• /ic reset (item)
  (Resets the current count of a specific item back to 0, or resets all items 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)

• /ic tag (player) (item) (ammount)
  (Manually tags an untagged item in any player inventory)

---

🔑 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
• ItemCap.tag — Manually tag items
• OPs have all permissions

---

🌍 Translated Languages

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

---

Debugging

ItemCap uses FastStats platform, you can disable this feature in plugins/faststats/config.properties in enabled=false

---

🤝 Join the Community

Have questions, need help, or want to share feedback and suggestions?
Join the ItemCap community 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