⚔️ Qadro RPG Plugin

📖 Übersicht

Qadro RPG ist ein umfassendes RPG-Plugin für Minecraft 1.21.10, das deinem Server viele neue Features bietet:

• 10 einzigartige Rassen - Jede mit eigenen Attributen und Boni
• 10 verschiedene Klassen - Von Kriegern bis zu Magiern
• Umfangreiches Level-System - Mit XP-Gewinnung, Level-Ups, Belohnungen, Attributen, Berechtigungen und Titeln
• Erweitertes Skills-System - 8 Skill-Typen mit höheren Max-Levels und aktiven Boni
• HUD-System - Action Bar, Scoreboard und Boss Bar für Level, XP, HP und mehr
• Gilden-System - Größere, persistente Spielergruppen mit Rängen
• PvP-System - Duell- und Arena-Modus
• Teleport-System - Warps und mehrere Homes pro Spieler
• Mail-System - Spieler-zu-Spieler Nachrichten mit Item-Anhängen
• Dungeon-System - Instanzierte Dungeons mit automatischer Welterstellung
• Trading-System - Sicherer Spieler-zu-Spieler Handel
• Ruf-System - Spieler-Standing mit verschiedenen Fraktionen
• Quest-System - Normale Quests, Daily Quests und Weekly Quests
• Achievement-System - Erfolge für verschiedene Aktivitäten
• Shop-System - NPC-Shops für Items
• Party-System - Temporäre Spielergruppen
• XP-Boost-System - Temporäre XP-Multiplikatoren
• Leaderboard-System - Ranglisten für Level
• Custom Items, Mobs & Blöcke - Erweitere deine Welt
• GUI-Menüs - Benutzerfreundliche Auswahl- und Informationsmenüs
• Partikel-Effekte - Visuelle Effekte für verschiedene Events
• Vollständige Integration - ItemsAdder, EssentialsX, Vault, LuckPerms

👥 Rassen

Beim ersten Betreten des Servers musst du eine Rasse auswählen. Jede Rasse hat unterschiedliche Attribute:

⚔️ Klassen

Nach der Rassenauswahl wählst du deine Klasse. Jede Klasse hat spezielle Fähigkeiten:

📈 Level-System

XP-Gewinnung

Du erhältst Erfahrungspunkte (XP) durch verschiedene Aktivitäten:

• Mob-Töten: Basis-XP + (Mob-Level × Multiplikator)
• Quest-Abschluss: Abhängig von Quest-Level und Schwierigkeit
• Bergbau: XP für das Abbauen von Blöcken
• Handwerk: XP für das Herstellen von Items
• Landwirtschaft: XP für das Ernten von Pflanzen
• Erkundung: XP für das Entdecken neuer Gebiete

Level-Ups

Wenn du genug XP gesammelt hast, steigst du ein Level auf:

• Du erhältst Skill-Punkte zum Freischalten von Skills
• Jedes 5. Level gibt einen zusätzlichen Skill-Punkt
• Level-Belohnungen: Items, Geld oder andere Belohnungen
• Attribut-Boni: Automatische Verbesserung deiner Attribute
• Berechtigungen: Neue Permissions werden freigeschaltet
• Titel: Spezielle Titel basierend auf deinem Level
• Visuelle Effekte und Benachrichtigungen
• Maximales Level: 100 (konfigurierbar)

XP-Berechnung

Die benötigte XP für ein Level wird exponentiell berechnet:

XP = 100 × Level^1.5 × Multiplikator

XP-Boosts

XP-Boosts erhöhen temporär deine XP-Gewinnung:

• Können von Admins vergeben werden
• Multiplizieren die erhaltene XP
• Haben eine begrenzte Dauer
• Werden im HUD angezeigt

🌟 Skills-System

Das Skills-System ermöglicht es dir, verschiedene Fähigkeiten freizuschalten und zu verbessern.

Skill-Typen

• Kampf: Nahkampf- und Fernkampf-Fähigkeiten
• Magie: Zauber und magische Fähigkeiten
• Handwerk: Verbesserte Herstellungsfähigkeiten
• Bergbau (Miner): Effizienteres Abbauen von Ressourcen
• Schmied (Blacksmith): Verbesserte Waffen- und Rüstungsherstellung
• Bogenschießen (Archery): Verbesserte Fernkampf-Fähigkeiten
• Angeln (Fishing): Bessere Fänge und seltene Items
• Verzauberung (Enchanting): Stärkere Verzauberungen
• Alchemie: Mächtigere Tränke und Elixiere
• Landwirtschaft: Bessere Ernten und Tierzucht
• Erkundung: Schnelleres Reisen und Entdecken
• Sozial: Handels- und Interaktionsfähigkeiten
• Verteidigung: Defensive Fähigkeiten

Skill-Punkte erhalten

Skill-Punkte erhältst du durch:

• Level-Ups (1 Punkt pro Level)
• Jedes 5. Level gibt einen zusätzlichen Punkt
• Quest-Belohnungen

Skills freischalten

Um einen Skill freizuschalten:

1. Öffne das Skills-Menü mit /skills
2. Wähle den gewünschten Skill aus
3. Stelle sicher, dass du genug Skill-Punkte hast
4. Prüfe, ob alle Anforderungen erfüllt sind
5. Klicke zum Freischalten

Skill-Boni

Skills können verschiedene Boni gewähren:

• Attribut-Boni: Erhöhung von Stärke, Intelligenz, etc.
• Custom-Boni: Spezielle Effekte wie erhöhte Bewegungsgeschwindigkeit
• Passive Boni: Immer aktiv, sobald der Skill freigeschaltet ist
• Aktive Boni: Können bei bestimmten Leveln aktiviert werden

🖥️ HUD-System

Das HUD-System zeigt wichtige Informationen direkt im Spiel an:

Action Bar

• Zeigt Level, XP-Fortschritt und XP-Boost-Status
• Wird kontinuierlich aktualisiert
• Kann mit /hud toggle ein-/ausgeschaltet werden

Scoreboard

• Zeigt Level, XP, HP, Mana und weitere Statistiken
• Zeigt aktuelle Quests und Fortschritt
• Zeigt Party/Gilde-Informationen
• Kann mit /hud toggle ein-/ausgeschaltet werden

Boss Bar

• Zeigt XP-Fortschritt zum nächsten Level
• Zeigt HP während des Kampfes
• Zeigt Quest-Fortschritt
• Kann mit /hud toggle ein-/ausgeschaltet werden

🏰 Gilden-System

Gilden sind größere, persistente Spielergruppen mit erweiterten Funktionen:

Gilden-Funktionen

• Gilde erstellen: /guild create <name>
• Spieler einladen: /guild invite <spieler>
• Einladung annehmen: /guild accept
• Gilde verlassen: /guild leave
• Gilden-Info: /guild info
• Ränge: Verschiedene Ränge mit unterschiedlichen Berechtigungen
• Gilden-Chat: Separater Chat für Gildenmitglieder

Gilden-Ränge

• Leader: Vollständige Kontrolle über die Gilde
• Officer: Kann Mitglieder einladen und verwalten
• Member: Standard-Mitglied

⚔️ PvP-System

Das PvP-System ermöglicht faire Kämpfe zwischen Spielern:

Duell-System

• Herausforderung senden: /duel challenge <spieler>
• Herausforderung annehmen: /duel accept
• Herausforderung ablehnen: /duel deny
• Faire Kämpfe: Beide Spieler werden auf gleiche Bedingungen gesetzt
• Belohnungen: XP und Items für den Sieger

Arena-Modus

• Spezielle Arenen für PvP-Kämpfe
• Automatische Respawn-Mechanik
• Ranglisten für Arena-Kämpfe

📍 Teleport-System

Das Teleport-System ermöglicht schnelles Reisen:

Warps

• Warp-Liste: /warp list
• Zu Warp teleportieren: /warp <name>
• Warp erstellen: /warp set <name> (Admin)
• Warp löschen: /warp delete <name> (Admin)
• Cooldown: Verhindert Missbrauch

Homes

• Home setzen: /home set <name>
• Zu Home teleportieren: /home <name>
• Home löschen: /home delete <name>
• Alle Homes anzeigen: /home list
• Mehrere Homes: Du kannst mehrere benannte Homes haben
• Cooldown: Verhindert Missbrauch
• Bewegungsprüfung: Du musst stillstehen während der Teleportation

📧 Mail-System

Das Mail-System ermöglicht Nachrichten zwischen Spielern:

Mail-Funktionen

• Mail senden: /mail send <spieler> <nachricht>
• Mails lesen: /mail read
• Mail-Liste: /mail list
• Items anheften: Items können an Mails angehängt werden
• Items abholen: /mail claim
• Mail löschen: /mail delete <id>

🏰 Dungeon-System

Das Dungeon-System bietet instanzierte Dungeons mit automatischer Welterstellung:

Dungeon-Funktionen

• Dungeon erstellen: /dungeon create <name>
• Spieler einladen: /dungeon invite <spieler>
• Dungeon betreten: Automatische Welterstellung
• Dungeon verlassen: /dungeon leave
• Dungeon-Liste: /dungeon list
• Dungeon-Info: /dungeon info
• Automatische Welterstellung: Nutzt Multiverse Core, Dungeon MMO und Stratos
• Instanzierte Welten: Jeder Dungeon läuft in einer eigenen Welt

💱 Trading-System

Das Trading-System ermöglicht sicheren Spieler-zu-Spieler Handel:

Trading-Funktionen

• Handel anfragen: /trade request <spieler>
• Anfrage annehmen: /trade accept
• Items hinzufügen: Items in den Handels-Slot legen
• Bereit markieren: /trade ready
• Handel abbrechen: /trade cancel
• Handels-Info: /trade info
• Sicherheit: Beide Spieler müssen bereit sein, bevor der Handel abgeschlossen wird
• Geld-Handel: Unterstützt auch Währungs-Handel

⭐ Ruf-System

Das Ruf-System verfolgt dein Standing mit verschiedenen Fraktionen:

Ruf-Funktionen

• Ruf-Liste: /reputation list
• Ruf-Info: /reputation info <fraktion>
• Verschiedene Fraktionen: Jede Fraktion hat eigene Ruf-Stufen
• Ruf-Stufen: Von Feindlich bis Verbündet
• Belohnungen: Bessere Ruf-Stufen geben Zugang zu speziellen Items und Quests

📜 Quest-System

Das Quest-System bietet verschiedene Arten von Quests:

Normale Quests

• Quest-Liste: /quest list
• Quest starten: /quest start <quest>
• Quest abschließen: Automatisch bei Erfüllung der Anforderungen
• Belohnungen: XP, Items, Geld

Daily Quests

• Daily Quests anzeigen: /dailyquest daily
• Täglich neu: Neue Quests jeden Tag
• Belohnungen: Oft bessere Belohnungen als normale Quests
• Fortschritt: Fortschritt wird gespeichert

Weekly Quests

• Weekly Quests anzeigen: /dailyquest weekly
• Wöchentlich neu: Neue Quests jede Woche
• Belohnungen: Sehr gute Belohnungen
• Fortschritt: Fortschritt wird gespeichert

⌨️ Befehle

Spieler-Befehle

Admin-Befehle

🔌 Integrationen

Qadro RPG unterstützt die Integration mit folgenden Plugins:

Vault

Integration mit Vault für:

• Wirtschaftssystem (Economy API)
• Berechtigungssystem (Permission API)

LuckPerms

Integration mit LuckPerms für:

• Erweiterte Berechtigungsverwaltung
• Gruppen-basierte Features

EssentialsX

Integration mit EssentialsX für:

• Wirtschaftssystem
• Erweiterte Spieler-Funktionen

ItemsAdder

Integration mit ItemsAdder für:

• Custom Items Unterstützung
• Erweiterte Item-Funktionalität

Multiverse Core

Integration mit Multiverse Core für:

• Dungeon-Welterstellung
• Weltverwaltung

📥 Installation

Voraussetzungen

• Minecraft Server 1.21.10
• Paper oder Spigot
• Java 17 oder höher

Installationsschritte

1. Lade die QadroRPG.jar Datei herunter
2. Platziere sie im plugins Ordner deines Servers
3. Starte den Server neu
4. Konfiguriere das Plugin in der config.yml
5. (Optional) Installiere unterstützende Plugins (Vault, LuckPerms, etc.)

Konfiguration

Die Hauptkonfigurationsdatei ist config.yml. Hier kannst du einstellen:

• Datenbank-Einstellungen (SQLite oder MySQL)
• Level-System Parameter
• XP-Multiplikatoren
• Feature-Aktivierung
• Integration-Einstellungen
• HUD-Einstellungen
• Teleport-Cooldowns

Datenbank

Standardmäßig verwendet Qadro RPG SQLite, was keine zusätzliche Konfiguration erfordert. Für MySQL musst du die Datenbankverbindung in der config.yml konfigurieren.

📝 Berechtigungen

🗺️ Roadmap

Hier findest du geplante Features und Verbesserungen für zukünftige Versionen von Qadro RPG: