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

🌐 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

🛠 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

Marriage Features

Admin Commands

🔑 Permissions

💡 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.

🏷️ Placeholders

Use these placeholders in scoreboards, holograms, or chat plugins:

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