> 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/perks/beschreibung.md). # Beschreibung Ein umfangreiches Perks-System mit Multi-Page GUI, Trank-Effekten, Schutz-Perks, Inventar-Management und vielem mehr für ein verbessertes Spielerlebnis! {% hint style="success" %} 💎 **Biete deinen Spielern exklusive Vorteile und Fähigkeiten mit über 30+ Perks!** {% endhint %} ## Übersicht Das **Perks Plugin** ermöglicht es Server-Administratoren, ihren Spielern verschiedenste Vorteile und Fähigkeiten bereitzustellen. Durch ein intuitives GUI-System können Spieler ihre Perks selbst verwalten und aktivieren oder deaktivieren. {% hint style="info" %} **Kompatibilität** * ✅ **Minecraft-Versionen:** 1.8.8 - 1.21+ (alle Versionen) * ✅ **Server-Software:** Spigot, Paper und alle Forks * ✅ **Rückwärtskompatibel:** Volle Unterstützung für Legacy-Versionen (1.8-1.12) mit shortid-System {% endhint %} ## Features {% tabs %} {% tab title="🎨 GUI & Bedienung" %} #### GUI-System * **Multi-Page GUI**: Unbegrenzt viele Seiten mit Perks möglich * **Intuitive Bedienung**: Einfaches Ein- und Ausschalten von Perks per Klick * **Status-Indikatoren**: Farbige Anzeige (Aktiviert/Deaktiviert/Gesperrt) * **Pagination**: Automatische Vor- und Zurück-Navigation bei mehreren Seiten * **Custom Items**: Vollständig anpassbare GUI-Items und Layouts {% endtab %} {% tab title="⚗️ Effekte & Buffs" %} #### Trank-Effekte * **Dauerhaft aktiv**: Speed, Jump Boost, Strength, Regeneration etc. * **Individual konfigurierbar**: Beliebige Potion-Effekte mit beliebiger Stärke * **Weltbasierte Kontrolle**: Effekte können pro Welt deaktiviert werden * **Bis Level 256**: Extrem starke Effekte möglich #### Extra Herzen * **Extra Hearts 5**: +5 zusätzliche Herzen (+10 HP) * **Extra Hearts 10**: +10 zusätzliche Herzen (+20 HP) * **Resistenz-Effekte**: Dauerhafte Schadensverringerung {% endtab %} {% tab title="🛡️ Schutz" %} #### Allgemeiner Schutz * **No Fall Damage**: Keinen Fallschaden erleiden * **No Hunger**: Hunger-Anzeige sinkt nicht mehr * **No Explosion**: Kein Explosionsschaden * **No Lava**: Kein Lavaschaden #### Mob-Schutz Schutz vor **beliebigen Mob-Typen**: * Creeper, Zombie, Skeleton, Spider, Enderman * Blaze, Ghast, Slime, Guardian, Piglin * Warden, Wither, Ender Dragon, und viele mehr! {% hint style="info" %} Du kannst für **jeden** Minecraft Entity-Typ einen eigenen Schutz-Perk erstellen! {% endhint %} {% endtab %} {% tab title="💼 Inventar & Items" %} #### Inventar-Management * **Keep Inventory**: Gesamtes Inventar beim Tod behalten * **Keep Hotbar**: Nur die Hotbar beim Tod behalten * **Keep XP**: Erfahrungspunkte beim Tod behalten * **Drop to Inventory**: Abgebaute Blöcke landen direkt im Inventar #### Item-Features * **Instant Smelt**: Erze werden automatisch geschmolzen abgebaut * **Spawner-Abbau**: Spawner können aufgehoben werden {% endtab %} {% tab title="⭐ XP & Leveling" %} #### XP-Multiplikatoren * **Double XP**: Doppelte Erfahrungspunkte (2x) * **Quad XP**: Vierfache Erfahrungspunkte (4x) * **Keep XP**: XP bleiben beim Tod erhalten {% hint style="success" %} Perfect für Grinding und schnelles Leveling! {% endhint %} {% endtab %} {% tab title="🌱 Spezial-Perks" %} #### Gärtner-Perks * **Gardener 1**: Pflanzen wachsen beim Sneaken (1x1 Radius) * **Gardener 2**: Pflanzen wachsen beim Sneaken (3x3 Radius) * **Cooldown-System**: Zeitbasierte Abklingzeiten verhindern Spam #### Sonstige * **Fly**: Flug-Modus (auf eigenem Plot oder überall) * **Color Chat**: Farbiger Chat mit `&` Codes {% endtab %} {% tab title="🔧 Technisch" %} #### Technische Features * ✅ **Permission-System:** Jeder Perk an Permissions bindbar * ✅ **Welt-Blacklist:** Perks pro Welt deaktivierbar * ✅ **MySQL-Speicherung:** Persistente Daten über Server-Neustarts * ✅ **PlaceholderAPI-Support:** Vollständige Integration * ✅ **PlotSquared Support:** Kompatibel v5, v6, v7 (optional) * ✅ **Async-Optimiert:** Ressourcenschonend * ✅ **HEX-Farben:** Support ab Minecraft 1.16+ * ✅ **Reload-System:** Ohne Server-Neustart {% endtab %} {% endtabs %} ## Installation {% stepper %} {% step %} #### Download & Installation Lade die neueste Version der `Perks` herunter \[]\ In der Zip findest du 2 jars:
a) Eine mit "1.13+" im Namen, diese Version nutzt du für alle Serverversionen, AB der 1.13 (und auch NUR diese jar nutzen, nicht beide!). D.h. auch für zB 1.21.10 nutzt du die "1.13+" jar. \ b) Für Server, die älter als 1.13 sind, also 1.8.8 - 1.12.2, nutzt du die Jar OHNE "1.13+" im Namen (und auch NUR diese jar nutzen, nicht beide!). {% endstep %} {% step %} #### Erste Konfiguration Starte den Server, um die Config-Dateien zu generieren. Das Plugin erstellt automatisch: * `config.yml` - Hauptkonfiguration * MySQL-Tabellen (beim ersten Verbindungsaufbau) {% endstep %} {% step %} #### MySQL-Setup Trage deine MySQL-Daten in die `config.yml` ein: ```yaml MySQL: host: localhost port: '3306' username: dein_username datebase: dein_datenbankname password: 'dein_passwort' ``` {% endstep %} {% step %} #### Server-Neustart Starte den Server neu. Das Plugin ist nun einsatzbereit! {% endstep %} {% endstepper %} {% hint style="warning" %} **Wichtig:** Die MySQL-Datenbank muss bereits existieren. Das Plugin erstellt nur die Tabellen automatisch. {% endhint %} ### Abhängigkeiten
KomponenteStatusDetails
Spigot/Paper✅ ErforderlichMinecraft 1.8.8 - 1.21+
MySQL/MariaDB✅ ErforderlichFür die Datenspeicherung
PlaceholderAPI📦 OptionalFür Placeholder-Integration (empfohlen)
PlotSquared📦 OptionalFür Plot-basierte Fly-Berechtigung (v5, v6, v7)
## Commands
CommandBeschreibungPermission
/perksÖffnet das Perks-GUI-
/perks reloadLädt die Konfiguration neu (ohne Server-Neustart)perks.admin
## Permissions
PermissionBeschreibung
perks.adminErlaubt Zugriff auf administrative Befehle
perks.*Gibt Zugriff auf alle Perks (nicht empfohlen)
perks.<perkname>Individuell definierbar in der Config
{% tabs %} {% tab title="Beispiele" %} ``` perks.no_fall_damage # No Fall Damage Perk perks.fly # Fly Perk perks.keep_inv # Keep Inventory Perk perks.potion_effect_speed_-1_1 # Speed II Perk perks.extra_hearts_10 # 10 Extra Herzen ``` {% endtab %} {% tab title="Gruppenweise" %} ``` # VIP-Perks perks.no_fall_damage perks.no_hunger perks.double_xp # VIP+-Perks perks.fly perks.keep_hotbar perks.quad_xp # Premium-Perks perks.keep_inv perks.extra_hearts_10 perks.gardener_2 ``` {% endtab %} {% endtabs %} ## Support & Links {% hint style="info" %} **Hilfe benötigt?** Hier findest du weitere Ressourcen: {% endhint %} * 🌐 **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 %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wiki.dyroxplays.de/perks/beschreibung.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.