Couples Mod

Couples Mod is a multiplayer Minecraft NeoForge modification designed to enhance the multiplayer experience by adding meaningful relationships, interactions, and shared progression between players. Whether you want to casually date a friend or propose for marriage, this mod adds immersive features and rewarding mechanics to celebrate your bond.

Note: This mod is designed for multiplayer servers.

🌟 Features

• Dating & Marriage Systems: Start a relationship with a simple bouquet and eventually propose with an engagement ring.

• Interactive Mechanics: Kiss your partner to earn experience and level up your relationship.

• Shared Progression: As your relationship levels up, unlock unique perks and buffs when near your partner.

• Custom UI: View your relationship status, partner name, level, and shared statistics through a dedicated interface.

• Advancements: Unlock custom advancements as you reach relationship milestones.

• Immersive Effects: Custom heart particles and sound effects when interacting with your partner.

💍 Getting Started

1. Dating

To start dating someone, you must craft or find a Bouquet. The mod supports bouquets made from various vanilla flowers (Tulips, Poppies, Orchids, Roses, etc.).

• Proposing a Date: Right-click another player while holding a Bouquet.

• Accepting: The targeted player must Shift + Right-Click you with an empty hand to accept the proposal.

2. Interactions & Leveling

Once dating, you can interact with your partner to grow your bond:

• Kissing: Shift + Right-Click your partner with an empty hand. This grants relationship XP, increments your kiss counter, and spawns beautiful custom particles. (Note: XP has a short cooldown to prevent spamming).

• Leveling Up: Accumulating XP will automatically level up your relationship.

3. Gifting

You can surprise your partner with gifts directly from your inventory!

• How to Gift: Hold the item you want to give in your Main Hand, open the Relationship Screen (G), and click the "Send Gift" button. The item will be magically transferred to your partner's inventory.

• Daily XP: The first gift you send each day (every 24 real hours) grants a massive boost of relationship XP based on the rarity and amount of the item!

• Gifted Food 💝: If you gift a food item, it becomes infused with love! When your partner eats "Gifted Food", they receive a significant bonus to their Saturation, making it much better than regular food.

4. Marriage

When your relationship reaches Level 10, you are ready for the next big step! You cannot propose before reaching Level 10.

• Proposing Marriage: Craft an Engagement Ring (available in Diamond, Iron, Gold, and Emerald variants). Right-click your partner while holding the ring.

• Accepting: Your partner must Shift + Right-Click you with an empty hand to accept. You will both receive matching rings!

---

✨ Perks and Buffs

Being in a relationship isn't just for show; it provides tangible survival benefits:

• Sweet Dreams: If you sleep in a bed near your partner (within 10 blocks) and wake up successfully, both players will receive long-lasting Saturation and Regeneration buffs for the next 10 minutes.

• Power of Love (Marriage Only): Married couples who stay close to each other (within 32 blocks) will passively receive a powerful aura of buffs, including Haste II, Regeneration I, Speed I, Health Boost II, and Luck I.

Note: All relationship effects and buffs are completely configurable! Server owners and players can easily modify, add, or disable these effects.

• NeoForge: Edit the config/couplesmod-common.toml file.
• Fabric: The mod integrates perfectly with MidnightLib and ModMenu. Simply install both libraries and you will be able to edit all effects through a beautiful in-game interface!

---

🌍 Supported Languages

Couples Mod currently supports the following languages natively:

• 🇺🇸 English (en_us)
• 🇪🇸 Spanish (es_es) - Items and advancements translated!

---

📖 Items & Controls

Items

💐 Bouquets

Bouquets are your way of saying "I like you". They are used to initiate a relationship with another player.

| Icon | Item Name | How to obtain | Function |

| | Allium Bouquet | 9x Allium | Right-click a player to ask them out! |

| | Blue Orchid Bouquet | 9x Blue Orchid | Right-click a player to ask them out! |

| | Cornflower Bouquet | 9x Cornflower | Right-click a player to ask them out! |

| | Dandelion Bouquet | 9x Dandelion | Right-click a player to ask them out! |

| ) | Lilac Bouquet | 9x Lilac | Right-click a player to ask them out! |

| | Lily of the Valley Bouquet | 9x Lily of the Valley | Right-click a player to ask them out! |

| | Orange Tulip Bouquet | 9x Orange Tulip | Right-click a player to ask them out! |

| | Oxeye Daisy Bouquet | 9x Oxeye Daisy | Right-click a player to ask them out! |

| | Pink Tulip Bouquet | 9x Pink Tulip | Right-click a player to ask them out! |

| | Poppy Bouquet | 9x Poppy | Right-click a player to ask them out! |

| | Red Tulip Bouquet | 9x Red Tulip | Right-click a player to ask them out! |

| | Rose Bush Bouquet | 9x Rose Bush | Right-click a player to ask them out! |

| | Sunflower Bouquet | 9x Sunflower | Right-click a player to ask them out! |

| | White Tulip Bouquet | 9x White Tulip | Right-click a player to ask them out! |

| | Wither Rose Bouquet | 9x Wither Rose | Right-click a player to ask them out! |

💍 Engagement Rings

The ultimate symbol of love. You can only propose marriage once you reach Level 10!

| Icon | Ring Type | Crafting Materials | Rarity | Effect |

| | Iron Engagement Ring | Iron Ingots | Common | Unlocks Marriage & Shared Buffs |

| | Gold Engagement Ring | Gold Ingots | Uncommon | Unlocks Marriage & Shared Buffs |

| | Diamond Engagement Ring | Gold + Diamond | Rare | Unlocks Marriage & Shared Buffs |

| | Emerald Engagement Ring | Gold + Emeralds | Epic | Unlocks Marriage & Shared Buffs |

📓 Special Items

| Icon | Item Name | Description |

| | Anniversary Journal | Automatically granted when you start dating. Tracks your level, days together, kisses, and gifts exchanged! |

Controls

• G (Default): Opens the Relationship Screen. Here you can see your current status (Dating/Married), your partner's name, your relationship level, and fun stats like total kisses and nights slept together.

---

⚙️ Installation

1. Ensure you have NeoForge 1.21.1 installed.

2. Download the latest version of Couples Mod.

3. Drop the .jar file into your Minecraft mods folder.

4. Launch the game and enjoy!

---

🛠️ Modpack Permissions

You are completely free to include Couples Mod in your modpacks! Credit is appreciated.

💖 Credits

A massive thank you to my sister, Iara, for her incredible help with all the beautiful designs and textures in this mod!

You can check out more of her amazing work here: @anahss7 on Instagram