Plugin Minecraft MarriageMaster

🔌 Informacje o Marriage Master

Marriage Master to wtyczka Bukkit/Spigot do Minecrafta, która zapewnia konfigurowalny system małżeństw dla serwerów. Umożliwia graczom zawieranie małżeństw (pojedynczych lub wielu, jeśli tak skonfigurowano) i daje małżonkom funkcje oraz komendy kooperacyjne. Projekt zawiera API dla deweloperów i obsługuje trwałe przechowywanie danych.

🎯 Cel

Wtyczka została zaprojektowana z myślą o serwerach roleplay i społecznościowych, które chcą mechaniki małżeństwa w grze: aby dać parom wspólne narzędzia, prywatny czat, opcjonalne interakcje z ekonomią i konfigurowalne efekty rozgrywki, gdy partnerzy są blisko siebie.

⚙️ Funkcje

• Prośby o małżeństwo między graczami oraz (opcjonalnie) ceremonie prowadzone przez kapłana.
• Teleportacja do partnera i wspólny dom, do którego oboje partnerzy mogą się teleportować.
• Prywatny czat pary i przełącznik, który wysyła wszystkie wiadomości do partnera zamiast na czat publiczny.
• Przedmioty na prezent: gracze mogą przekazać partnerowi przedmiot trzymany w ręce.
• Przełącznik PvP między partnerami (włączanie/wyłączanie PvP z partnerem).
• Kosmetyczne akcje, takie jak kiss, z efektami cząsteczkowymi.
• Bonusy XP i regeneracji, gdy partnerzy są blisko (wspomniane integracje dla Minecraft XP, mcMMO, SkillAPI).
• Opcjonalna integracja ze wspólnymi plecakami / Minepacks.
• Obsługa wielu języków dzięki konfigurowalnym plikom językowym.
• Konfigurowalne backendy przechowywania: obsługiwane są SQLite i MySQL.
• API dla twórców wtyczek do pracy z danymi i zdarzeniami Marriage Master.

🧩 Dla kogo

• Serwery roleplay i społecznościowe, które chcą mechaniki relacji w grze.
• Serwery SMP lub survival, które chcą opcjonalnych bonusów kooperacyjnych dla par graczy.
• Administratorzy serwerów, którzy potrzebują konfigurowalnych uprawnień i integracji z ekonomią lub innymi wtyczkami.

🏗️ Przykłady użycia

• Dwóch graczy wysyła prośbę o małżeństwo i zyskuje wspólny dom oraz prywatny kanał czatu.
• Serwer włącza ceremonie z kapłanem na potrzeby wydarzeń i przyznaje specjalne przedmioty lub tytuły po ślubie za pomocą skryptów serwera lub hooków API.
• Pary używają komendy prezentu, aby wymieniać przedmioty trzymane w ręce jako część roleplayu.

⌨️ Komendy

Uwaga: oficjalne źródła wymieniają te komendy, ale nie dokumentują bezpośrednio node'ów uprawnień na stronie zasobu; uprawnienia są dostępne w dokumentacji wtyczki i w liście uprawnień.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz plik JAR wtyczki z oficjalnej strony zasobu i umieść JAR w katalogu plugins/ swojego serwera.
• Uruchom ponownie serwer i sprawdź wyjście konsoli, aby potwierdzić, że wtyczka została poprawnie załadowana.

📦 Zależności

• Wymagany jest Java 8 w czasie działania.
• Potwierdzone platformy uruchomieniowe: Bukkit, Spigot, Paper.
• Opcjonalne integracje/zależności opisane przez autora: Vault (opcjonalnie, do funkcji ekonomii), PCGF PluginLib (opcjonalnie), integracja z Minepacks, obsługa Placeholder.
• Opcjonalna obsługa proxy: BungeeCord / Waterfall.

🧾 Konfiguracja

• Wtyczka zapewnia rozbudowaną, udokumentowaną konfigurację oraz pliki językowe, które pozwalają dostosować niemal wszystkie zachowania, wiadomości i funkcje.
• Magazyn danych można skonfigurować do użycia SQLite lub MySQL.

🧠 Uwagi techniczne

• Obsługiwane oprogramowanie serwera: Bukkit, Spigot, Paper (autor deklaruje obsługę Bukkit/Spigot/Paper oraz opcjonalną obsługę proxy BungeeCord/Waterfall).
• Wymaga Java 8 w czasie działania.
• Projekt zawiera API dla deweloperów i udostępnia dokumentację JavaDoc do integracji.
• Wtyczka obsługuje zmiany UUID/nazwy i ma wsparcie wielojęzyczne przez pliki zasobów.

🤝 Kiedy ta wtyczka jest przydatna

Jeśli prowadzisz serwer roleplay, społecznościowy lub SMP i chcesz systemu małżeństw w grze z konfigurowalnymi bonusami, prywatnymi narzędziami dla par i hookami dla deweloperów, Marriage Master oferuje te funkcje wraz z obsługą baz danych i integracjami dla popularnych ekosystemów serwerowych.