Minecraft plugin BanItem

🔌 About BanItem

BanItem is a Minecraft plugin that blocks or whitelists specific items and item behaviours on a per-world basis. It targets server administration needs where particular items must be prevented from being used, placed, picked up, or otherwise interacted with. The project provides a developer API and is distributed under the GPL-3.0 license.

🎯 Purpose

BanItem exists to give server operators fine-grained control over which items players can use on each world. That control can be applied as either a blacklist (block listed items) or a whitelist (block everything except explicitly allowed items), and permissions can be applied per-world and per-item.

⚙️ Features

• Blacklist mode to block specified items and options.
• Whitelist mode to block all items/options except configured allowed entries.
• Per-world configuration so different worlds can enforce different item rules.
• Per-world, per-item permissions and per-option permission granularity.
• Support for custom/modded items (items identified by specific item data/meta).
• Lightweight implementation that activates only the listeners needed for configured options.
• Developer API for other plugins to query or modify bans programmatically.
• Requires Java 1.8 and any Bukkit-based server.

🧩 Who It Is For

• Server owners and administrators who need to remove or restrict specific items.
• Survival and SMP servers that want to prevent overpowered or server-breaking items.
• Network operators who manage multiple worlds with different item rules.
• Plugin developers who need an API to interact with item bans.

🏗️ Example Use Cases

• Preventing players from using elytra, shulker boxes, or totems on survival worlds.
• Allowing a small set of items in a protected minigame world while banning all others via whitelist mode.
• Blocking modded/custom items added by client-side mods on servers that accept them.
• Integrating BanItem with another administrative plugin via its API to enforce rules automatically.

⚙️ Installation

📥 Setup

1. Confirm your server runs a Bukkit-compatible server and Java 1.8+.
2. Download the official plugin JAR and place it into your server's plugins/ folder.
3. Restart the server and check the server console to ensure BanItem loads successfully.

📦 Dependencies

• No required plugin dependencies are documented.
• Requires a Bukkit-compatible server implementation and Java 1.8 or newer runtime.

🧾 Configuration

• The plugin is configurable per world and per item.
• The project provides configuration options for blacklist/whitelist modes and per-item options; exact file names and keys are provided in the project's documentation.

🧠 Technical Notes

• BanItem advertises support for any Bukkit-based server; official releases are provided for Spigot/Bukkit environments.
• A developer API is available so other plugins can access BanItem programmatically.
• The project is open-source under the GPL-3.0 license.
• Latest noted release: v3.8 (June 9, 2026).

🤝 When This Plugin Is Useful

If you need consistent, per-world control over which items are usable by players (including support for custom/modded items) and an API for integration, BanItem provides a lightweight solution focused on per-item and per-world restriction rules.