Heartbound

Major changes added after 5.0.0 up to 5.5.5:

1. Partner Talent Tree

Added a complete Partner Talent Tree system.

The Talent Tree opens with the G key when the player has a valid Partner. It contains three branches:

- Companionship
- Support
- Adventure

Each branch has 6 talents, for a total of 18 talents.

Talent rules:
- Each talent costs 1 Talent Point.
- Talent 1 in each branch can be unlocked first.
- Talents 2 and 3 require Talent 1.
- Talent 4 requires Talents 2 and 3.
- Talents 5 and 6 require Talent 4.
- Talent Points are earned through Partner Missions.
- Talents reset if the Partner relationship is lost.

The Talent Tree UI was redesigned with a dark romantic style using pink, purple, blue, and gold branch themes. Talent nodes now use cleaner visual states instead of numbers or checkmarks. Tooltips were improved and given solid backgrounds so icons, text, and lines behind them no longer show through.

2. Partner Talent Missions

Added the Talent Missions system.

Players receive 4 active Partner Missions. Completing all 4 missions grants +1 Talent Point. After completion, a real-time cooldown begins before a new mission set can appear.

Mission system features:
- 4 active missions per set.
- Completing all 4 grants +1 Talent Point.
- 1 hour real cooldown after a completed set.
- Mission reroll system.
- 4 reroll sets per reward step.
- Mission difficulty scales with talent progress.
- Debug commands for testing missions, cooldowns, points, and talent states.
- Cleaner mission UI without technical clutter such as tier/progress/debug text in normal gameplay.

3. Partner Loss Talent Reset

Added full reset protection when the Partner relationship is lost.

If the Partner dies, leaves, reaches relationship-breaking states, goes with the Male, or is no longer a valid Partner, the talent system resets.

Reset includes:
- Talent Points reset to 0.
- Unlocked talents reset to 0.
- Mission progress resets.
- Cooldowns reset.
- Reroll set resets.
- Talent effects stop working.
- Talent Tree closes if it was open.
- A future new Partner starts from zero.

This prevents keeping powerful Partner bonuses after losing the relationship.

4. Companionship Talent Effects

Added all 6 Companionship talents.

Companionship focuses on emotional bond, protection, and survival near the Partner.

Companionship 1 — Loyal Bond
When you are hurt within 10 blocks of your Partner, she grants Regeneration I for 6 seconds.
Cooldown: 45 seconds.

Companionship 2 — Calm Presence
When you stay within 10 blocks of your Partner, harmful effects on you expire slightly faster.

Companionship 3 — Steady Steps
When your Partner is nearby, short falls hurt you 20% less.

Companionship 4 — Reassuring Voice
When your health drops to 4 hearts or less near your Partner, she grants Absorption I for 12 seconds.
Cooldown: 2 minutes.

Companionship 5 — Protective Rage
When multiple different mobs attack you near your Partner, she grants Strength II for 30 seconds.
Cooldown: 10 minutes.

Companionship 6 — True Companion
When you fall to 1 heart within 10 blocks of your Partner, she restores you to full health if she is at full health. She loses 50% health.
Cooldown: 30 minutes.

5. Support Talent Effects

Added all 6 Support talents.

Support focuses on supplies, helpful items, food efficiency, extra resources, and support potions.

Support 1 — Care Package
Your Partner occasionally brings you a small support item when you are nearby.
Rare rewards are possible.
Cooldown: 10 minutes.

Care Package flow:
- If the roll fails, nothing happens.
- If she has something, she says: “I have something for you.”
- She walks toward the player.
- When close enough, she drops the item.
- No extra message after the drop.
- Anti-dupe protection cancels delivery if she cannot reach the player.

Care Package rewards:
- 1% Golden Apple
- 5% Potion of Healing I
- 10% 5 Apples
- 50% 5 Cooked Porkchops
- 34% Nothing

Support 2 — Potion Support
Your Partner occasionally throws you a helpful splash potion when you are nearby.
Cooldown: 5 minutes.

Potion Support flow:
- She says: “This could be helpful.”
- She walks toward the player.
- She throws a real splash potion using a witch-like throwing style.
- The effect is not applied directly.
- The item is not placed in the inventory.
- The potion is not dropped as loot.

Potion Support possible effects:
- Night Vision I
- Strength I
- Jump Boost I
- Speed I
- Regeneration I

Water Breathing was removed from Potion Support and replaced with Regeneration.

Speed and Jump Boost conflict protection was added:
- Potion Support should not choose Speed if the player already has Speed from another source.
- Potion Support should not conflict with Adventure speed logic.

Support 3 — Gentle Encouragement
When you stay near your Partner, your hunger drains 25% slower.

Support 4 — Lucky Support
When you kill a hostile mob near your Partner, it has a 30% chance to drop extra loot.

Support 5 — Partner’s Fortune
When you mine ores near your Partner, they have a 20% chance to drop extra resources.

Support 6 — Comforting Meal
When you eat near your Partner, your natural healing is improved for a short time.

6. Removed/Reworked Sweet Negotiator

An earlier Support 2 concept called Sweet Negotiator attempted to reduce Villager trade prices by 20% while the Partner was nearby.

It was removed/reworked because Minecraft’s vanilla MerchantOffer synchronization and visual discount display were unreliable. Several versions attempted to make the red vanilla discount line appear, including direct MerchantOffer edits, specialPriceDiff changes, refresh packets, and debug checks. The system detected trades, but the visual/result behavior was inconsistent.

Sweet Negotiator was abandoned and replaced with Potion Support, which is more reliable, more fun, and fits the Partner’s support role better.

7. Adventure Talent Effects

Added all 6 Adventure talents.

Adventure focuses on exploration, movement, terrain, water travel, containers, combat support during exploration, and deep cave visibility.

Adventure 1 — Traveling Pace
After sprinting 50 blocks with your Partner following you, you gain Speed I while you keep running.

Rules:
- Partner must be valid and alive.
- Partner must be in Following mode.
- Partner must be nearby.
- Player must sprint.
- Player must travel 50 blocks with the Partner.
- Does not activate if the player already has Speed from a potion, beacon, Potion Support, command, or another mod.
- If the player stops, the effect stops renewing.
- The Partner only receives extra speed when needed to keep up with the mod’s own speed logic.

Adventure 2 — Explorer’s Step
After climbing 20 blocks with your Partner nearby, you gain Jump Boost I while you keep moving through rough terrain.

Rules:
- Partner must be valid and alive.
- Partner must be nearby.
- Requires climbing or gaining vertical terrain progress.
- Does not activate instantly.
- Does not activate if the player already has Jump Boost from a potion, Potion Support, command, or another source.
- If the player stands still, Jump Boost stops renewing and turns off.

Adventure 3 — River Crossing
When crossing water near your Partner, you gain Water Breathing and Dolphin’s Grace.

Rules:
- Works while in water near the Partner.
- Helps the player breathe and swim faster.
- No cooldown.
- Requires a valid nearby Partner.

Adventure 4 — Rare Find
When opening adventure containers near your Partner, there is a small chance of extra treasure.

Rules:
- Works on exploration-style containers such as chests/barrels from structures.
- Each container should only attempt the bonus once.
- Does not spam loot infinitely.
- Does not affect normal player-placed containers in an exploitable way.

Adventure 5 — Monster Remedy
Your Partner throws a special splash potion at nearby hostile mobs. It only harms enemies and cannot heal you.

Rules:
- This is the only Adventure talent with a cooldown.
- Cooldown: 60 seconds.
- Visual style: splash potion thrown like a witch.
- It targets hostile mobs.
- It does not heal the player.
- It does not heal the Partner.
- It does not heal animals.
- It does not accidentally heal mobs.
- While using Monster Remedy, the Partner temporarily does not panic from mobs so she can throw the potion.

Adventure 6 — Deep Cave Vision
When you explore below Y -1 with your Partner nearby, you gain Night Vision until you return above Y 1.

Rules:
- Activates at Y <= -1.
- Stops renewing at Y >= 1.
- Uses separate activation/removal thresholds to prevent flickering around Y 0.
- No cooldown.
- Requires valid nearby Partner.

8. Adventure Polish and Bug Fixes

Several Adventure bugs were fixed.

Fixes include:
- Partner became too fast while trying to keep up with player Speed.
- Traveling Pace activated too easily.
- Traveling Pace now requires sprinting 50 blocks with Partner.
- Speed will not activate if the player already has Speed from another source.
- Explorer’s Step / Jump Boost activated instantly.
- Explorer’s Step now requires climbing 20 blocks with Partner.
- Jump Boost will not activate if the player already has Jump Boost from another source.
- Jump Boost stops renewing when the player stands still.
- River Crossing now includes Dolphin’s Grace in addition to Water Breathing.
- Monster Remedy potion throw was improved to feel more like a witch-style splash potion.
- Potion Support was updated to use the same more realistic throw style.

9. Talent Tooltip and UI Improvements

The Talent Tree UI received several visual fixes.

Changes:
- Removed node numbers.
- Removed green check marks.
- Removed unfinished “future effect” style text.
- Added meaningful talent names and descriptions.
- Improved hover tooltips.
- Fixed tooltip transparency by drawing a fully solid background.
- Tooltip now hides icons, stars, lines, Available Points text, and bottom text behind it.
- Tooltip applies correctly to all 18 talents.
- Missions tab stayed clean and centered.
- Reroll button and mission footer were preserved.
- Technical mission tier/progress/set text was removed from normal UI.

10. Partner Detection Fixes

Talent opening and effects were made less strict and more reliable.

Fixes:
- Talent Tree opens if the girl is alive and has Partner/Friendship 100/100.
- UI should allow valid Partners even if older internal names/tags differ.
- Talent Tree blocks correctly if Partner is lost, Doubt 100, The Truth state, or Male-leave state.
- “You need a Partner to open talents” spam was throttled.
- Effects stop if Partner becomes invalid.

11. Commands and Debug Tools

Added or preserved multiple commands for testing.

Examples:
- /girlfriend talentpointsset 18
- /girlfriend talentstatus
- /girlfriend talentall
- /girlfriend talentsreset
- /girlfriend talentunlock companionship 1
- /girlfriend talentunlock support 1
- /girlfriend talentunlock adventure 1
- /girlfriend talentmissionscomplete
- /girlfriend talentmissionsreset
- /girlfriend talentmissionscooldownskip
- /girlfriend talentmissionsreroll
- /girlfriend talentmissionsset 1
- /girlfriend talentmissionsset 2
- /girlfriend talentmissionsset 3
- /girlfriend talentmissionsset 4
- /girlfriend talentmissiondebug

Debug tools helped test talent states, points, missions, cooldowns, and progression.

12. General Balance Direction

The final design separates the three branches clearly:

Companionship:
Emotional bond, protection, emergency survival, relationship-based mechanics.

Support:
Supplies, food efficiency, potion help, resource drops, mining fortune, and healing support.

Adventure:
Movement, terrain, swimming, exploration loot, monster support during exploration, and deep cave visibility.

13. Beta Release Notes

This version is suitable as a Beta release because the main systems are complete but may still need balancing and bug reports from players.

Players should report bugs related to:
- Talent unlocking.
- Mission progression.
- Partner detection.
- Talent reset after losing Partner.
- Potion Support.
- Care Package delivery.
- Adventure movement effects.
- Monster Remedy targeting.
- Rare Find containers.
- Deep Cave Vision.
- Partner follow behavior while Speed/Jump effects are active.

14. Male Character, Suspicion, Doubt, The Truth, and Revenge Systems

Added and expanded the Male Character storyline and relationship conflict systems.

This system adds a third character dynamic around the Partner, the player, and the Male Character. It introduces suspicion, doubt, jealousy, confrontation, consequences, and possible relationship loss.

Main systems added:

- Male Character interaction system.
- Suspicion system.
- Doubt system.
- Ignore Suspicion option.
- Gifts system connected to Doubt.
- The Truth event.
- Partner leaving consequences.
- Male-related cooldowns and visit progression.
- Revenge system.
- Partner reset when the relationship is broken.

Suspicion System:
The Male Character can build Suspicion over time. When Suspicion reaches 100/100, new choices become available in the Male Character menu.

Added option:
- Confront
- Ignore Suspicion

Ignore Suspicion:
When Suspicion reaches 100/100, the player can choose Ignore Suspicion. This starts the Partner’s Doubt system.

Doubt System:
Doubt is a new relationship pressure bar for the Partner. It represents uncertainty, emotional conflict, and damage to trust.

When Doubt is active:
- The Partner can begin doubting the relationship.
- Male-related behavior becomes more dangerous.
- The player must respond carefully.
- Gifts can be used to reduce Doubt.
- If Doubt reaches 100, the relationship can break.

Male Gift Behavior:
When Suspicion is at 100 and Doubt is active, the Male Character can throw visual gifts toward the Partner.

Gift examples:
- Flowers
- Emeralds
- Diamonds

When the visual gift reaches the Partner:
- The item is removed.
- It does not become free loot.
- Doubt increases.

This makes the Male Character feel active without creating item duplication.

Partner Gifts System:
Added a Partner Gifts menu.

The Partner menu now includes:
- Gifts

The Gifts screen shows:
- Doubt bar
- 3 gift slots

The player can hold a valid gift item and click one of the slots to give it to the Partner.

Gift behavior:
- The item is stored visually in the gift slot.
- In Survival mode, the item is consumed.
- Valid gifts reduce Doubt.
- The Partner responds with dialogue depending on the gift.
- Gifts help repair the relationship if Doubt is active.

Valid gifts include:
- Heart Bloom
- Diamond
- Golden Apple
- Emerald
- Golden Carrot
- Honey Bottle
- Flowers

The Truth:
Added The Truth event as a major consequence state.

If the relationship conflict becomes too severe:
- The Partner can discover the truth.
- The relationship can break.
- The Partner can leave.
- Talent systems reset if the Partner is lost.
- Partner bonuses stop working.

Partner Loss Integration:
Male/Doubt/The Truth systems are connected to the Talent Tree reset system.

If the Partner is lost because of:
- Doubt reaching 100
- The Truth event
- Partner leaving with the Male
- Broken relationship state

Then:
- Talent Points reset to 0.
- Talents reset.
- Mission progress resets.
- Talent effects stop.
- Talent Tree cannot open.
- A future new Partner starts from zero.

Revenge System:
Added revenge-related consequences connected to the relationship conflict arc.

The revenge system expands the aftermath of betrayal or relationship collapse and gives the storyline stronger consequences.

Male Debug/Test Commands:
Added commands for testing the Male and suspicion systems.

Examples:
- /girlfriend malevisitprogress 10
- /girlfriend malestatus
- /girlfriend malevisitstart
- /girlfriend malecooldownskip
- /girlfriend suspicionset 100
- /girlfriend maleignoresuspicion

Purpose of the Male System:
The Male system makes the relationship feel less static. It adds emotional pressure consequences, jealousy, and decisions that can affect the future of the Partner relationship