Minecraft plugin MarriageMaster

🔌 O Marriage Master

Marriage Master je Bukkit/Spigot plugin pro Minecraft, který poskytuje konfigurovatelný systém manželství pro servery. Umožňuje hráčům uzavírat sňatky (jednotlivé nebo vícečetné, pokud je to nastaveno) a dává ženatým/vdaným hráčům kooperativní funkce a příkazy. Projekt obsahuje API pro vývojáře a podporuje perzistentní úložiště.

🎯 Účel

Plugin je určen pro roleplay a sociální servery, které chtějí herní mechaniku manželství: aby párům poskytl sdílené utility, soukromý chat, volitelné ekonomické interakce a konfigurovatelné herní efekty, když jsou partneři blízko sebe.

⚙️ Funkce

• Žádosti o sňatek mezi hráči a obřady vedené knězem (volitelné).
• Teleportace k partnerovi (teleport to partner) a sdílený dům, do kterého se mohou teleportovat oba partneři.
• Soukromý chat pro pár a přepínač pro odesílání veškerého chatu partnerovi místo veřejného chatu.
• Dárkové předměty: hráči mohou dát svému partnerovi předmět, který drží v ruce.
• Přepínač PvP mezi partnery (zapnout/vypnout PvP s vaším partnerem).
• Kosmetické akce jako kiss s částicovými efekty.
• Bonusy XP a regenerace, když jsou partneři poblíž (zmíněné integrace pro Minecraft XP, mcMMO, SkillAPI).
• Volitelná sdílená backpacks / integrace Minepacks.
• Podpora více jazyků prostřednictvím konfigurovatelných jazykových souborů.
• Konfigurovatelné backendy úložiště: podporovány jsou SQLite a MySQL.
• API pro vývojáře pluginů pro práci s daty a událostmi Marriage Master.

🧩 Pro koho je to určeno

• Roleplay a sociální servery, které chtějí herní mechaniky vztahů.
• SMP nebo survival servery, které chtějí volitelné kooperativní bonusy pro dvojice hráčů.
• Správce serverů, kteří potřebují konfigurovatelná oprávnění a integrace s ekonomikou nebo jinými pluginy.

🏗️ Příklady použití

• Dva hráči pošlou žádost o sňatek a získají sdílený dům a soukromý chatovací kanál.
• Server povolí kněžské obřady pro události a při sňatku udělí speciální předměty nebo tituly pomocí server scripting nebo API hooks.
• Páry používají příkaz gift k výměně předmětů držených v ruce jako součást roleplay.

⌨️ Příkazy

Poznámka: oficiální zdroje tyto příkazy uvádějí, ale nezdokumentují permission nodes přímo na stránce zdroje; oprávnění jsou dostupná v dokumentaci pluginu a v seznamu oprávnění.

⚙️ Instalace

📥 Nastavení

• Stáhněte JAR pluginu z oficiální stránky zdroje a vložte JAR do složky plugins/ vašeho serveru.
• Restartujte server a zkontrolujte výstup konzole, abyste potvrdili, že se plugin úspěšně načetl.

📦 Závislosti

• Při běhu je vyžadována Java 8.
• Potvrzené runtime platformy: Bukkit, Spigot, Paper.
• Volitelné integrace/závislosti dokumentované autorem: Vault (volitelné, pro ekonomické funkce), PCGF PluginLib (volitelné), integrace Minepacks, podpora Placeholder.
• Volitelná podpora proxy: BungeeCord / Waterfall.

🧾 Konfigurace

• Plugin poskytuje rozsáhlou, zdokumentovanou konfiguraci a jazykové soubory, které umožňují upravit téměř veškeré chování, zprávy i funkce.
• Úložiště lze nakonfigurovat na SQLite nebo MySQL.

🧠 Technické poznámky

• Podporovaný serverový software: Bukkit, Spigot, Paper (autor uvádí podporu Bukkit/Spigot/Paper a volitelnou podporu proxy BungeeCord/Waterfall).
• Při běhu vyžaduje Java 8.
• Projekt obsahuje API pro vývojáře a poskytuje dokumentaci JavaDoc pro integraci.
• Plugin podporuje změny UUID/jména a má vícejazyčnou podporu prostřednictvím resource files.

🤝 Kdy je tento plugin užitečný

Pokud provozujete roleplay, sociální nebo SMP server a chcete herní systém manželství s konfigurovatelnými bonusy, soukromými utilitami pro páry a hooks pro vývojáře, Marriage Master tyto funkce poskytuje spolu s podporou databází a integracemi pro běžné serverové ekosystémy.