Minecraft-Plugin ItemJoin

🔌 Über ItemJoin

ItemJoin ist ein Minecraft-Plugin, das Spielern automatisch stark konfigurierbare benutzerdefinierte Gegenstände gibt. Gegenstände können bei Ereignissen wie join, first-join, respawn, world-switch, region-enter und region-leave vergeben werden. Das Plugin konzentriert sich auf flexible Gegenstandsdefinitionen (itemflags), Trigger-Ereignisse und an Gegenstände gebundene Befehle, damit Server Lobby-Menüs, Starter-Kits oder kontextabhängige Werkzeuge ohne benutzerdefinierte Client-Mods bereitstellen können.

🎯 Zweck

ItemJoin löst das Problem, Spielern zuverlässig benutzerdefinierte oder interaktive Gegenstände zu geben, die an Server-Ereignisse und Welten gebunden sind. Es ist nützlich für Hub-/Lobby-Server, Minigame-Server, Survival-Netzwerke (in denen Gegenstände pro Welt begrenzt sein müssen) und Netzwerke, die menügesteuerte Gegenstände oder Gegenstände zum Ausführen von Befehlen benötigen.

⚙️ Funktionen

• Gegenstände über konfigurierbare Trigger vergeben: join, first-join, respawn, world-switch, region-enter/exit und ähnliche Ereignisse.
• Itemflags pro Gegenstand, die das Verhalten ändern (Slot, Überschreiben, Stapelregeln, Blockieren von Bewegung/Aufheben, Gamemode-Beschränkungen, Chance, den Gegenstand zu erhalten, Cooldowns).
• ItemCommands: Befehle an Gegenstände anhängen und den Ausführungskontext konfigurieren (console, player, server, message) sowie Aktionstypen (Links-/Rechtsklick, Inventarklick, physisch, Mehrfachklick).
• PlaceholderAPI-Integration für dynamische Gegenstandsnamen/Lores und Placeholder-Unterstützung.
• Unterstützung für benutzerdefinierte Spielerköpfe (eigene Texturen und Besitzer), Kartenbilder, Spitzpfeile, Bücher, Banner, Feuerwerk, Anpassung von Lederrüstung und benutzerdefinierte Verzauberungsstufen.
• Optional können Gegenstandsbewegung oder Aufheben in bestimmten Welten blockiert und Gegenstände nach IP-Adresse oder first-join-Status eingeschränkt werden.
• In-Game-GUI-Editor zum Erstellen von Gegenstandssätzen und ein integrierter Import-/Erstellungs-Workflow.
• API für andere Plugins: verfügbar unter me.RockinChaos.itemjoin.api.ItemJoinAPI.

🧩 Für wen ist es gedacht

• Server-Besitzer, die automatische Lobby-/Hub-Gegenstände oder Starter-Kits benötigen.
• Betreiber von Minigames und Netzwerken, die weltspezifische Gegenstände oder Menü-Kompass benötigen.
• Entwickler, die ein per API ankoppelbares Gegenstandssystem möchten.

🏗️ Beispielanwendungen

• Spielern beim Join einen Menü-Kompass geben, der beim Klicken unterschiedliche Befehle ausführt.
• Einmalige Starter-Kits beim first-join bereitstellen und gleichzeitig den Gegenstands-Transfer zwischen bestimmten Welten verhindern.
• Interaktive Gegenstände erstellen, die Economy-/Shop-Befehle mit Cooldowns und Kosten ausführen.

⌨️ Befehle

Hinweis: Diese Befehle und Unterbefehle stammen aus dem dokumentierten Befehlssatz des Plugins. Das Plugin stellt weitere Unterbefehle im Wiki und in der generierten Hilfeausgabe bereit.

🔐 Berechtigungen

Das Verhalten der gegenstandsspezifischen Berechtigungen ist konfigurierbar; die Berechtigungsprüfungen für Gegenstände sind standardmäßig deaktiviert und müssen in der Plugin-Konfiguration aktiviert werden, damit sie wirksam werden.

⚙️ Installation

📥 Einrichtung

• Lade die offizielle ItemJoin-JAR herunter und lege sie in den plugins/-Ordner deines Servers.
• Stelle sicher, dass sich in plugins/ keine doppelten ItemJoin-JAR-Dateien befinden (z. B. ItemJoin(1).jar).
• Starte den Server neu, damit das Plugin seine Konfiguration generieren und Funktionen für deine Serverversion registrieren kann.
• Prüfe die Konsolen-Logs des Servers auf eine Bestätigung des Plugin-Ladevorgangs und wirf für eine detaillierte Einrichtung einen Blick ins Plugin-Wiki.

📦 Abhängigkeiten

Das Plugin hat keine zwingenden Laufzeitvoraussetzungen, listet aber mehrere gängige Soft-Dependencies und Integrationen auf (optional und aktiv, wenn vorhanden):

• Vault
• AuthMe
• BetterNick
• HeadDatabase
• PlaceholderAPI
• SkinRestorerX
• TokenEnchant
• WorldEdit
• WorldGuard

Aktiviere oder konfiguriere Integrationen nach Bedarf; das Plugin funktioniert auch ohne diese, aber Funktionen wie Platzhalter, benutzerdefinierte Köpfe/Skins und Economy-Hooks hängen von den entsprechenden Plugins ab.

🧠 Technische Hinweise

• Plattformen: bestätigt für Spigot-basierte Server (Spigot, Bukkit, Paper, Purpur, Folia).
• Unterstützter/getesteter Minecraft-Bereich: 1.8 bis 1.21.
• Quellcode und Releases sind veröffentlicht, und das Projekt stellt eine API unter me.RockinChaos.itemjoin.api.ItemJoinAPI bereit, damit andere Plugins sich einklinken können.
• Lizenz: LGPL-3.0.

🤝 Wann dieses Plugin nützlich ist

Wenn du ein flexibles, konfigurierbares System brauchst, um Spielern kontextbezogene und interaktive Gegenstände bereitzustellen (Menüs, Starter-Kits, weltspezifische Werkzeuge) und eine API für Integrationen möchtest, bietet ItemJoin diese Funktionen mit Unterstützung für gängige Placeholder- und Skin-Plugins.