Minecraft-Plugin QuickShop-Hikari

🔌 Über QuickShop-Hikari

QuickShop-Hikari ist ein Minecraft-Plugin, das kistenbasierte Kauf-/Verkaufs-Shops (ChestShops) implementiert. Spieler erstellen und nutzen Shops durch Interaktion mit Truhen; für das meiste Gameplay sind keine Befehle nötig. Das Projekt wird von der QuickShop-Community gepflegt und konzentriert sich auf moderne Kompatibilität, Datensicherheit und erweiterbare Integrationen.

🎯 Zweck

Eine im Spiel integrierte, itembasierte Wirtschaft bereitstellen, in der Spieler Gegenstände zum Verkauf anbieten oder Kauf-Shops mit Truhen erstellen können. Das Plugin richtet sich an Server-Administratoren, die eine physische, truhenbasierte Wirtschaft und Shop-spezifische Kontrolle möchten, ohne Spieler zum Erlernen von Befehlen zu zwingen.

⚙️ Funktionen

• Kauf- und Verkaufsshops mit Truhen und Schildern erstellen (kistenbasierte Shops).
• Unterstützung für NBT-Daten, Verzauberungen, Item-Schaden, Trankdaten und Mob-Eier.
• Umschaltbares virtuelles Anzeigeobjekt über Shops (ProtocolLib oder PacketEvents unterstützt).
• Unterstützung für unbegrenzte Truhen und gemischtes Kauf-/Verkaufsverhalten bei Doppelkisten.
• Blacklist-Unterstützung mit Optionen für Umgehungsberechtigungen.
• Berechtigungsverwaltung pro Shop und Shop-Vorteile zwischen Besitzern und anderen Spielern.
• i18n-Unterstützung für Item- und Verzauberungsnamen sowie MiniMessage-Syntax für Nachrichten.
• Unterstützung für H2 (lokal) und MySQL (remote) als Datenquelle.
• Integrations-Hooks für gängige Schutz- und Utility-Plugins (Kompatibilitätsmodule verfügbar).
• Entwickler-API (Maven-/Gradle-Koordinaten angegeben) zum Abfragen von Shops und Integrieren von Funktionen.
• bStats-Telemetrie mit Opt-out über die Konfiguration.

🧩 Für wen es gedacht ist

Serverbesitzer und Administratoren, die Survival/SMP oder auf Wirtschaft ausgerichtete Server betreiben und einen physischen, truhenbasierten Marktplatz möchten. Es eignet sich für kleine bis große Server mit Vault-kompatiblen Economy-Plugins und dem Wunsch nach Shop-spezifischer Kontrolle und datenbankgestütztem Speicher.

🏗️ Beispielanwendungen

• Spieler legen Gegenstände in eine Truhe und beschriften sie, um Stapel automatisch an andere Spieler zu verkaufen.
• Ein Admin aktiviert Shop-spezifische Berechtigungen, damit Moderatoren Shops in bestimmten Welten oder Regionen verwalten können.
• Ein Netzwerk nutzt MySQL-Speicher, damit Shops serverübergreifend persistent bleiben.

⌨️ Befehle

Hinweis: Die Projekt-Dokumentation sagt, dass normales Spieler-Gameplay keine Befehle erfordert; Befehle sind hauptsächlich für die Verwaltung gedacht.

🔐 Berechtigungen

⚙️ Installation

📥 Einrichtung

• Lade das offizielle QuickShop-Hikari-Jar aus der Projektdistribution herunter (Modrinth/Spigot/GitHub-Releases).
• Lege die Jar-Datei in den Ordner plugins/ deines Servers.
• Starte den Server und prüfe, ob das Plugin geladen wurde (die Doku zeigt, dass der Befehl qs in der Konsole ausgeführt wird, um die Hilfe/Testausgabe anzuzeigen).

📦 Abhängigkeiten

Vom Projekt bestätigte erforderliche/optionale Integrationen:

• Vault (erforderlich für die Economy-Anbindung)
• Ein Vault-kompatibles Economy-Plugin (vom Projekt genannte Beispiele)
• ProtocolLib oder PacketEvents (erforderlich für virtuelle Anzeigeobjekte / spielerspezifische Lokalisierung)
• LuckPerms (empfohlen für die Berechtigungsverwaltung)

🧾 Konfiguration

• Das Plugin erstellt und verwendet eine config.yml (die Doku verweist auf config.yml-Schlüssel für Anzeigeprotokoll und Datenschutzeinstellungen).
• Der Datenspeicher unterstützt lokales H2 oder remote MySQL; Konfigurationsoptionen sind in den Plugin-Konfigurationsdateien verfügbar.

🧠 Technische Hinweise

• Die offizielle Dokumentation empfiehlt den Betrieb auf einem Paper-basierten Server und dokumentiert die Anforderung von Java 21.
• Das Projekt stellt eine Entwickler-API und Maven-/Gradle-Koordinaten für die Verwendung zur Compile-Zeit bereit.
• QuickShop-Hikari liefert Kompatibilitätsmodule für Drittanbieter-Plugins (z. B. WorldGuard, WorldEdit, OpenInv) als optionale Downloads.
• Telemetrie: nutzt bStats; Opt-out über die Konfiguration möglich.

🤝 Wann dieses Plugin nützlich ist

Wenn du einen truhenbasierten, spielerorientierten Marktplatz mit persistentem Speicher und Shop-Kontrollen möchtest (statt nur GUI- oder befehlsgesteuerter Shops), bietet QuickShop-Hikari eine moderne, datenbankgestützte Implementierung mit Hooks für gängige Economy- und Schutz-Plugins.