> 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/buildffa/beschreibung-and-kit-infos.md).

# Beschreibung & Kit-Infos

Ein dynamisches BuildFFA-Plugin mit einem automatischen Kartenwechsel-System, Perks, einem integrierten Shop-System und voller MySQL-Unterstützung.

{% hint style="success" %}
🧱 **Biete deinen Spielern actionreiche Kämpfe mit anpassbaren Kits, Blöcke-Perks und Items!**
{% endhint %}

## Features

{% tabs %}
{% tab title="🗺️ Welten & Maps" %}

#### Map-Management

* **MultiMaps:** Unterstützung für beliebig viele Maps zur Steigerung der Abwechslung.
* **Automatischer Map-Wechsel:** Maps wechseln vollautomatisch nach einer in der Config festgelegten Zeit.
* **Forcemap-Befehl:** Admins können die aktuelle Karte sofort per Befehl überspringen und wechseln.
  {% endtab %}

{% tab title="🔮 Perks & Shop" %}

#### Ingame-Vorteile

* **Perks:** Stick-Perks und Blöcke-Perks erweitern die Fähigkeiten der Spieler im Kampf.
* **Währungsshop:** Kaufe mächtige Items wie Enderperlen, Rettungsplattformen und Enterhaken (erfordert Vault).
* **Inventar-Sortierung:** Spieler können die Anordnung ihrer Items im Kit mit `/invsort` frei anpassen.
  {% endtab %}

{% tab title="📊 Stats & Technik" %}

#### Verwaltung

* **MySQL-Schnittstelle:** Persistente Speicherung der Statistiken und Anbindung einer Top-10-Wand.
* **Lobby-Addon:** Zeigt die Spielerstatistiken bei Bedarf bereits in der Server-Lobby an.
* **PlaceholderAPI Support:** Kompatibel mit Platzhaltern wie `%buildffa_map%`, `%buildffa_kills%`, `%buildffa_deaths%` und `%buildffa_kd%`.
  {% endtab %}
  {% endtabs %}

***

## Setup-Anleitung

{% stepper %}
{% step %}

#### Installation & Abhängigkeiten

Lade die `.jar`-Datei in den `plugins`-Ordner deines Servers. Stelle sicher, dass **Vault** und ein Economy-Plugin auf dem Server vorhanden sind.
{% endstep %}

{% step %}

#### Maps & Positionen einrichten

1. Definiere die Spawnpunkte deiner Maps im Spiel mit: `/buildffa setspawn <MapName>`.
2. Bestimme die Todeshöhe (unterhalb derer Spieler sterben) mit: `/buildffa setdeath <MapName>`.
3. Setze die maximale Bauhöhe (über der keine Blöcke platziert werden können) mit: `/buildffa setbuild <MapName>`.
4. Definiere die erste Karte, die beim Serverstart geladen werden soll: `/buildffa startmap <MapName>`.
   {% endstep %}

{% step %}

#### Standard-Kit einrichten

1. Rüstung und Inventar so ausrüsten, wie das Standard-Startkit sein soll (Kits sollten Blöcke und Sticks für Perks sowie eine Enderperle für den Shop enthalten).
2. Führe `/savekit` aus (erfordert `buildffa.admin`), um das Kit global für alle Spieler zu speichern.
   {% endstep %}
   {% endstepper %}

***

## Commands & Permissions

<table><thead><tr><th width="250">Befehl</th><th>Beschreibung</th><th width="250">Permission</th></tr></thead><tbody><tr><td><code>/build</code></td><td>Aktiviert oder deaktiviert den Admin-Baumodus (Blöcke verschwinden nicht).</td><td><code>buildffa.build</code></td></tr><tr><td><code>/buildffa setspawn &#x3C;map></code></td><td>Setzt den Spawnpoint für eine Map.</td><td><code>buildffa.admin</code></td></tr><tr><td><code>/buildffa setdeath &#x3C;map></code></td><td>Setzt die Todes-Grenze (Y-Koordinate) für eine Map.</td><td><code>buildffa.admin</code></td></tr><tr><td><code>/buildffa setbuild &#x3C;map></code></td><td>Setzt die Bauhöhen-Grenze (Y-Koordinate) für eine Map.</td><td><code>buildffa.admin</code></td></tr><tr><td><code>/buildffa startmap &#x3C;map></code></td><td>Legt die Startmap nach dem Server-Reboot fest.</td><td><code>buildffa.admin</code></td></tr><tr><td><code>/forcemap</code></td><td>Wechselt die Map sofort zur nächsten verfügbaren Karte.</td><td><code>buildffa.admin</code></td></tr><tr><td><code>/savekit</code></td><td>Speichert das aktuelle Inventar des Admins als globales Kit.</td><td><code>buildffa.admin</code></td></tr><tr><td><code>/settopwall &#x3C;1-10></code></td><td>Setzt ein Schild/Kopf-Paar für die Top-10-Wand.</td><td><code>buildffa.admin</code></td></tr><tr><td><code>/stats (Spieler)</code></td><td>Zeigt die aktuellen Kills, Deaths und KD-Stats an.</td><td>-</td></tr><tr><td><code>/invsort</code></td><td>Öffnet das GUI zur individuellen Inventar-Sortierung.</td><td>-</td></tr><tr><td><code>/top</code></td><td>Öffnet die Top-10-Bestenliste in einem GUI-Menü.</td><td>-</td></tr></tbody></table>

## Support & Links

* 🌐 **Plugin-Website**: [https://dyroxplays.de](https://dyroxplays.de/)
* 💬 **Discord**: Dyroxplays
* 🔌 **Weitere Plugins**: <https://dyroxplays.de/shop>

***

{% hint style="success" %}
**Coded by Dyroxplays**

© 2024-2026 Dyroxplays. Alle Rechte vorbehalten.
{% endhint %}