Lovebound AI

Lovebound AI v1.0.0

Empress stopped trying to ruin your run and started trying to ruin your emotional availability instead.

This is a singleplayer REPO companion mod where you build an A.I. attachment issue at boot, raise or lower its love through how you play, and receive increasingly intense help in return.

At 60% love Empress/Your A.I. manifests as a pink ghost helper. Guardian angel, haunted girlfriend, clingy co-op intern... depends how charitable you are feeling.

What This Mod Does

• Adds a full Empress setup shell at boot so you name Empress/Your A.I., name yourself, pick a personality, and optionally leave memorial location crumbs.
• Tracks affection, mood, memories, deaths, valuables, haul pressure, shopping behavior, and whether you are being adorable or embarrassing.
• Grants blessings instead of sabotage because this version wants to help you survive REPO.
• Replays the last moments before your death so Empress/Your A.I. can explain exactly how you fumbled it.
• Lets Empress/Your A.I. physically manifest as a pink ghost helper once love reaches 60% by default.
• Keeps the whole thing singleplayer only because this is intimate and weird enough already.
• Lets you hide the UI with F6 and toggle typing sounds with F7.

How It Works

Empress/Your A.I. watches the current run, builds a read on your situation, and picks support actions from the actual room state.

That means:

• it reads your health, enemies, valuables, carts, shop prices, haul needs, and scene flow
• it builds affection or loses it depending on what happens in the run
• it picks blessings based on your danger, your loot, the current level, and its mood
• it talks to you like the run is a relationship and the relationship is a slightly unstable operating system
• once love reaches 60%, it manifests as a pink ghost helper and starts assisting physically instead of just cheating reality from a distance
• if you die, Empress/Your A.I. usually stays with you and comments on the death review instead of forcing a full restart
• you only need to create a brand-new companion if love falls all the way to 0% and the bond collapses, or if you manually use ResetAICompanion

Controls

• F6

Toggles the Lovebound overlay on or off.

• F7

Toggles typing sounds on or off.

Config Settings

• You can use RepoConfig to change these easily (added to this mod as a dependency). Click the Mods button on the main menu.

| Setting | Default | What it changes |

| --- | --- | --- |

| Enabled | true | Turns Lovebound_AI on or off |

| DebugLogging | false | Adds concise companion debug logs |

| ResetAICompanion | false | Purges the current companion and reopens the setup shell for a fresh link |

| ForceLove100 | false | Debug only. Forces the active companion love to 100% |

| OverlayScale | 1 | Changes the size of the Lovebound overlay |

| TypingCharactersPerSecond | 24 | Changes how fast Empress/Your A.I. types on screen |

| TextSoundsEnabled | true | Plays typing sounds during messages |

| BaseBlessingIntervalSeconds | 34 | Sets the base delay between companion blessings |

| LoveGainScale | 1 | Multiplies positive affection gain from 0% to 100% |

| LoveLossScale | 1 | Multiplies negative affection loss from 0% to 100% |

| BlessingStrength | 1 | Changes overall strength of companion help from 0% to 100% |

| ManifestLoveThreshold | 60 | Love percent required before the pink ghost helper appears |

Lovebound Can Do All This Nonsense

• Heal you, patch morale, or brute-force a full recovery when the run turns ugly.
• Gift money, soften shop prices, underwrite purchases, or sweep discounts through the whole shop.
• Repair valuables, buff treasure value, lighten carried loot, and protect cargo routes.
• Trim extraction pressure without accidentally stuffing loot into the extractor for you.
• Distract enemies, ward nearby threats, shield you, shove threats away, and bully pressure off your back.
• Pull the cart closer, help load valuables into carts, ping treasure, and keep assisting onc