Touhou Little Maid: Heart Pact

Touhou Little Maid: Heart Pact - Introduction

Heart Pact is an expansion mod that pushes Touhou Little Maid toward a Galgame-style long-term companionship experience centered on love, marriage, and family. Built around the core concept of "living a complete life together with your maid," it fully implements the following features:

• Daily Interactions: Talking, gift-giving, headpats, hugs, kisses – gradually increase affection.
• Romance Stages: Confession, dating, exchanging rings, holding a wedding ceremony.
• Married Life: Sharing a bed, pregnancy system, child-rearing system.
• Offspring Raising: Growth stages for little maids, specialized tasks, interactive content.

This mod lets you and your maid transition from a master-servant relationship, step by step, through infatuation, confession, marriage, sharing a bed, and pregnancy, ultimately turning her from an adventuring partner into family with whom you spend your life.

How to Play

After launching the game, open "Options -> Controls -> Heart Pact" and check three keybinds:

• Interaction Key: Default Alt + J – Opens the interaction interface for adult maids or little maids.
• Headpat/Lift Key: Default Alt + K – Performs a headpat on a seated maid, or lifts up a standing little maid.
• Rhythm Judgment Key: Default J – Used during rhythm gameplay in slumber events. Can also be set to skip in mod settings.

Keybinds are based on Minecraft's vanilla control settings. In the mod settings page, you can adjust lift height, hug distance, addressing, harem mode, rhythm skip, and debug display. Lift height offset defaults to 0.10, adjustable from -0.20 to 1.50. Hug lock distance defaults to 0.80, adjustable from 0.10 to 2.00.

Affection Stages

This mod follows the Touhou Little Maid affection system and adds several thresholds within the romance progression:

• 0-31: Initial stage. Start by chatting, gifting, and caring for her.
• 32+: Headpat unlocked.
• 64+: Hug unlocked.
• 128+: Confession, kisses, and dating-related content begin to appear.
• 192+: Marriage threshold.
• 384: Vanilla three-tier affection cap.

If the threshold hasn't been reached, the corresponding intimate options will not appear. This isn't a bug – the relationship simply hasn't progressed far enough.

Adult Maid Interaction

In the adult maid interaction interface, you can:

• Communicate: Topics like chat, weather, daily life, thoughts, rest, future, etc.
• Headpat: Light intimate interaction, also good for comforting her.
• Hug: Appears after 64 affection.
• Kiss: Appears after 128 affection.
• Confess: Appears after reaching the dating stage. Upon acceptance, grants the "Hearts Entwined" advancement.
• Marry: Appears after 192 affection. Requires two unbound proposal rings.
• Give Gifts: Opens the gift interface to select items from your inventory to give her.
• Put Down Little Maid / Name Child: Appears when the maid mother is holding a child.

Some options are hidden depending on her mood, whether she's holding a child, whether you're already married, harem mode settings, etc.

Kiss Camera Calibration

Different maid models have inconsistent heights, head bone positions, and camera perspectives. If hugs or kisses don't align properly with the face, use the camera calibration button in the interaction interface.

How to use:

1. Open the interaction interface with an adult maid and navigate to the hug/kiss related screen. First-person view is recommended for easiest judgment of kiss alignment.
2. Click the pencil calibration button near the exit button in the bottom-right corner of the interface to open the camera calibration panel.
3. "Zoom" controls camera distance. Higher values make the view appear closer; dial it back if faces clip too much.
4. "Vertical" controls camera pitch. Adjust upward if the maid's face appears too high, downward if too low.
5. Click save once adjusted. Settings are written to config/maidmarriage/hug-camera.json locally, affecting only your client, not the server or other players.

Generally, calibrating once per model set is sufficient. You can recalibrate after switching to models with significant height differences, changing screen resolution, or altering view preferences.

Mood System

A maid's mood is divided into five tiers:

• Frustrated
• Low
• Normal
• Happy
• Darling LOVE

Mood affects affection gains:

• Frustrated/Low: Positive interactions grant no affection.
• Normal: Standard gains.
• Happy: Approximately 1.5x gains.
• LOVE: Approximately 2x gains.

Chatting, joking, intimate actions, and gift-giving are all affected by mood. Continuing to joke, offend her, or over-interact when her mood is low will directly reduce affection. If a lover or wife goes several days without meaningful interaction, she will enter a state of wanting companionship.

Gift System

Gifts must be given through the gift UI in the interaction interface. Maximum of two gifts per day.

Gifts are roughly categorized as:

• Flowers: Ordinary flowers, rainbow bouquets. Primarily improve relationship. Rainbow bouquets can be given repeatedly.
• Sweets: Cookies, cake, pumpkin pie, honey bottle, sweet berries, apple, golden apple, etc. Better for comforting low moods.
• Meals: Bread, milk, cooked meat, cooked fish, stew, sauce duck, etc. Stabilizes mood recovery.
• Valuables: Diamond, emerald, gold ingot, iron ingot, amethyst, quartz, lapis lazuli, netherite scrap, etc. Closer relationships yield better feedback.
• Strange Gifts: Bones, spider eyes, etc. May cause discomfort.
• Offensive Gifts: Rotten flesh, poison potato, fermented spider eye, pufferfish, etc. Decrease mood and affection.