For the complete documentation index, see llms.txt. This page is also available as Markdown.

🎰Funktionen & Setup-Anleitung

Biete deinen Spielern eine vollautomatisierte Möglichkeit, Grundstücke per Auktionshaus-GUI zur Versteigerung oder zum Sofortkauf anzubieten – vollständig integriert in PlotSquared mit automatischer Versionserkennung, Multi-Storage und modularen GUIs.

Features

Grundstücks-Handel

  • Bieten & Sofortkauf: Erstelle Plot-Auktionen mit einem Start-Bietpreis, einem Sofortkaufpreis oder einer Kombination aus beidem.

  • Mausklick-Steuerung:

    • Linksklick: Grundstück kaufen (fremde Auktion) / Auktion verwalten oder löschen (eigene Auktion).

    • Rechtsklick: Auf das Grundstück bieten (fremde Auktion) / Zum Verkauf anbieten (eigene Auktion).

    • Mittelklick: Teleportiert den Spieler direkt zum angebotenen Plot zur Besichtigung.

  • Intelligente GUI-Sortierung: Sortiere Angebote nach neuesten Auktionen oder bald endenden Auktionen.

  • Automatische Plot-Übertragung & Offline-Payouts: Nach Ablauf der Auktion oder bei Sofortkauf wird das Plot automatisch an den Gewinner/Käufer übertragen. Verkäufer erhalten ihren Erlös (abzüglich Verkaufssteuer) automatisch gutgeschrieben – auch wenn sie während des Verkaufs offline waren (Offline-Payments).

Custom Plot-Namen

  • Beschreibung & Name festlegen: Spieler können ihren angebotenen Grundstücken per /pahname <Name> einen benutzerdefinierten Namen oder eine Beschreibung zuweisen, um das Angebot im Auktionshaus attraktiver zu gestalten.

  • Bestätigungsschutz & Gebühren: Namensänderungen erfordern eine Sicherheits-Bestätigung (Doppeleingabe von /pahname) und können in der Config mit einer definierten Gebühr gekoppelt werden. Min/Max-Längenregeln sind individuell anpassbar.

Datenbank & Verwaltung

  • Multi-Storage Typen: Unterstützt SQLite (auctions.db – lokal ohne Setup), MySQL (für Server-Netzwerke) sowie klassische Datei-Speicherung.

  • Live-Migration: Migriere deine kompletten Auktionsdaten ohne Serverausfallzeit im laufenden Betrieb zwischen Speicher-Typen (/plotauction admin migrate).

  • Under-the-Fly Live-Reload: Aktualisiere Konfigurationen, Sprachdateien und alle 7 GUI-Dateien nahtlos mit /plotauction reload.

  • Erstellungsgebühren & Verkäufersteuer: Flexibel konfigurierbare Festpreis- und prozentuale Erstellungsgebühren sowie verkäuferseitige Verkaufssteuer (tax).

  • PlotLimit-Bypass: Option ignoreplotlimitofplotsquared ermöglicht Spielern das Ersteigern/Kaufen von Plots, selbst wenn ihr normales PlotSquared-Limit erreicht ist.

Schnittstellen & Optik

  • Automatischer PlotSquared-Support: Kompatibel mit PlotSquared v3, v4, v5, v6 und v7 sowie PlotMe. Die PlotSquared-Version wird beim Serverstart vollautomatisch erkannt!

  • Vault & Economy Support: Abwicklung aller Preisberechnungen, Gebots-Transaktionen und Auszahlungen über Vault.

  • PlaceholderAPI Support: Dynamische Platzhalter in allen Nachrichtenzeilen und GUI-Lores.

  • 7 Modulare GUI-Dateien: Jedes Menü besitzt eine eigene YAML-Datei zur vollständigen Anpassung von Layout, Items, Köpfen (Skull-Textures) und Slots.

  • HEX-Farben & Sound-Effekte: Volle Unterstützung von HEX-Farbcodes (#RRGGBB / &#RRGGBB) ab Minecraft 1.16+ und anpassbare Soundeffekte per Aktion.


Setup-Anleitung

1

Installation & Voraussetzungen

Lade die .jar-Datei in das /plugins/ Verzeichnis deines Servers hoch. Stelle sicher, dass Vault (inkl. Wirtschaftssystem) sowie PlotSquared (oder PlotMe) auf dem Server aktiv sind.

2

Erststart & Speicher-Auswahl

  1. Starte den Server einmal, damit der Ordner /plugins/PlotAuction/ mit allen Konfigurationsdateien generiert wird.

  2. Das Plugin erkennt deine PlotSquared-Version automatisch!

  3. Standardmäßig ist SQLite aktiv. Möchtest du ein MySQL-Netzwerk nutzen, trage deine Zugangsdaten in der config.yml unter MySQL: ein und setze MySQL.enable: true.

3

Konfiguration & GUIs anpassen

  1. Passe Steuern, Erstellungsgebühren, minimale/maximale Auktionsdauer und das Plotname-Feature in der config.yml an.

  2. Gestalte die 7 GUI-Dateien im Ordner /plugins/PlotAuction/ nach deinen Wünschen (z. B. maingui.yml, yourAuction.yml, bid.yml, buy.yml).

4

Konfiguration im laufenden Betrieb laden

Führe In-Game oder in der Konsole /plotauction reload aus, um alle Änderungen ohne Serverneustart sofort zu übernehmen.


Commands & Permissions

Befehl
Beschreibung
Permission

/plotauction

Öffnet die Auktionshaus-Haupt-GUI für Grundstücke. (Aliase: /plotauctions, /pah, /plotauktion, /pa)

plotauction.use

/plotauction reload

Lädt die gesamte Konfiguration, Nachrichten und alle 7 GUI-Dateien sicher im laufenden Betrieb neu.

plotauction.admin oder plotauction.reload

/plotauction admin migrate <from> <to> [override]

Migriert die Auktionsdatenbank live im laufenden Betrieb (z. B. SQLITE zu MYSQL). Optional mit true zum Überschreiben.

plotauction.admin

/pahname <Name>

Gibt dem aktuell angebotenen Grundstück einen benutzerdefinierten Namen / Beschreibung im Auktionshaus.

plotauction.plotname (wenn in Config aktiviert)

-

Erlaubt unbegrenzte gleichzeitige Plot-Auktionen pro Spieler.

plotauction.auctions.* (wenn Limitierung aktiv)

-

Begrenzt die maximalen Auktionen pro Spieler auf eine bestimmte Anzahl (NUMBER).

plotauction.auctions.<anzahl> (wenn Limitierung aktiv)


Zuletzt aktualisiert