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.

📌 Contents

• About
• Features
• Installation
• Marriage Flow
• Commands
• Permissions
• Configuration
• Multi-Partner Mode
• Union Levels
• Placeholders
• 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 <player>, which notifies both parties.

---

💻 Commands

Basic Commands

| Command | Description | Permission |
|---------|-------------|------------|
| /marry <player> <priest> | Send a marriage proposal | marry.user |
| /marry accept <player> | Accept a proposal | marry.user |
| /marry refuse <player> | 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 <p1> <p2> | (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 <player> | Adopt a child | marry.user |
| /marry acceptadopt <parent> | Accept adoption | marry.user |
| /marry excommunicate <player> | (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 <group> permission set marry.priest true

---

⚙️ Configuration

File: plugins/WeddingandPriests/config.yml

# ── 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:

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:

# 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 <name> permission set marry.priest true