Minecraft-Plugin AuctionHouse

🔌 Über AuctionHouse

AuctionHouse ist ein Minecraft-Plugin, das ein Auktionshaus im Spiel hinzufügt, auf das mit dem Befehl /ah zugegriffen werden kann. Spieler können Gegenstände zum Verkauf anbieten, Einträge durchsuchen und suchen und Gegenstände über einen GUI-basierten Markt kaufen. Das Plugin konzentriert sich auf den Handel zwischen Spielern mit konfigurierbaren Angebotsregeln, Gebühren und Ankündigungen.

🎯 Zweck

AuctionHouse bietet einen zentralen, GUI-gesteuerten Marktplatz, damit Server ein verwaltetes Auktionssystem anbieten können, statt sich auf von Spielern betriebene Shops oder schildbasierte Märkte zu verlassen. Es ist für Server gedacht, die einen durchsuchbaren öffentlichen Markt mit konfigurierbaren Einschränkungen und Wirtschaftsintegration wollen.

⚙️ Funktionen

• GUI-Auktionshaus, geöffnet mit /ah.
• Einträge erstellen und stornieren; stornierte oder abgelaufene Gegenstände abholen.
• Einträge nach Name, Typ, lore, enchants oder Verkäufer suchen und filtern.
• Einträge nach Zeit oder Preis sortieren.
• Steuerung der Angebote: Mindest-/Höchstpreise, Angebotsgebühren (pauschal und/oder prozentual), Verkäufersteuer mit Obergrenze und Abklingzeit zwischen Angeboten.
• Gegenstandsrestriktionen nach Name, Typ, lore, Verzauberungen, Schaden, unbreakable-Flag, custom_model_data und Regex-Mustern.
• Option, Server-Gegenstände aufzulisten (einmalige oder unbegrenzte Angebote).
• Spezielle Auslöser zum Öffnen der Auktion über Schilder, benannte Block-Entities (Truhen, Shulker, Dispenser usw.) oder benannte Entities mit benutzerdefiniertem Namen.
• Tooltips beim Darüberfahren zeigen verbleibende Zeit und enchants an.
• Optionale Ankündigungen für neue Einträge und Discord-Integration.
• Unterstützung für Internationalisierung sowie konfigurierbare Nachrichten, Materialien und Sounds.
• Transaktionsprotokollierung in einer separaten Logdatei und automatische Bereinigung verlassener Gegenstände.

🧩 Für wen es gedacht ist

• Survival- und SMP-Server, die einen gemeinsamen Spielermarkt wollen.
• Auf Wirtschaft ausgerichtete Server, die eine durchsuchbare Auktions-GUI möchten.
• Admins, die konfigurierbare Angebotsregeln, Gebühren und Gegenstandsrestriktionen benötigen.

🏗️ Beispielanwendungen

• Spieler listen überschüssige Beute auf und versteigern sie an die Server-Community, statt Truhen oder Shops zu nutzen.
• Server-Teams erstellen begrenzte oder unbegrenzte serverseitig angebotene Einträge für Shop-Gegenstände.
• Admins setzen Wirtschaftsregeln durch, indem sie bestimmte Gegenstände einschränken oder Angebotssteuern anwenden.

⌨️ Befehle

🔐 Berechtigungen

⚙️ Installation

📥 Einrichtung

• Lade die offizielle Plugin-.jar herunter und lege sie für Spigot-kompatible Server in das Verzeichnis plugins/ deines Servers.
• Starte den Server neu (vollständiger Neustart) und prüfe die Serverkonsole, um zu bestätigen, dass das Plugin geladen wurde.
• Konfiguriere das Plugin bei Bedarf mit den bereitgestellten Konfigurationsdateien.

📦 Abhängigkeiten

• Vault (erforderlich, 1.7.1+ empfohlen).
• Ein passendes Economy-Plugin (z. B. EssentialsX economy oder ein anderer Vault-kompatibler Economy-Anbieter).
• Ein passendes Berechtigungs-Plugin (wenn du Berechtigungen über die Standardwerte hinaus verwendest).

🧠 Technische Hinweise

• Speicherung: Das Plugin verwendet SQLite (keine dokumentierte Unterstützung für externe Datenbanken).
• Das Plugin protokolliert Transaktionen in einer separaten Logdatei und unterstützt Internationalisierung.
• Unterstützt HeadDatabase-Köpfe und benutzerdefinierte Schädelttexturen als GUI-Schaltflächen.
• Der Autor weist darauf hin, dass Funktionen und Versionskompatibilität auf Spigot ausgerichtet sind; das Verhalten kann bei anderer Serversoftware variieren.

🤝 Wann dieses Plugin nützlich ist

Wenn du ein konfigurierbares, GUI-basiertes Auktionssystem willst, das mit der Wirtschaft deines Servers und Vault integriert ist, bietet AuctionHouse Angebotssteuerung, Suche/Filterung, Gebühren/Steuern und Transaktionsprotokollierung für einen gut verwaltbaren Spielermarkt.