![banner](https://cdn.modrinth.com/data/cached_images/b147e46e3038310e5e8275fd12fc3a7ac2c09bad_0.webp) # Wedding & Priests 💍 A complete Marriage management system for Spigot/Paper servers, featuring customizable wedding actions, specialized priest roles, adoption system, family trees, and union level progression. ![Version](https://img.shields.io/badge/version-1.0.2-blue) ## 📌 Contents - [About](#-about) - [Features](#-features) - [Installation](#-installation) - [Marriage Flow](#-marriage-flow) - [Commands](#-commands) - [Permissions](#-permissions) - [Configuration](#-configuration) - [Multi-Partner Mode](#-multi-partner-mode) - [Union Levels](#-union-levels) - [Placeholders](#-placeholders) - [FAQ](#-faq) --- ## 📖 About ### 💍 What is it? Wedding & Priests is a complete marriage plugin for your Minecraft server. It lets players propose, accept, and formalize in-game marriages — complete with economy costs, customizable wedding rings, specialized priest roles, divorce mechanics, adoption system, and family tree visualization. The plugin also features an exclusive **Union Level** system where couples level up their relationship over time, unlocking exclusive bonuses like: - More adoption slots - Increased XP boosts - Custom permissions ### ⚙️ How it works The process follows a structured flow: 1. **Player A Proposes** → to Player B, naming a specific online Priest 2. **Player B Accepts** → or refuses the proposal 3. **Priest Formalizes** → charges both parties a fee and collects a commission 4. **DONE!** → The couple is married! 💍 ### 🔌 Dependencies | Dependency | Type | Description | |------------|------|-------------| | **Vault** | Required | Must be installed with any supported economy plugin | | **Economy Plugin** | Required | EssentialsX, CMI, Towny, etc. | | **LuckPerms** | Optional | Auto-assign groups to married players | ### 🌐 Language The plugin supports multiple languages. The default language is **English** (`lang_en.yml`). You can create custom language files by copying the default and translating the values. The active language is selected in `config.yml`. --- ## 🎮 Features | Feature | Description | |---------|-------------| | **Marriage Proposals** | Propose with a named priest, accepts/refuse system | | **Priest Role** | Specialized role to officiate marriages | | **Economy** | Marriage costs, divorce costs, priest commissions | | **Wedding Rings** | Customizable rings with NBT data | | **Shared Home** | Teleport to a couple's home | | **Multi-Partner Mode** | Multiple spouses per player | | **XP Boost** | Bonus XP when near your partner | | **Last Seen** | Show offline time in couple list | | **Priest Blessing** | Speed + Luck buff to nearby players | | **Adoption System** | Adopt children into the family | | **Excommunication** | Prevent remarriage after bad divorces | | **Family Tree** | View complete family hierarchy | | **Union Levels** | Level up bonuses over time | --- ## 🛠 Installation ### Steps 1. Drop the `WeddingandPriests.jar` file into your server's `/plugins` folder 2. Ensure Vault and an economy plugin are installed and running 3. Start (or restart) your server to generate configuration files 4. Edit `plugins/WeddingandPriests/config.yml` to your liking 5. Run `/marriagereload` or restart to apply changes ⚠️ **Important:** The plugin will automatically disable itself if Vault is not found on startup. --- ## 🔄 Marriage Flow ``` Player A Proposes ↓ Player B Accepts ↓ Priest Formalizes ↓ DONE: Married! 💍 ``` - A **Priest must be named** in the initial proposal command - The proposal expires after `proposal-expiry` seconds - While pending, the proposer cannot send another proposal 💡 **Tip:** Player B can refuse using `/marry refuse `, which notifies both parties. --- ## 💻 Commands ### Basic Commands | Command | Description | Permission | |---------|-------------|------------| | `/marry ` | Send a marriage proposal | `marry.user` | | `/marry accept ` | Accept a proposal | `marry.user` | | `/marry refuse ` | Refuse a proposal | `marry.user` | | `/marry divorced` | Divorce your partner | `marry.user` | | `/marry married [page]` | List married couples | `marry.user` | | `/marry help` | Show help menu | `marry.user` | ### Marriage Features | Command | Description | Permission | |---------|-------------|------------| | `/marry officialize ` | (Priest) Formalize marriage | `marry.priest` | | `/marry tp` | Teleport to partner | `marry.tp` | | `/marry sethome` | Set shared home | `marry.user` | | `/marry home` | Teleport to home | `marry.user` | | `/marry blessing` | (Priest) Buff nearby players | `marry.priest` | | `/marry adopt ` | Adopt a child | `marry.user` | | `/marry acceptadopt ` | Accept adoption | `marry.user` | | `/marry excommunicate ` | (Priest) Excommunicate | `marry.priest` | | `/marry family` | View family tree | `marry.user` | ### Admin Commands | Command | Description | Permission | |---------|-------------|------------| | `/marry setitem` | Save wedding ring item | `marry.admin` | | `/marriagereload` | Reload configuration | `marry.admin` | | `/priests` | List online priests | `marry.user` | --- ## 🔑 Permissions | Permission Node | Description | Default | |----------------|------------|---------| | `marry.user` | Basic commands | **TRUE** (All) | | `marry.tp` | Use `/marry tp` | **TRUE** (All) | | `marry.priest` | Act as Priest | **OP** | | `marry.admin` | Admin commands | **OP** | 💡 **Tip:** Give `marry.priest` to a group using LuckPerms: `/lp group permission set marry.priest true` --- ## ⚙️ Configuration ### File: `plugins/WeddingandPriests/config.yml` ```yaml # ── General Settings ────────────────────── language: "en" settings: marriage-cost: 500000.0 divorce-cost: 0.0 priest-commission: 0.10 proposal-expiry: 60 tp-cooldown: 30 married-group: "" marriage-item-base64: "" # ── Multi-Partner Mode ──────────────────── multi-partners: enabled: false max-partners: 1 # ── Wedding Effects ──────────────────── effects: wedding: enabled: true firework-count: 3 firework-colors: - "255,0,128" - "255,105,180" - "255,215,0" particles-heart: enabled: true particles-villager-happy: enabled: true # ── Shared Home ──────────────────────── shared-home: enabled: true max-radius: 100 # ── XP Boost ──────────────────────────── xp-boost: enabled: true multiplier: 1.1 proximity-radius: 10 show-message: true # ── Last Seen ────────────────────────── last-seen: enabled: true show-in-list: true # ── Priest Blessing ────────────────────── blessing: enabled: true duration-seconds: 300 radius: 20 # ── Adoption ───────────────────────── adoption: enabled: true base-max-children: 1 cost: 100000.0 # ── Excommunication ──────��──────────── excommunication: enabled: true priest-cost: 500000.0 duration-days: 7 prevent-remarriage: true # ── Union Levels ─────────────────────── union-levels: enabled: true xp-per-day: 100 ``` --- ## 💑 Multi-Partner Mode Enable multiple spouses per player: ```yaml multi-partners: enabled: true max-partners: 3 # or higher ``` ⚠️ **Warning:** Switching between single and multi mode mid-server may cause data inconsistencies. Backup `marriages.yml` first. --- ## ⭐ Union Levels Couples level up their relationship over time based on days married. | Level | Days Together | Bonus | |-------|-------------|-------| | 1 | 5+ | +1 adoption slot, 1.2x XP | | 2 | 15+ | +2 adoption slots, 1.3x XP | | 3 | 30+ | +3 adoption slots, 1.4x XP | | 4 | 60+ | +4 slots, 1.5x XP, custom perm | | 5 | 100+ | +5 slots, 1.6x XP, legend perm | --- ## 🏷️ Placeholders Use these placeholders in scoreboards, holograms, or chat plugins: | Placeholder | Description | |------------|-------------| | `%marry_partner%` | Partner's name | | `%marry_time_together%` | Time married (days) | | `%marry_union_level%` | Current union level | | `%marry_adoption_slots%` | Available adoption slots | | `%marry_children_count%` | Number of adopted children | | `%marry_last_seen%` | Partner's last seen time | ### Example PlaceholderAPI usage: ```yaml # In your scoreboard partner: "%marry_partner%" time: "%marry_time_together% days" level: "Union Level %marry_union_level%" ``` --- ## ❓ FAQ **Q: The plugin disables on startup — why?** > A: Vault or an economy provider was not found. Ensure Vault.jar and a compatible economy plugin are installed. **Q: Can players marry while offline partners exist?** > A: Proposals require both players to be online. Divorce and couples list work offline. **Q: Where is marriage data stored?** > A: `plugins/WeddingandPriests/marriages.yml`. Auto-saved on marriage, divorce, or shutdown. **Q: How do I set the wedding ring?** > A: Hold the item and run `/marry setitem` (requires `marry.admin`). **Q: Can I reload without restarting?** > A: Yes, run `/marriagereload` (requires `marry.admin`). **Q: How do I give a player the Priest role?** > A: `/lp user permission set marry.priest true`

Wedding and Priests

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details