Minecraft-Plugin EconomyShop

🔌 Über EconomyShop

EconomyShop ist ein Minecraft-Plugin, das einen Server-Shop (GUI) und Spieler-Kistenshops umsetzt. Der Fokus liegt auf inventarbasierten Menüs im Browser-Stil zum Kaufen und Verkaufen sowie auf von Spielern erstellten Kistenshops mit Kiste-+Schild-Setup und einer Editor-GUI. Das Plugin ist Teil des ilius Economy-Ökosystems und für Server gedacht, die einen serverseitigen Shop mit konfigurierbaren Preisen, Steuern und Verlaufserfassung benötigen.

🎯 Zweck

EconomyShop bietet ein zentrales, GUI-orientiertes Handelssystem, damit Serverbetreiber administrative Shops bereitstellen und Spielern erlauben können, Kistenshops ohne Chat-Befehle oder manuelle Schildformatierung zu erstellen und zu verwalten. Es richtet sich an Server mit einer Vault-kompatiblen Economy und dem Wunsch nach integriertem Preisverlauf, Steuern und Administrationskontrollen für die Shop-Verwaltung.

⚙️ Funktionen

• GUI-basierter Server-Shop: Kategorien durchsuchen, Mengen auswählen und Bestätigungsfenster vor dem Kauf.
• Rückverkauf-Unterstützung: Shop-Items per Rechtsklick an den Server verkaufen, inklusive Steuer und Bestätigung.
• Spieler-Kistenshops: Shops durch Platzieren einer Kiste und eines Schilds erstellen; Preise und Änderungen werden über eine GUI verwaltet.
• Lageroptionen: unbegrenzter oder begrenzter Bestand mit automatischer Nachfüllung für Admin-Shops.
• Verkaufssteuer: konfigurierbare Transaktionssteuer für Verkäufe im Server- und Kistenshop.
• Preisverlauf: gemeinsame Preisdiagramme (7-, 14- und 30-Tage-Ansichten), die Admin-Shop-, Kistenshop- und Auktionsverkäufe kombinieren.
• Admin-GUI: Kategorien erstellen, Items hinzufügen und Shop-Einstellungen über Menüs bearbeiten (für grundlegende Abläufe ist keine manuelle Config-Bearbeitung nötig).
• Speicher: standardmäßig SQLite, optional mit MySQL/MariaDB-Unterstützung für größere Skalierung.
• Integrationen: Vault-kompatible Economy-Unterstützung, PlaceholderAPI-Platzhalter sowie optionale Integrationspunkte für LuckPerms und WorldGuard.
• Anti-Exploit-Maßnahmen: Transaktionssperren, Duplikationsschutz, Blockierung im Kreativmodus und Rate-Limiting.

🧩 Für wen es gedacht ist

• Survival- und SMP-Server, die ein Shop-Erlebnis mit GUI wollen.
• Server, auf denen Spieler ihre eigenen Kistenshops mit minimalem Verwaltungsaufwand betreiben sollen.
• Server, die eine Vault-kompatible Economy verwenden und möglicherweise datenbankgestützten Speicher möchten.

🏗️ Beispielanwendungen

• Ein Admin konfiguriert Kategorien und füllt den Server-Shop über die Admin-GUI mit benutzerdefinierten Items und Preisen.
• Ein Spieler platziert eine Kiste und ein Schild, um einen Kistenshop zu öffnen, legt Kauf-/Verkaufspreise über die GUI fest und verkauft Items an andere Spieler.
• Server-Operatoren prüfen den Preisverlauf von Items, um die Preise im Admin-Shop oder die Besteuerung anzupassen.

⌨️ Befehle

🔐 Berechtigungen

⚙️ Installation

📥 Einrichtung

• Lade die Plugin-JAR herunter und lege sie in das Verzeichnis plugins/ deines Servers.
• Starte den Server neu, um das Plugin zu laden.
• Führe /shop admin mit einem Operator-Konto aus, um Kategorien zu erstellen und Items hinzuzufügen.

📦 Abhängigkeiten

• Erforderlich: Vault (beliebiges Vault-kompatibles Economy-Plugin).
• Optional/Integrationen: PlaceholderAPI, LuckPerms, WorldGuard, EconomyProvider, AuctionHouse.

🧠 Technische Hinweise

• Speicher: SQLite ist standardmäßig verfügbar; MySQL/MariaDB-Unterstützung ist für größere Server verfügbar.
• Plattformen: Das Plugin erklärt Unterstützung für Paper und listet außerdem Kompatibilität mit Purpur und Folia auf.
• Das Plugin enthält integrierte Anti-Exploit-Schutzmaßnahmen wie Transaktionssperren und Rate-Limiting.
• Teil des ilius Economy-Stacks und integriert sich mit anderen ilius-Plugins für eine konsistente Datenbank/Optik.

🤝 Wann dieses Plugin nützlich ist

Wenn dein Server einen admin-gesteuerten Server-Shop sowie Spieler-Kistenshops mit GUI-basierter Einrichtung, Preisverlauf und Vault-kompatibler Economy-Integration benötigt, bietet EconomyShop einen GUI-first-Workflow und Verwaltungswerkzeuge, um Shop-Items, Steuern und Speicher-Backends zu verwalten, ohne Schilder manuell zu parsen oder umfangreiche Config-Änderungen vorzunehmen.