Minecraft-Plugin MarriageMaster

🔌 Über Marriage Master

Marriage Master ist ein Bukkit/Spigot-Minecraft-Plugin, das ein konfigurierbares Ehe-System für Server bereitstellt. Es ermöglicht Spielern, Ehen einzugehen (eine oder mehrere, wenn entsprechend konfiguriert) und gibt verheirateten Spielern kooperative Funktionen und Befehle. Das Projekt enthält eine API für Entwickler und unterstützt persistente Speicherung.

🎯 Zweck

Das Plugin ist für Roleplay- und Social-Server gedacht, die eine Ehe-Mechanik im Spiel möchten: für Paare gemeinsame Funktionen, privaten Chat, optionale Economy-Interaktionen und konfigurierbare Gameplay-Effekte, wenn Partner nah beieinander sind.

⚙️ Funktionen

• Heiratsanfragen von Spieler zu Spieler und optionale Zeremonien mit Priester.
• Teleport zum Partner und ein gemeinsames Zuhause, zu dem sich beide Partner teleportieren können.
• Privater Paar-Chat und ein Schalter, um alle Nachrichten an den Partner statt an den öffentlichen Chat zu senden.
• Geschenk-Items: Spieler können den Gegenstand in der Hand an ihren Partner geben.
• PvP-Umschaltung zwischen Partnern (PvP mit deinem Partner aktivieren/deaktivieren).
• Kosmetische Aktionen wie kiss mit Partikeleffekten.
• XP- und Regenerationsboni, wenn Partner nahe beieinander sind (Integrationen erwähnt für Minecraft XP, mcMMO, SkillAPI).
• Optionale Integration für gemeinsame Backpacks / Minepacks.
• Mehrsprachige Unterstützung über konfigurierbare Sprachdateien.
• Konfigurierbare Speicher-Backends: SQLite und MySQL werden unterstützt.
• API für Plugin-Entwickler, um mit Marriage-Master-Daten und -Ereignissen zu interagieren.

🧩 Für wen es gedacht ist

• Roleplay- und Social-Server, die Beziehungsmechaniken im Spiel wollen.
• SMP- oder Survival-Server, die optionale Koop-Vorteile für Spielerpaare wollen.
• Server-Administratoren, die konfigurierbare Berechtigungen und Integrationen mit Economy- oder anderen Plugins benötigen.

🏗️ Beispielanwendungen

• Zwei Spieler senden eine Heiratsanfrage und erhalten ein gemeinsames Zuhause und einen privaten Chat-Kanal.
• Ein Server aktiviert Priester-Zeremonien für Events und vergibt besondere Gegenstände oder Titel bei der Ehe über Server-Skripte oder API-Hooks.
• Paare nutzen den Geschenk-Befehl, um Gegenstände aus der Hand im Rahmen des Roleplays auszutauschen.

⌨️ Befehle

Hinweis: Die offiziellen Quellen listen diese Befehle auf, dokumentieren aber die Berechtigungs-Nodes nicht direkt auf der Ressourcen-Seite; die Berechtigungen sind in der Dokumentation und der Berechtigungsliste des Plugins verfügbar.

⚙️ Installation

📥 Einrichtung

• Lade die JAR-Datei des Plugins von der offiziellen Ressourcen-Seite herunter und lege die JAR in das Verzeichnis plugins/ deines Servers.
• Starte den Server neu und prüfe die Konsolenausgabe, um zu bestätigen, dass das Plugin erfolgreich geladen wurde.

📦 Abhängigkeiten

• Java 8 wird zur Laufzeit benötigt.
• Bestätigte Laufzeitplattformen: Bukkit, Spigot, Paper.
• Optionale Integrationen/Abhängigkeiten laut Autor: Vault (optional, für Economy-Funktionen), PCGF PluginLib (optional), Minepacks-Integration, Placeholder-Unterstützung.
• Optionale Proxy-Unterstützung: BungeeCord / Waterfall.

🧾 Konfiguration

• Das Plugin bietet eine umfassende, dokumentierte Konfiguration sowie Sprachdateien, mit denen sich nahezu alle Verhaltensweisen, Nachrichten und Funktionen anpassen lassen.
• Die Speicherung kann auf SQLite oder MySQL konfiguriert werden.

🧠 Technische Hinweise

• Unterstützte Server-Software: Bukkit, Spigot, Paper (der Autor nennt Unterstützung für Bukkit/Spigot/Paper sowie optionale BungeeCord/Waterfall-Proxy-Unterstützung).
• Erfordert Java 8 zur Laufzeit.
• Das Projekt enthält eine API für Entwickler und bietet JavaDoc-Dokumentation für die Integration.
• Das Plugin unterstützt UUID-/Namensänderungen und hat Mehrsprach-Unterstützung über Resource-Dateien.

🤝 Wann dieses Plugin nützlich ist

Wenn du einen Roleplay-, Social- oder SMP-Server betreibst und ein Ehe-System im Spiel mit konfigurierbaren Vorteilen, privaten Paar-Funktionen und Entwickler-Hooks möchtest, bietet Marriage Master diese Funktionen mit Datenbank-Unterstützung und Integrationen für gängige Server-Ökosysteme.