Minecraft-Plugin BanItem

🔌 Über BanItem

BanItem ist ein Minecraft-Plugin, das bestimmte Items und Item-Verhalten pro Welt blockiert oder auf eine Whitelist setzt. Es richtet sich an Serververwaltungs-Anforderungen, bei denen bestimmte Items daran gehindert werden müssen, benutzt, platziert, aufgehoben oder anderweitig interagiert zu werden. Das Projekt stellt eine Entwickler-API bereit und wird unter der GPL-3.0-Lizenz verteilt.

🎯 Zweck

BanItem wurde entwickelt, um Serverbetreibern eine fein abgestufte Kontrolle darüber zu geben, welche Items Spieler in welcher Welt verwenden können. Diese Kontrolle kann entweder als Blacklist (gelistete Items blockieren) oder als Whitelist (alles blockieren, außer ausdrücklich erlaubte Items) angewendet werden, und Berechtigungen können pro Welt und pro Item gesetzt werden.

⚙️ Funktionen

• Blacklist-Modus, um bestimmte Items und Optionen zu blockieren.
• Whitelist-Modus, um alle Items/Optionen zu blockieren, außer den konfigurierten erlaubten Einträgen.
• Konfiguration pro Welt, damit verschiedene Welten unterschiedliche Item-Regeln erzwingen können.
• Berechtigungen pro Welt, pro Item und mit granularen Berechtigungen pro Option.
• Unterstützung für benutzerdefinierte/modifizierte Items (Items, die anhand spezifischer Item-Daten/Meta erkannt werden).
• Leichte Implementierung, die nur die für die konfigurierten Optionen benötigten Listener aktiviert.
• Entwickler-API, mit der andere Plugins Bans programmgesteuert abfragen oder ändern können.
• Erfordert Java 1.8 und einen beliebigen Bukkit-basierten Server.

🧩 Für wen es gedacht ist

• Serverbesitzer und Administratoren, die bestimmte Items entfernen oder einschränken müssen.
• Survival- und SMP-Server, die übermächtige oder serverbrechende Items verhindern wollen.
• Netzwerkbetreiber, die mehrere Welten mit unterschiedlichen Item-Regeln verwalten.
• Plugin-Entwickler, die eine API benötigen, um mit Item-Bans zu arbeiten.

🏗️ Beispiel-Anwendungsfälle

• Verhindern, dass Spieler in Survival-Welten Elytra, Shulker Boxen oder Totems verwenden.
• Eine kleine Auswahl an Items in einer geschützten Minigame-Welt erlauben und alle anderen per Whitelist-Modus verbieten.
• Modifizierte/benutzerdefinierte Items blockieren, die von Client-Seiten-Mods hinzugefügt werden, auf Servern, die diese akzeptieren.
• BanItem über seine API mit einem anderen Verwaltungs-Plugin integrieren, um Regeln automatisch durchzusetzen.

⚙️ Installation

📥 Einrichtung

1. Bestätige, dass dein Server ein Bukkit-kompatibler Server und Java 1.8+ ausführt.
2. Lade das offizielle Plugin-JAR herunter und lege es in den plugins/-Ordner deines Servers.
3. Starte den Server neu und prüfe die Serverkonsole, um sicherzustellen, dass BanItem erfolgreich lädt.

📦 Abhängigkeiten

• Keine erforderlichen Plugin-Abhängigkeiten sind dokumentiert.
• Erfordert eine Bukkit-kompatible Server-Implementierung und eine Java-1.8- oder neuere Runtime.

🧾 Konfiguration

• Das Plugin ist pro Welt und pro Item konfigurierbar.
• Das Projekt bietet Konfigurationsoptionen für Blacklist-/Whitelist-Modi und pro-Item-Optionen; genaue Dateinamen und Schlüssel sind in der Projektdokumentation angegeben.

🧠 Technische Hinweise

• BanItem wirbt mit Unterstützung für jeden Bukkit-basierten Server; offizielle Releases werden für Spigot/Bukkit-Umgebungen bereitgestellt.
• Eine Entwickler-API ist verfügbar, damit andere Plugins programmgesteuert auf BanItem zugreifen können.
• Das Projekt ist Open Source unter der GPL-3.0-Lizenz.
• Zuletzt genannte Version: v3.8 (9. Juni 2026).

🤝 Wann dieses Plugin nützlich ist

Wenn du eine konsistente, weltweite Kontrolle darüber brauchst, welche Items von Spielern verwendet werden können, einschließlich Unterstützung für benutzerdefinierte/modifizierte Items, und eine API zur Integration, bietet BanItem eine leichtgewichtige Lösung mit Fokus auf Regeln zur Einschränkung pro Item und pro Welt.