Wedding and Priests

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. DONE! → to Player B, naming a specific online Priest 2. DONE! → or refuses the proposal 3. DONE! → charges both parties a fee and collects a commission 4. DONE! → The couple is married! 💍

🔌 Dependencies

| Dependency | Type | Description | |------------|------|-------------| | LuckPerms | Required | Must be installed with any supported economy plugin | | LuckPerms | 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 | |---------|-------------| | Union Levels | Propose with a named priest, accepts/refuse system | | Union Levels | Specialized role to officiate marriages | | Union Levels | Marriage costs, divorce costs, priest commissions | | Union Levels | Customizable rings with NBT data | | Union Levels | Teleport to a couple's home | | Union Levels | Multiple spouses per player | | Union Levels | Bonus XP when near your partner | | Union Levels | Show offline time in couple list | | Union Levels | Speed + Luck buff to nearby players | | Union Levels | Adopt children into the family | | Union Levels | Prevent remarriage after bad divorces | | Union Levels | 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 | OP (All) | | `marry.tp` | Use `/marry tp` | OP (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`

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