Minecraft-Plugin zAuctionHouse

🔌 Über zAuctionHouse

zAuctionHouse ist ein Minecraft-Plugin, das ein voll ausgestattetes Auktionshaus bereitstellt, damit Spieler Gegenstände einstellen, durchsuchen und kaufen können. Der Fokus liegt auf Konfigurierbarkeit, GUI-basierten Oberflächen und Unterstützung mehrerer Wirtschaftssysteme. Das Projekt wird von GroupeZ-dev gepflegt, und Repository sowie Dokumentation zeigen eine V4-Neufassung, die auf modernes Java und Serverarchitekturen abzielt.

🎯 Zweck

zAuctionHouse löst das Problem des In-Game-Gegenstandshandels, indem es einen zentralen Marktplatz bereitstellt, auf dem Spieler Sofortkauf-Angebote erstellen, Mengenverkäufe durchführen und kategorisierte Inventare durchsuchen können. Es richtet sich an Server, die einen integrierten Marktplatz mit Admin-Auditing und optionaler Netzwerksynchronisierung benötigen.

⚙️ Funktionen

• Sofortkauf-Angebote (buy-it-now) und Bieter-Workflows, wo unterstützt.
• Mengenverkäufe: mehrere Gegenstände in einem einzigen Angebot verkaufen.
• Shulkerbox-Vorschau, damit Käufer den Inhalt vor dem Kauf prüfen können.
• Kategorienfilter, erweitertes Sortieren und Paginierung für große Angebotsmengen.
• Unterstützung für mehrere Ökonomien (Vault, PlayerPoints, CoinsEngine, itembasierte Währungen, XP/Level).
• Konfigurierbares Steuersystem und rechtebasierte Steuerermäßigungen.
• Automatische oder manuelle Geldabholung sowie Benachrichtigungen über Offline-Verkäufe.
• zMenu-Integration für vollständig anpassbare GUIs und Inventarvorlagen.
• Unterstützung für PlaceholderAPI und MiniMessage für formatierte Nachrichten und Platzhalter.
• Admin-Tools: Admin-Panel, Aktionsprotokolle, Transaktionshistorie, Gegenstandswiederherstellung und Befehle zur Cache-Verwaltung.
• Multi-Server-Synchronisierung über ein Redis-Addon mit verteilter Sperrung und Pub/Sub.
• Blacklist-/Whitelist-Steuerung für Gegenstände, Welteinschränkungen, Angebots- und Preisgrenzen sowie Transaktionssperren zur Vermeidung von Race Conditions.
• Discord-Webhook-Unterstützung für Verkaufsbenachrichtigungen mit konfigurierbarem Embed-Inhalt.

🧩 Für wen es gedacht ist

• Survival- und SMP-Server, die einen spielergesteuerten Marktplatz wollen.
• Skyblock-, Factions- und auf Ökonomie fokussierte Server, die Handelssysteme benötigen.
• Netzwerke, die synchronisierte Marktplätze über mehrere Backend-Server hinweg benötigen.
• Server-Administratoren, die Prüfprotokolle und Admin-Wiederherstellungstools brauchen.

🏗️ Beispielanwendungsfälle

• Spieler listen seltene Drops oder gecraftete Gegenstände zu einem Festpreis, damit andere Spieler sie sofort kaufen können.
• Ein Serverbetreiber setzt Steuerregeln und VIP-Steuerermäßigungen über Berechtigungen durch.
• Ein Multi-Server-Netzwerk synchronisiert Angebote und Verkäufe zwischen Hub- und Backend-Servern mithilfe des Redis-Addons.

⌨️ Befehle

(Die obigen Befehle stammen aus der offiziellen Projektdokumentation und den Quick-Start-Materialien des Repositories.)

🔐 Berechtigungen

(Nur die in der offiziellen Konfiguration und Dokumentation ausdrücklich erwähnten Berechtigungseinträge sind aufgeführt.)

⚙️ Installation

📥 Einrichtung

• Besorge dir die offizielle zAuctionHouse-JAR aus der Distribution des Projekts (offizielle Verkaufsseite oder Katalog).
• Lege die zAuctionHouse-JAR (und die erforderlichen Plugins) in das Verzeichnis plugins/ des Servers.
• Starte den Server neu und prüfe, ob das Plugin in der Server-Konsole initialisiert wird.
• Konfiguriere das Plugin über plugins/zAuctionHouse/config.yml und passe die GUI-Inventare in plugins/zAuctionHouse/inventories/ an.

📦 Abhängigkeiten

• Erforderlich: zMenu, PlaceholderAPI.
• Optionale / unterstützte Integrationen: Vault, LuckPerms und das zAuctionHouse-Redis-Addon für Multi-Server-Synchronisierung.

🧠 Technische Hinweise

• Das Projekt zielt auf modernes Java ab (die V4-Neufassung auf Java 21) und verwendet in seiner Architektur ein Repository-Pattern / ORM.
• Empfohlene Server-Software umfasst Paper und Paper-Forks; Folia und mehrere auf Paper basierende Forks werden als unterstützt aufgeführt.
• Offizielle Dokumentation und Distribution zeigen Unterstützung für Minecraft 1.20 bis 1.21+ (prüfe die Projektdokumentation auf die exakte Build-Kompatibilität, bevor du produktiv gehst).

❓ FAQ

• Gibt es eine kostenlose Version?
  Eine kostenlose Demo-Build ist verfügbar (das Projekt bietet auf einigen Plattformen eine kostenlose/Demo-Version an), während vollständige, unterstützte Releases über die Premium-Kanäle des Projekts verteilt werden.

🤝 Wann dieses Plugin nützlich ist

Wenn du einen konfigurierbaren, GUI-basierten Marktplatz mit Unterstützung für mehrere Ökonomien und optionaler Multi-Server-Synchronisierung benötigst, bietet zAuctionHouse eine gepflegte Auktionshaus-Implementierung zusammen mit Admin-Auditing und GUI-Anpassung über zMenu.