> 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/1vs1/funktionen-and-setup-anleitung.md).

# Funktionen & Setup-Anleitung

Ein hochgradig anpassbares 1vs1-Duell-System mit automatischen, unlimitierten Arenen, Warteschlangen, Top-10-Wänden und vielem mehr!

{% hint style="success" %}
⚔️ **Biete deinen Spielern ein fesselndes Duell-Erlebnis ähnlich wie auf GommeHD.net!**
{% endhint %}

## Features

{% tabs %}
{% tab title="🎮 Gameplay & Arenen" %}

#### Gameplay-Features

* **Automatisches Arenensystem:** Arenen werden je nach Bedarf dynamisch instanziiert und gestartet.
* **Warteschlange (Queue):** Spieler können sich für bestimmte Kits in die Warteschlange einreihen.
* **Aufgeben-Funktion:** Schnelles Aufgeben via `/quit`.
* **Lebensanzeige:** Zeigt die verbleibenden HP über dem Spielernamen (deaktivierbar).
* **Anpassbares Scoreboard:** Integriertes Scoreboard für Duelle (deaktivierbar).
  {% endtab %}

{% tab title="⚙️ Administration" %}

#### Administrative Features

* **99% konfigurierbar:** Alle Nachrichten, Sounds, Titel und Scoreboards lassen sich anpassen.
* **Top 10 Statswand:** Zeigt die Top-Spieler sortiert nach Wins mit Köpfen und Schildern an.
* **MySQL-Integration:** Sichere und persistente Speicherung aller Spielerstatistiken.
* **PlaceholderAPI Support:** Voller Zugriff auf Platzhalter zur Verwendung in anderen Plugins.
  {% endtab %}
  {% endtabs %}

## Setup-Anleitung

{% hint style="warning" %}
**Wichtig:** Um das Setup durchzuführen, muss in der Konfiguration `setup: true` gesetzt sein!
{% endhint %}

{% stepper %}
{% step %}

#### Installation & erste Schritte

Lade die `.jar`-Datei in den `plugins`-Ordner deines Servers und starte diesen einmal, damit alle Konfigurationen generiert werden.
{% endstep %}

{% step %}

#### Lobby setzen

Betrete den Server und markiere den Spawn-Punkt der Haupt-Lobby mit: `/1vs1 setLobby` *(Erfordert die Permission `1vs1.admin`)*
{% endstep %}

{% step %}

#### Top 10 Statswand erstellen

Baue eine Wand mit einem Spielerkopf (oben) und einem Schild (darunter). Stelle dich auf den Block des Kopfes und führe aus: `/1vs1 settopwall <1-10>` (für die Ränge 1 bis 10).
{% endstep %}

{% step %}

#### Welten & Maps einrichten

1. Stoppe den Server.
2. Kopiere deine Duell-Welten (Maps) in den Ordner `/plugins/1vs1/saves`.
3. Trage deine MySQL-Verbindung in die `config.yml` ein.
4. Starte den Server neu. Die Welten aus `/saves` werden nun im Setup-Modus geladen.
   {% endstep %}

{% step %}

#### Arenen-Spawns setzen

1. Teleportiere dich mit `/1vs1 worldtp <weltname>` in deine Duell-Welten.
2. Setze dort die beiden Startpunkte für die Duellanten mit `/1vs1 setspawnpos <1/2>`.
   {% endstep %}

{% step %}

#### Setup abschließen

1. Öffne die `config.yml` und setze `setup: false`.
2. Starte den Server neu. Nun ist das System aktiv, und Spieler können die Warteschlangen nutzen!
   {% endstep %}
   {% endstepper %}

***

### Platzhalter (PlaceholderAPI)

<table><thead><tr><th width="250">Platzhalter</th><th>Beschreibung</th></tr></thead><tbody><tr><td><code>%1vs1_arena%</code></td><td>Gibt den Namen der aktuellen Arena aus.</td></tr><tr><td><code>%1vs1_vs%</code></td><td>Zeigt den Namen des aktuellen Gegners an.</td></tr><tr><td><code>%1vs1_wins%</code></td><td>Anzahl der Siege des Spielers.</td></tr><tr><td><code>%1vs1_deaths%</code></td><td>Anzahl der Tode des Spielers.</td></tr><tr><td><code>%1vs1_kills%</code></td><td>Anzahl der Kills des Spielers.</td></tr></tbody></table>

## Commands & Permissions

<table><thead><tr><th width="250">Befehl</th><th>Beschreibung</th><th width="200">Permission</th></tr></thead><tbody><tr><td><code>/1vs1 setLobby</code></td><td>Setzt den Spawn für die Lobby.</td><td><code>1vs1.admin</code></td></tr><tr><td><code>/1vs1 setspawnpos &#x3C;1/2></code></td><td>Setzt den Spawn 1 oder 2 in einer Arena.</td><td><code>1vs1.admin</code></td></tr><tr><td><code>/1vs1 worldTP &#x3C;welt></code></td><td>Teleportiert dich im Setup in eine Arena-Welt.</td><td><code>1vs1.admin</code></td></tr><tr><td><code>/1vs1 saveKit &#x3C;0-8></code></td><td>Speichert dein aktuelles Inventar als Kit auf einem Slot.</td><td><code>1vs1.admin</code></td></tr><tr><td><code>/1vs1 settopwall &#x3C;1-10></code></td><td>Registriert ein Kopf/Schild-Paar für die Statswand.</td><td><code>1vs1.admin</code></td></tr><tr><td><code>/quit</code></td><td>Gibt den aktuellen Kampf vorzeitig auf.</td><td>-</td></tr><tr><td><code>/stats (Spieler)</code></td><td>Zeigt die eigenen oder die Statistiken eines anderen Spielers.</td><td>-</td></tr></tbody></table>