JakesEssentials v1.0.10 Update Notes

NEW FEATURE: Marriage & Engagement System (/marriage & /jakesessentials marriage)

A complete, feature-rich marriage and engagement system built directly into JakesEssentials.

💍 Proposals & Engagements

• /marriage propose <player>: Send a marriage proposal to another player. Target players receive interactive clickable chat prompt buttons ([Accept] / [Reject]).
• /marriage engagement cancel: Cancel your active engagement before the wedding ceremony takes place. Supports notifying offline partners upon their next login.
• /marriage toggleproposals: Toggle whether you receive marriage proposals from other players.

❤️ Marriage Information & Social Interactions

• /marriage: Displays your current relationship status (Single, Engaged, or Married).
• /marriage status: Displays detailed relationship info including your partner, marriage timestamp, priest name, and shared features.
• /marriage seen: Check if your partner is currently online, or how long ago they were last seen online.
• /marriage anniversary: Displays how long you and your partner have been married.
• /marriage kiss: Kiss your nearby partner (spawns heart particles and plays a customizable sound effect).
• /marriage hug: Hug your nearby partner (spawns happy heart particles and plays a customizable purr sound effect).
• /marriage gift: Transfer the item held in your main hand directly into your partner's inventory. Chat notifications display the full item tooltip on hover in chat ([Count x ItemName]).
• /marriage chat <message>: Send private chat messages to your online partner in a dedicated marriage chat channel.

🏠 Shared Marriage Home & Teleportation

• /marriage sethome: Set a shared home location for you and your partner.
• /marriage home: Teleport to your shared home (respects configurable warmup & cooldown periods with movement cancellation).
• /marriage tp: Teleport to your online partner (teleports directly by default; can be configured to require partner acceptance in jakesessentials-common.toml).

📦 Shared Virtual Chest

• /marriage chest: Access a shared virtual chest inventory shared between you and your partner.
• Real-time Synchronization: Shared chest containers are linked in memory across all simultaneous viewers (both partners and admins via chestsee), preventing item duplication.
• Empty Chest Divorce Protection: Normal player divorces strictly require the shared chest to be completely empty before a divorce can be executed to protect item ownership.

💔 Divorces

• /marriage divorce [partner]: Initiate divorce with your partner (partner argument optional). Prompts the user with interactive chat confirmation buttons ([ CONFIRM DIVORCE ] / [ CANCEL ]) to prevent accidental divorces.

⛪ Priest System & Ceremonies

• Priest Permission: Players with jakesessentials.marriage.priest or OP status can act as priests to perform wedding ceremonies.
• /marriage priest perform <player1> <player2>: Initiates a formal wedding ceremony for an engaged couple within proximity.
• Interactive Vow Exchange: Prompts both players with interactive chat vows ([I Do] / [I Don't]). Once both accept, the priest officially marries the couple.
• /marriage priest list: View a list of all currently online priests.

🛡️ Admin Commands & Moderation

• /marriage admin force-marry <player1> <player2>: Force-marry two players instantly (bypassing engagement and priest requirements). Supports offline players.
• /marriage admin force-divorce <player>: Force-divorce a player and their partner (bypassing empty chest requirement). Supports offline players.
• /marriage admin check <player>: Inspect the relationship status, partner, priest, and marriage date for any player (online or offline).
• /marriage admin chestsee <player>: Open and manage any married couple's shared chest.

⚙️ Server Configuration Options (jakesessentials-common.toml)

• marriageDisabled: Master toggle to disable all marriage features.
• marriageChestDisabled: Toggle to disable shared chest (/marriage chest).
• marriageHomeDisabled: Toggle to disable shared home (/marriage home, /marriage sethome).
• marriageTpDisabled: Toggle to disable partner teleportation (/marriage tp).
• marriageTpRequireAcceptance: Toggle whether /marriage tp requires the partner to accept a request (default: false for direct teleportation).
• marryHomeWarmupSeconds & marryHomeCooldownSeconds: Configurable warmup and cooldown durations for home teleports.
• marryTpWarmupSeconds & marryTpCooldownSeconds: Configurable warmup and cooldown durations for partner teleports.
• marryChestCooldownSeconds: Configurable cooldown between opening the shared marriage chest.
• marriageChestSize: Configurable chest size (27 single inventory or 54 double inventory).
• interactionDistance & priestCeremonyDistance: Configurable max distances for kissing/hugging and wedding ceremonies.
• kissSound & hugSound: Customizable sound effect resource IDs.

🔔 Offline Player Support & Pending Notifications

• Notifications for divorces or engagement cancellations that occur while a player is offline are queued in a persistent notification store (pending_notifications.json) and delivered upon their next login.

🔑 Permission Nodes Summary

• jakesessentials.marriage: Granted by default for basic marriage commands.
• jakesessentials.marriage.priest: Permission to perform wedding ceremonies as a priest.
• jakesessentials.marriage.admin: Admin permission for force operations and chest inspection.
• jakesessentials.marriage.home.bypass.warmup / .cooldown: Bypass home warmup and cooldown timers.
• jakesessentials.marriage.tp.bypass.warmup / .cooldown: Bypass partner TP warmup and cooldown timers.
• jakesessentials.marriage.chest.bypass.cooldown: Bypass shared chest cooldown timer.