DivineMarry

DivineMarry — Marriage with a scripted ceremony, a shared chest and a shared bank
=================================================================================


DivineMarry covers the entire lifecycle of a relationship on your server: proposal, engagement,
wedding planning, a scripted ceremony with real vows typed in chat, and then a set of couple
features you can switch on one by one.
What sets it apart from the marriage plugins that already exist is not one feature, it is two
deeper things. First: the wedding is an actual event — a configurable script, guests, a scheduled
date, reminders, and a priest who can be a player — not a command that flips a state in a
database. Second: every player experiences the ceremony in THEIR OWN client language, detected
automatically, with nothing for the admin to configure.
The shared chest is built with particular care against item duplication: there is a single
stored inventory and only one partner can have it open at a time, instead of handing each of them
a copy and merging them afterwards, which is precisely the classic way to end up duplicating
items. A divorce splits the bank, the chest and pending gifts between both partners.
FEATURES
-----------------
- Full flow: proposal, engagement, a wedding planning panel with a date, and the ceremony.
- Scripted, configurable ceremony: every step has its text, who is expected to answer, which
phrases count as "I do", and what happens if nobody answers in time.
- Scheduled weddings with automatic reminders (7 days, 1 day, 1 hour... configurable), a
guest list, and guests teleported in when it starts.
- Player-priests and a configurable altar, with no NPC plugin required.
- Configurable polygamy: from classic monogamy to several partners at once.
- Shared chest per couple, designed against item duplication and flushed to disk
synchronously on server shutdown.
- Shared bank, shared home, teleport with cooldown, 1-to-1 private chat and a wedding gift
mailbox (items or money).
- Proximity effects and particles, and optional PvP protection between partners.
- REAL multi-language: 16 languages included out of the box, detected per client.
- Public API so other plugins can query relationships.
- SQLite (included) or MySQL storage. Folia-ready.

REQUIREMENTS
-----------------
Paper 1.21.x or newer, Java 21+. Dependencies: none required. Optional: Vault or DivineCore (for
the shared bank and the wedding/divorce costs), PlaceholderAPI.
MAIN COMMANDS
----------------------
/marry <player> — propose.
/marry accept | deny — answer a proposal.
/marry menu — relationship panel.
/marry wedding — plan the wedding (date, guests, officiant, warp).
/marry chest | home | tp | chat | gift
— couple features.
/divinemarry setchurch|setpriest|forcewedding|forcedivorce|stats|reload
— administration (requires the admin permission).
LANGUAGES
-----------------
16 languages included out of the box, with per-player client language detection:
Spanish, English (US and UK), French, German, Portuguese (Brazil and Portugal), Italian,
Russian, Simplified Chinese, Japanese, Korean, Polish, Dutch, Turkish and Ukrainian.
LICENSE
-----------------
This edition is free and complete: nothing you see here is locked or artificially limited.
A Premium edition will follow later, adding new features on top of these — never taking away
anything the free edition already includes.
A NOTE ON FOLIA AND ECONOMY
----------------------------
This plugin runs on Folia, and its economy features run through Vault. Vault itself does not
support Folia today: a Folia server refuses to load it, and without Vault there is no economy
interface for any plugin to use.
So, on Folia: everything except the economy works. On Paper/Spigot: everything works. If you run
Folia and need the economy side, you need a Folia-compatible Vault fork installed.
This is not a limitation of this plugin, but you should know it before you buy.
KNOWN LIMITS IN 1.0
-------------------
- **MySQL storage is supported but untested against a real instance.** In 1.0 the tested backend
is SQLite (included). MySQL is labeled experimental, and each database must belong to ONE
server: sharing relationships, the bank or the chest across servers is not supported.