# 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 %}