Marriage

v2.0.0 - Vows, Reworked

Marriage grew up. Everything the mod did before is still here -- rings, proposals, teleports, whispers, the announcement when two names turn pink in chat -- but the machinery underneath is new, and a lot arrived on top of it: a full in-game menu, partner perks, gifts, and a public API.

Existing marriages carry over. The first time each partner logs in on 2.0.0, their marriage is imported into the new server-wide registry automatically. Nothing to reset, nothing to re-run.

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===

The Marriage Menu

• Type /marriage and a rose-themed menu opens: Our Marriage (your partner and whether they're online, how long you've been married, gifts given and received, teleports used, love notes sent -- plus one-click Teleport, Gift, and a click-twice-to-confirm Divorce).
• Received a proposal? It appears right there with Accept and Decline buttons, and a live countdown to when it expires.
• Married Couples lists every couple on the server -- online or not -- with how long each has lasted, plus server totals: couples now, marriages ever, divorces.
• Settings holds your personal toggles, and admins get a full in-game config editor (every value, pending-until-Save, with Revert).

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===

Being Married Now Does Something

• PvP protection -- married partners cannot hurt each other, melee or arrows. Each couple can turn it off if their love language is combat. Attackers are told, gently, why nothing happened.
• Partner regeneration -- stay near your beloved and your health slowly returns. Radius, interval, and amount are all configurable.
• Gifts -- /marry gift (or the menu button) hands the item stack you're holding straight to your partner. Full inventory? It lands at their feet, never lost. Configurable range (0 = anywhere, even across worlds) and cooldown.

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===

A Registry Instead of a Guess

• Marriages now live in a server-wide registry file, not just on each player. /marry list finally shows every couple, not just whoever is online.
• You can divorce while your partner is offline; they're told what happened next time they log in.
• Proposals now expire on their own (configurable), and a new personal toggle lets you refuse marriage requests entirely.
• New optional rule: consume the rings when the wedding completes.

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===

For Server Owners & Mod Authors

• The config grew from 3 real options to over 20, every one with its description sitting next to it in the file -- and all of it editable in-game on the Admin page. Your existing config is upgraded in place to version 4.
• A public MarriageAPI: lookups, stats, the full couples list, marry/divorce operations, and cancellable events for marriages, divorces, and gifts. Your mod can even add its own pages to the Marriage menu.
• Ships in English and Chinese.

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===

Notes

• Built for Hytale server 0.5.x.
• Running Cultivation? Its Partnered Cultivation (双修) feature reads marriages through this API -- married couples meditating together cultivate faster.

===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===--===