Minecraft-Plugin Shopkeepers

🔌 Über Shopkeepers

Shopkeepers ist ein Minecraft-Plugin für Bukkit/Spigot, mit dem Serverbesitzer anpassbare Dorfbewohner-Händler platzieren können, die konfigurierte Gegenstände zu festgelegten Preisen verkaufen. Das Plugin unterstützt sowohl Admin-Shops (unbegrenzter Bestand) als auch Spieler-Shops, die ihren Bestand aus einem Container beziehen, und stellt eine ShopkeepersAPI für Add-on-Integration und Erweiterungen bereit.

🎯 Zweck

Das Plugin bietet ein NPC-basiertes Shopsystem im Spiel, damit Server persistente Shops ohne manuelle Truhenverwaltung oder komplexe befehlsbasierte Läden anbieten können. Es eignet sich für Server-Ökonomien, Rollenspiel-Shops und Survival/SMP-Server, die NPC-Händler möchten. ()

⚙️ Funktionen

• Eigene Dorfbewohner-Händler mit festgelegten Trades und Preisen erstellen.
• Admin-Shops mit unendlichem Vorrat.
• Spieler-Shops, die Items aus einem verbundenen Container (Truhe) für den Bestand ziehen.
• ShopkeepersAPI für Plugin-Autoren, um Händler programmgesteuert abzufragen und zu verwalten.
• Anpassung von Items/Item-Daten im Spiel und Unterstützung für Sprachdateien über das Wiki und die Sprachdateien des Projekts. ()

🧩 Für wen es ist

• Survival- und SMP-Server, die von NPCs betriebene Shops wollen.
• Rollenspiel- oder Wirtschaftsserver, die Dorfbewohner-NPCs als Händler nutzen.
• Plugin-Entwickler, die eine API benötigen, um Shop-Verhalten in andere Systeme zu integrieren. ()

🏗️ Beispielanwendungen

• Ein Admin erstellt einen unbegrenzten Admin-Shop, der vom Server bereitgestellte Waren verkauft.
• Ein Spieler eröffnet einen Shop, der automatisch Items aus einer verknüpften Truhe verkauft.
• Ein Entwickler baut ein Add-on, das Händler mithilfe der ShopkeepersAPI auflistet oder verändert. ()

⌨️ Befehle

(Hinweis: Oben sind nur die Befehle aufgeführt, die von offiziellen Quellen ausdrücklich dokumentiert sind.) ()

⚙️ Installation

📥 Einrichtung

• Lade die offizielle Plugin-JAR herunter und lege sie in den Ordner plugins/ deines Servers.
• Starte den Server neu und prüfe die Serverkonsole, um zu bestätigen, dass das Plugin geladen wurde.

(Das sind die standardmäßigen Installationsschritte für Bukkit/Spigot-Plugins und sie werden durch die Projektdokumentation unterstützt.) ()

🧠 Technische Hinweise

• Shopkeepers wird unter der GPL-3.0-Lizenz veröffentlicht, und das Projekt-Repository enthält ein API-Modul (ShopkeepersAPI) sowie Build-Anweisungen. ()
• Das Projekt stellt Maven-Artefakte und eine veröffentlichte API für Add-on-Entwickler bereit; die README dokumentiert die Nutzung des Repositories und die Abhängigkeitskoordinaten der API. ()
• Offizielle Verteilung und Community-Support sind über die Spigot-Ressourcenseite und den Discord-Server des Plugins verfügbar. ()

🤝 Wann dieses Plugin nützlich ist

Wenn du persistente, konfigurierbare NPC-Händler mit Unterstützung für Admin- und Spieler-Shops brauchst und eine API möchtest, um Shops in andere Plugins zu integrieren, bietet Shopkeepers eine bewährte Implementierung für Bukkit/Spigot-Server. ()