Was ShopGUI+ ist

ShopGUI+ ist ein Server-Plugin, das klassische Schilder-Shops (ChestShop, QuickShop) durch eine vollständige grafische Oberfläche ersetzt. Ein Spieler gibt /shop ein, es öffnet sich ein Menü mit Kategorien (Blöcke, Essen, Waffen, Werkzeuge und so weiter), und er wählt eine Kategorie und dann ein bestimmtes Item zum Kaufen oder Verkaufen.

Es ist ein kostenpflichtiges Plugin auf SpigotMC und für Admin-Shops gedacht: Der Admin legt Sortiment und Preise fest, die Spieler kaufen und verkaufen nur. ShopGUI+ unterstützt keine Spielershops (dafür brauchst du weiterhin QuickShop Hikari oder ChestShop).

Das Plugin gibt es auf SpigotMC. Es benötigt Vault und ein beliebiges Economy-Plugin (EssentialsX, CMI, CoinsEngine). Optional unterstützt es PlaceholderAPI.

Oberfläche und Kategorien

Das Menü von ShopGUI+ hat zwei Ebenen:

Hauptmenü - eine Liste der Kategorien (zum Beispiel Blöcke, Waffen, Werkzeuge, Essen, Dekoration). Jede Kategorie hat im Menü ein eigenes Symbol.
Kategoriemenü - eine Liste von Items mit Kauf- und Verkaufspreisen. Der Spieler kauft per Linksklick und verkauft per Rechtsklick.

Ein Klick auf ein Item öffnet ein Fenster zur Auswahl der Menge: 1, 8, 16, 32, 64 oder eine eigene Menge. Der Spieler sieht die Gesamtkosten, bevor er die Transaktion bestätigt. Alles läuft in der GUI ab: keine eingetippten Befehle und keine Schilder in der Spielwelt.

Der Admin legt Kategorien und Waren in YAML-Dateien im Ordner plugins/ShopGUIPlus/shops/ fest. Jede Kategorie ist eine eigene Datei, was auf Servern mit großem Sortiment für Ordnung sorgt.

Shop-Konfiguration

Ein Beispiel für die Konfiguration einer Kategorie in plugins/ShopGUIPlus/shops/blocks.yml:

shop:
  name: "Blocks"
  icon:
    material: GRASS_BLOCK
  items:
    stone:
      material: STONE
      buyPrice: 5.0
      sellPrice: 2.5
      slot: 0
    oak_log:
      material: OAK_LOG
      buyPrice: 8.0
      sellPrice: 4.0
      slot: 1
    cobblestone:
      material: COBBLESTONE
      buyPrice: 3.0
      sellPrice: 1.5
      slot: 2

Jedes Item hat einen Kaufpreis (buyPrice), einen Verkaufspreis (sellPrice) und eine Position im Menü (slot). Du kannst auch nur einen der beiden Preise festlegen: Lässt du sellPrice weg, können Spieler dieses Item nicht verkaufen.

ShopGUI+ unterstützt außerdem Befehle als Ware: Der Admin kann ein Produkt anlegen, das beim Kauf einen Befehl auf dem Server ausführt (zum Beispiel einen Rang, ein Kit oder einen Effekt vergibt). Das ist praktisch, um Dienste und Vorteile ohne physische Items zu verkaufen.

Dynamische Preise

ShopGUI+ hat ein eingebautes System für dynamische Preise nach Angebot und Nachfrage. Kaufen Spieler ein Item in großen Mengen, steigt sein Preis. Verkaufen sie in großen Mengen, sinkt der Preis. Das ist ein natürlicher Mechanismus, der den Markt ausgleicht.

Die Konfiguration der dynamischen Preise in der config.yml:

dynamicPricing:
  enabled: true
  maxBuyMultiplier: 2.0      # Kaufpreis max. 2x Grundpreis
  minBuyMultiplier: 0.5      # Kaufpreis min. 0,5x Grundpreis
  maxSellMultiplier: 2.0     # Verkaufspreis max. 2x Grundpreis
  minSellMultiplier: 0.5     # Verkaufspreis min. 0,5x Grundpreis
  resetInterval: 24          # Preise alle 24 Stunden zurücksetzen

Dynamische Preise sind optional. Viele Server setzen auf feste Preise, damit die Spieler wissen, was sie zahlen. Schalte diese Funktion nur auf Servern mit vielen Transaktionen ein, auf denen Preisschwankungen wirtschaftlich Sinn ergeben.

Befehle und Berechtigungen

Befehl	Beschreibung	Berechtigung
`/shop`	Öffnet das Shop-Hauptmenü	shopguiplus.shop
`/shop [category]`	Öffnet eine bestimmte Kategorie	shopguiplus.shop
`/sell hand`	Verkauft das Item in deiner Hand	shopguiplus.sell.hand
`/sell all`	Verkauft alles in deinem Inventar	shopguiplus.sell.all
`/sellgui`	Öffnet die Verkaufs-GUI (Items hineinlegen)	shopguiplus.sellgui
`/shopreload`	Lädt die Konfiguration neu	shopguiplus.reload

Die Berechtigungen von ShopGUI+ verwaltest du über LuckPerms. Mit den Berechtigungen shopguiplus.shop.[category] kannst du den Zugriff auf bestimmte Kategorien pro Rang einschränken.

Tipps für Admins

Verkaufspreise immer niedriger als Kaufpreise ansetzen - setze sellPrice auf 40-60 % von buyPrice. So verhinderst du Exploits, bei denen ein Spieler etwas kauft und sofort mit Gewinn weiterverkauft.
/sell all auf Skyblock-/Prison-Servern nutzen - Spieler, die große Mengen Ressourcen farmen, freuen sich, wenn sie ihr ganzes Inventar mit einem Befehl verkaufen können.
Getrennte Shops pro Welt - ShopGUI+ unterstützt in jeder Welt ein anderes Sortiment. Praktisch auf Servern mit mehreren Spielmodi.
Anbindung an Ranglisten - zeige mit PlaceholderAPI die besten Händler in Ranglisten an.
Das Sortiment nicht übertreiben - 50-100 Produkte reichen. Ein zu großer Shop überfordert die Spieler und ruiniert eine Economy, die auf dem Handel zwischen Spielern aufbaut.

Verwandte Artikel: Vault, EssentialsX, QuickShop Hikari, Plugin-Katalog.