promotional bannermobile promotional banner

Heartbound

**Girlfriend Mod** adds unique companion girls to Minecraft NeoForge. They can spawn naturally in villages, build friendship with you, complete missions, follow you, stay in place, sleep, open doors, and defend themselves from danger..
Back to Files

girlfriend-4.0.0.jar

File namegirlfriend-4.0.0.jar
Uploader
Babayi79Babayi79
Uploaded
Jun 6, 2026
Downloads
233
Size
440.9 KB
Mod Loaders
NeoForge
File ID
8203299
Type
B
Beta
Supported game versions
  • 1.21.1

Curse Maven Snippet

NeoForge

implementation "curse.maven:patner-mod-1562404:8203299"

Learn more about Curse Maven

What's new

Version 4.0.0

Major update: Equipment, Armor, Patience, HUD, and final polish.

New:
- Added functional armor slots to the Equipment Menu.
- Added Helmet, Chestplate, Leggings, and Boots slots.
- Armor slots now behave like real container slots.
- Each armor slot only accepts the correct armor type.
- Equipped armor is now visible on the companion.
- Armor now protects the companion during combat.
- Armor now loses durability when the companion takes damage.
- If armor breaks, it disappears from the armor slot and visually disappears from the companion.
- Added item break sound when armor breaks.
- Added item break sound when weapons break.
- Added improved HUD system.
- Added HUD display when looking at a companion’s hitbox.
- Added Friendship HUD display when looking at a companion.
- Added Patience HUD display when the companion is angry.
- Added Patience countdown timer so players can see when she will calm down.
- Added cleaner 4.0.0 HUD layout with improved borders, bars, and alignment.
- Updated mod metadata.
- Updated author name to Babayi79.
- Added shorter and cleaner mod description.

Patience System:
- Added new Patience system for accidental hits.
- Hitting your companion once no longer immediately lowers Friendship.
- The first hit puts her into an angry state instead.
- Angry state lasts 5 minutes.
- While angry, the HUD changes from Friendship to Patience.
- While angry, menus are blocked.
- While angry, right-clicking her does not open Partner Menu, Equipment, or Missions.
- Patience starts at 100.
- Each additional hit while angry lowers Patience by 20.
- Each Patience drop shows a unique message in chat.
- If Patience reaches 0, she drops back to Friend.
- Follow and Stay are disabled when Patience reaches 0.
- After dropping to Friend, additional hits lower relationship normally.
- If the relationship reaches 0 after the Partner → Patience → Friend path, the relationship becomes permanently locked.
- When permanently locked, she will no longer accept gifts, give missions, open Partner Menu, or rebuild the relationship.
- Permanent lock message: “I don't want anything to do with you anymore.”
- Special breakup messages now only appear after the Partner → Patience → Friend path.
- Special breakup messages no longer appear in new or normally low relationships.
- Special breakup messages are chat-only and do not appear inside the conversation UI.
- Fixed spam issues with Patience and breakup messages.
- “Don't talk to me right now. I'm upset.” now only appears once.
- After that, looking at her shows the Patience HUD instead.

Equipment / Combat Fixes:
- Fixed weapon and armor durability behavior.
- Fixed weapons breaking correctly.
- When a weapon breaks, the Weapon slot becomes empty.
- When a weapon breaks, the weapon disappears from her hand.
- After a weapon breaks, she returns to normal unarmed behavior.
- If unarmed and cornered, she can punch again.
- If unarmed and not close enough to the threat, she runs away as before.
- Fixed armor breaking correctly.
- Fixed armor disappearing visually after breaking.
- Fixed item break sounds for weapons and armor.
- Fixed visual issue with the arm / sleeve during punch and weapon animations.
- Fixed a remaining visual artifact when she raises her arm.
- Fixed a small running issue when she had a weapon in Stay mode.

HUD / Visual Fixes:
- Added hitbox-look HUD detection.
- HUD now appears when looking at a companion.
- HUD disappears when looking away.
- Fixed HUD flickering/parpadeo when aiming at different parts of the companion hitbox.
- Improved HUD hitbox tolerance so it does not depend on one exact point.
- Improved Patience timer display.
- Improved HUD layout for 4.0.0.
- Cleaned up HUD borders and bar alignment.
- Fixed visual instability in the Patience countdown.

Stability:
- Kept Weapon slot anti-duplication behavior.
- Kept Armor slot anti-duplication behavior.
- Kept Partner Menu behavior.
- Kept Equipment Menu behavior.
- Kept Follow and Stay combat behavior.
- Kept allowed hostile mob system.
- Kept weapon persistence.
- Kept armor persistence.
- Improved final polish for the 4.0.0 release.

This mod has no additional files