> For the complete documentation index, see [llms.txt](https://wiki.dyroxplays.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.dyroxplays.de/plotauction/funktionen-and-setup-anleitung.md). # 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. {% hint style="success" %} 🎰 **Ermögliche einen einfachen, sicheren und interaktiven Handel mit Grundstücken auf deinem Citybuild-Server!** {% endhint %} ## Features {% tabs %} {% tab title="🎰 Auktions-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). {% endtab %} {% tab title="🏷️ Plotname-Feature" %} #### Custom Plot-Namen * **Beschreibung & Name festlegen:** Spieler können ihren angebotenen Grundstücken per `/pahname ` 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. {% endtab %} {% tab title="💾 Storage & Admin" %} #### 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. {% endtab %} {% tab title="🔌 Integration & Design" %} #### 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. {% endtab %} {% endtabs %} *** ## Setup-Anleitung {% stepper %} {% step %} #### 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. {% endstep %} {% step %} #### 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`. {% endstep %} {% step %} #### 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`). {% endstep %} {% step %} #### Konfiguration im laufenden Betrieb laden Führe In-Game oder in der Konsole `/plotauction reload` aus, um alle Änderungen ohne Serverneustart sofort zu übernehmen. {% endstep %} {% endstepper %} *** ## Commands & Permissions
BefehlBeschreibungPermission
/plotauctionÖffnet die Auktionshaus-Haupt-GUI für Grundstücke. (Aliase: /plotauctions, /pah, /plotauktion, /pa)plotauction.use
/plotauction reloadLä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)
## Support & Links * 🌐 **Plugin-Website**: [https://dyroxplays.de](https://dyroxplays.de/) * 💬 **Discord**: Dyroxplays * 🔌 **Weitere Plugins**: *** {% hint style="success" %} **Coded by Dyroxplays** © 2024-2026 Dyroxplays. Alle Rechte vorbehalten. {% endhint %}