Minecraft plugin MarriageMaster

🔌 About Marriage Master

Marriage Master is a Bukkit/Spigot Minecraft plugin that provides a configurable marriage system for servers. It lets players form marriages (single or multiple, if configured) and grants married players cooperative features and commands. The project includes an API for developers and supports persistent storage.

🎯 Purpose

The plugin is designed for roleplay and social servers that want an in-game marriage mechanic: to give couples shared utilities, private chat, optional economy interactions, and configurable gameplay effects when partners are near each other.

⚙️ Features

• Player-to-player marriage requests and (optional) priest-led ceremonies.
• Partner teleportation (teleport to partner) and a shared home that both partners can teleport to.
• Private couple chat and a toggle to send all chat to the partner instead of public chat.
• Gift items: players can give the item in hand to their partner.
• PvP toggle between partners (enable/disable PvP with your partner).
• Cosmetic actions such as kiss with particle effects.
• XP and regeneration bonuses when partners are near (integrations mentioned for Minecraft XP, mcMMO, SkillAPI).
• Optional shared backpacks / Minepacks integration.
• Multi-language support via configurable language files.
• Configurable storage backends: SQLite and MySQL are supported.
• API for plugin developers to interact with Marriage Master data and events.

🧩 Who It Is For

• Roleplay and social servers that want in-game relationship mechanics.
• SMP or survival servers that want optional cooperative perks for player pairs.
• Server administrators who need configurable permissions and integrations with economy or other plugins.

🏗️ Example Use Cases

• Two players send a marry request and gain a shared home and private chat channel.
• A server enables priest ceremonies for events and grants special items or titles on marriage via server scripting or API hooks.
• Couples use the gift command to exchange in-hand items as part of roleplay.

⌨️ Commands

Note: the official sources list these commands but do not document permission nodes inline on the resource page; permissions are available in the plugin's documentation and permission listing.

⚙️ Installation

📥 Setup

• Download the plugin JAR from the official resource page and place the JAR into your server's plugins/ directory.
• Restart the server and check console output to confirm the plugin loaded successfully.

📦 Dependencies

• Java 8 is required at runtime.
• Runtime platforms confirmed: Bukkit, Spigot, Paper.
• Optional integrations/dependencies documented by the author: Vault (optional, for economy features), PCGF PluginLib (optional), Minepacks integration, Placeholder support.
• Optional proxy support: BungeeCord / Waterfall.

🧾 Configuration

• The plugin provides a comprehensive, documented configuration and language files allowing customization of nearly all behavior, messages, and features.
• Storage can be configured to use SQLite or MySQL.

🧠 Technical Notes

• Supported server software: Bukkit, Spigot, Paper (author states support for Bukkit/Spigot/Paper and optional BungeeCord/Waterfall proxy support).
• Requires Java 8 at runtime.
• The project includes an API for developers and provides JavaDoc documentation for integration.
• The plugin supports UUID/name changes and has multi-language support via resource files.

🤝 When This Plugin Is Useful

If you run a roleplay, social, or SMP server and want an in-game marriage system with configurable perks, private couple utilities, and developer hooks, Marriage Master provides those features with database support and integrations for common server ecosystems.