> 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/buyperms/beschreibung.md).

# Beschreibung

Verkaufe In-Game-Rechte (Permissions), Berechtigungs-Pakete (Packs) oder ganze Ränge bequem per GUI-Menü – entweder über In-Game-Geld oder ein integriertes Token-System.

{% hint style="success" %}
🛍️ **Biete deinen Spielern eine EULA-konforme Möglichkeit, Ränge und Rechte über Aktivität oder Spielwährung zu erwerben!**
{% endhint %}

## Features

{% tabs %}
{% tab title="🛍️ Verkauf & Ränge" %}

#### Berechtigungs-Verkauf

* **Permissions & Packs:** Verkaufe einzelne Rechte oder ganze Pakete (mehrere Permissions gleichzeitig).
* **Ränge & Gruppen:** Verkaufe zeitbasierte oder permanente Ränge direkt im Spiel.
* **Bestätigungsfenster:** Schutz vor Fehlkäufen durch ein integriertes Bestätigungs-GUI.
* **Mehrseitiges Menü:** Unterstützung für unbegrenzte Seiten zur übersichtlichen Strukturierung.
  {% endtab %}

{% tab title="🪙 Währungs-Optionen" %}

#### Bezahl-Methoden

* **Vault-Währung:** Nutze das normale In-Game-Geld (Economy) deines Servers.
* **Eigenes Token-System:** Integrierte Token-Währung, die per Befehl an Spieler vergeben oder entzogen werden kann (ideal als Event-Belohnung).
  {% endtab %}

{% tab title="🔌 Schnittstellen" %}

#### Berechtigungs-Systeme

Unterstützt alle gängigen Permissions-Plugins:

* **LuckPerms**
* **CloudNet (CPerms v2/v3)**
* **DKPerms**
* **PermissionsEx (PEX)**
  {% endtab %}
  {% endtabs %}

***

## Setup-Anleitung

{% stepper %}
{% step %}

#### Installation

Lade die `.jar`-Datei in das `/plugins/` Verzeichnis deines Servers hoch.
{% endstep %}

{% step %}

#### Berechtigungs-Plugin wählen

1. Starte den Server, um den Ordner `/plugins/BuyPerms/` und die standardmäßige `config.yml` zu erstellen.
2. Wähle in der `config.yml` dein aktives Permissions-System (z. B. LuckPerms) und setze es auf `true`.
3. Passe deine Verkaufs-Items, Preise und Ränge in der Config an.
   {% endstep %}

{% step %}

#### Shop-NPC erstellen

1. Gehe im Spiel an die Position, an der der Shop-NPC stehen soll.
2. Führe `/setbuypermvillager` aus (erfordert `buyperm.setvillager`).
3. Ein Librarian-Villager ohne AI und unverwundbar wird gespawnt, den Spieler anklicken können.
   {% 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>/buyperm [seite]</code></td><td>Öffnet das Verkaufs-Menü auf der angegebenen Seite.</td><td><code>buyperm.use</code></td></tr><tr><td><code>/buyperm reload</code></td><td>Lädt die Konfiguration und GUIs des Plugins neu.</td><td><code>buyperm.reload</code></td></tr><tr><td><code>/setbuypermvillager</code></td><td>Spawnt den Händler-Villager an deiner Position.</td><td><code>buyperm.setvillager</code></td></tr><tr><td><code>/token</code></td><td>Zeigt das eigene Token-Guthaben an.</td><td>-</td></tr><tr><td><code>/token &#x3C;Spieler></code></td><td>Zeigt das Token-Guthaben eines anderen Spielers an.</td><td><code>buyperm.seetokens</code></td></tr><tr><td><code>/token &#x3C;add/remove/set> &#x3C;Spieler> &#x3C;Anzahl></code></td><td>Fügt einem Spieler Tokens hinzu, zieht welche ab oder setzt das Guthaben.</td><td><code>buyperm.token</code></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 %}