Плагін Minecraft MarriageMaster

🔌 Про Marriage Master

Marriage Master — це Bukkit/Spigot плагін для Minecraft, який надає налаштовувану систему шлюбу для серверів. Він дозволяє гравцям укладати шлюби (один або кілька, якщо це налаштовано) і надає одруженим гравцям кооперативні можливості та команди. Проєкт містить API для розробників і підтримує постійне збереження даних.

🎯 Призначення

Плагін створено для roleplay- та соціальних серверів, які хочуть мати внутрішньоігрову механіку шлюбу: щоб дати парам спільні інструменти, приватний чат, необов’язкові економічні взаємодії та налаштовувані ефекти геймплею, коли партнери знаходяться поруч.

⚙️ Можливості

• Запити на шлюб між гравцями та церемонії під проводом священика (за потреби).
• Телепортація до партнера (teleport to partner) і спільний дім, до якого можуть телепортуватися обидва партнери.
• Приватний чат пари та перемикач, щоб усі повідомлення йшли партнеру замість публічного чату.
• Предмети-подарунки: гравці можуть віддати предмет, який тримають у руці, своєму партнеру.
• Перемикач PvP між партнерами (увімкнення/вимкнення PvP із вашим партнером).
• Косметичні дії, такі як kiss, з ефектами частинок.
• Бонуси XP та регенерації, коли партнери поруч (згадуються інтеграції для Minecraft XP, mcMMO, SkillAPI).
• Необов’язкова спільна підтримка backpack / Minepacks.
• Підтримка кількох мов через налаштовувані мовні файли.
• Налаштовувані сховища даних: підтримуються SQLite і MySQL.
• API для розробників плагінів, щоб взаємодіяти з даними та подіями Marriage Master.

🧩 Для кого це

• Roleplay- та соціальні сервери, яким потрібна механіка стосунків у грі.
• SMP або survival сервери, яким потрібні необов’язкові кооперативні бонуси для пар гравців.
• Адміністратори серверів, яким потрібні налаштовувані права та інтеграції з економікою або іншими плагінами.

🏗️ Приклади використання

• Двоє гравців надсилають запит на шлюб і отримують спільний дім та приватний канал чату.
• Сервер вмикає церемонії священика для подій і видає спеціальні предмети або титули під час шлюбу через server scripting або API hooks.
• Пари використовують команду gift, щоб обмінюватися предметами з руки як частиною roleplay.

⌨️ Команди

Примітка: офіційні джерела перелічують ці команди, але не документують permission nodes прямо на сторінці ресурсу; дозволи доступні в документації плагіна та списку permissions.

⚙️ Встановлення

📥 Налаштування

• Завантажте JAR плагіна з офіційної сторінки ресурсу та помістіть JAR у директорію plugins/ вашого сервера.
• Перезапустіть сервер і перевірте вивід консолі, щоб підтвердити, що плагін успішно завантажився.

📦 Залежності

• Під час виконання потрібен Java 8.
• Підтверджені платформи запуску: Bukkit, Spigot, Paper.
• Необов’язкові інтеграції/залежності, зазначені автором: Vault (необов’язково, для економічних функцій), PCGF PluginLib (необов’язково), інтеграція Minepacks, підтримка Placeholder.
• Необов’язкова підтримка проксі: BungeeCord / Waterfall.

🧾 Конфігурація

• Плагін надає повну, задокументовану конфігурацію та мовні файли, що дозволяють налаштувати майже всю поведінку, повідомлення та можливості.
• Сховище можна налаштувати на використання SQLite або MySQL.

🧠 Технічні нотатки

• Підтримуване серверне ПЗ: Bukkit, Spigot, Paper (автор зазначає підтримку Bukkit/Spigot/Paper і необов’язкову підтримку проксі BungeeCord/Waterfall).
• Під час виконання потрібен Java 8.
• Проєкт містить API для розробників і надає документацію JavaDoc для інтеграції.
• Плагін підтримує зміну UUID/імені та має багатомовну підтримку через resource files.

🤝 Коли цей плагін корисний

Якщо ви запускаєте roleplay, соціальний або SMP сервер і хочете внутрішньоігрову систему шлюбу з налаштовуваними бонусами, приватними утилітами для пари та hooks для розробників, Marriage Master надає ці можливості з підтримкою бази даних та інтеграціями для поширених серверних екосистем.