!banner

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

📌 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