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:

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.

Click the pencil calibration button near the exit button in the bottom-right corner of the interface to open the camera calibration panel.

"Zoom" controls camera distance. Higher values make the view appear closer; dial it back if faces clip too much.

"Vertical" controls camera pitch. Adjust upward if the maid's face appears too high, downward if too low.

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.

Special items like proposal rings, YES pillows, golden dandelion hairpins, and marriage consent forms cannot be given as regular gifts.

Items & Uses

Proposal Ring
Crafted with diamond + iron nugget. Can be worn as a maid ring accessory. Two unbound rings are required for marriage (one in the player's main hand, one in the off-hand).

Oathbound Ring
Created during the wedding process by engraving both names onto a proposal ring. Essentially a maid ring accessory marked by the oath, not a regular craftable item. Once engraved with names, it cannot be used to propose to someone else.

YES Pillow
Crafted with white wool and red wool. Given to the maid upon successful marriage. Used in the slumber process after marriage.

Rainbow Bouquet
Crafted with oxeye daisy, poppy, cornflower, pink tulip, and dandelion in no particular order. Suitable for gift-giving.

Golden Dandelion Hairpin
Crafted with clock + gold ingot + dandelion in no particular order. A maid accessory. When placed in a little maid's accessory slot, pauses growth; when removed, the little maid resumes growing normally based on days passed.

Sauce Duck
Crafted with cooked chicken surrounded by a ring of cocoa beans. Feeding it to a little maid shortens growth time; feeding it to a postpartum maid shortens remaining recovery time.

Marriage Consent Form
Crafted with book + proposal ring in no particular order. Used for transferring custody of an adult daughter maid. Not a direct marriage item.

Family Tree Viewer
Crafted with bone meal + book in no particular order. When held and right-clicked on a maid, displays her family relationships in chat.

Family Tree Viewer & Marriage Consent Form

Family Tree Viewer is simple to use: hold it and right-click a maid. Chat will display the maid's own information, maternal line, paternal line, grandparents, spouse, and direct offspring (up to 8 displayed). If certain relatives are not in the current world or their names cannot be resolved, they will appear as "Unknown" or a UUID abbreviation.

Marriage Consent Form is used to betroth your adult daughter maid to another player. To put it plainly: you are entrusting your daughter to another player to re-cultivate the relationship. It is not a normal marriage item and does not skip the other player's subsequent romance process. The process has two steps:

The current owner, holding the form, right-clicks an adult daughter maid. The form binds to this daughter, displaying "Bound Maid" in the item tooltip.

Continuing to hold the same form, right-click the target player. The target cannot be yourself, nor a direct blood relative within two generations of the maid.

After successful betrothal, the maid is transferred to the target player's management, marriage data is cleared, and affection resets to 0. The target player must then build the relationship from scratch to continue confessing or marrying.

If the form is already bound to a maid and you right-click another adult daughter maid, it will rebind to the new maid and clear the previous target player binding.

Marriage & Slumber

Marriage Requirements:

Your own adult maid.

Affection reaches 192.

One unbound proposal ring in both the player's main hand and off-hand.

Not blocked by harem mode or marital status.

Upon successful marriage, the maid receives a YES pillow. Afterwards, when she sleeps in a maid bed and the player sleeps in an adjacent vanilla bed under suitable conditions, a slumber event can trigger. The slumber may enter rhythm gameplay or can be skipped in settings.

Pregnancy Probability – Two Systems:

Normal Slumber: 20% on first attempt, +5% after each failure (max 50%). If 8 consecutive failures occur, the next attempt guarantees pregnancy.

Rhythm Gameplay: Pregnancy rate converts from 0% to 60% based on performance. Does not include the failure pity system from normal slumber. Skipping or timing out scores 0.

Normal slumber follows this curve: approximately 3.4 attempts on average to achieve pregnancy; about 58% succeed within 3 attempts, about 91% succeed within 6 attempts, success guaranteed by the 9th attempt. Upon successful pregnancy, there is a 2% chance of twins. When the normal slumber consecutive failure pity triggers, it directly results in twins.

Gestation days, child growth days, and postpartum recovery period are controlled by server common configuration.

Little Maids & Family

After birth, the child becomes a little maid. On the first day, she cannot be placed on the ground and must be held by her mother. The default name is "Little Maid." While she is in the infant stage and hasn't been renamed, you can give her a name – only once.

Little Maid Interactions include:

Headpat

Lift up

Let mother hold her

Talk with her

Give her gifts

While being lifted, the little maid is immune to suffocation damage from blocks. When the player glides with an elytra, she can continue being carried and will occasionally comment on the feeling of flight, gaining a small amount of mood.

Little Maid Tasks

After reaching the child stage, little maids can be assigned tasks. Tasks only progress during the maid's WORK schedule; sleeping, sitting, and resting pause progress.

Enchanting Studies
Condition: Book in main hand or inventory.
Result: Enchanting-related rewards. Low mood may yield only ordinary books or low-level outcomes.

Alchemy Studies
Condition: Glass bottle or potion in main hand or inventory.
Result: Potion-related rewards. Low mood may degrade results to water bottles, awkward potions, etc.

Tactics Studies
Condition: Weapon in main hand or inventory – sword, axe, bow, crossbow, trident all work.
Result: Combat-related rewards. Low mood yields only low-quality combat items.

Exploration
Condition: Stick in main hand or inventory.
Result: Randomly brings back supplies. Higher affection reduces the probability of returning empty-handed or injured, and increases the quantity of rewards and chance of rare finds. Mood dropping to 0 stops exploration entirely.

Frequently Asked Questions

Why aren't options appearing?
Usually due to insufficient affection stage, the target not being your own maid, using the wrong entry for adult/little maid, the maid sitting or sleeping, or harem mode restrictions.

Why does marriage fail?
Check that both rings are unbound proposal rings. Rings that have already been engraved cannot be reused.

Why aren't tasks progressing?
Confirm that the little maid has a backpack, is in the WORK schedule, is not sitting or sleeping, and the required material is in her main hand or inventory.

Why are multiplayer servers different from single player?
Gestation days, growth days, and postpartum recovery are controlled by server common configuration. Pregnancy probability follows the two fixed rules (normal slumber/rhythm gameplay) described above. Harem mode is a player-local setting synced to the server.

One-Sentence Summary

This mod expands Touhou Little Maid from a simple adventuring companion into a slowly cultivated Galgame-style emotional journey. From morning greetings to late-night chats, from casual headpats to earnest hugs, from giving a heartfelt gift to finally mustering the courage to say "I like you" – you'll grow closer through countless ordinary days. When your feelings deepen enough, you can solemnly confess, place a handcrafted ring on her finger, and make a vow to spend your lives together. On post-marriage nights, she will fall asleep peacefully beside you, and one day tell you that surprising news with flushed cheeks. Then, you will wait together, anticipate together, and finally welcome the little life that resembles both you and her. From that moment on, she is no longer just a maid, lover, or wife – she is family with whom you share your life. And you are no longer just a solitary adventurer – you are a husband, a father, and the protagonist of this complete story.

For the complete illustrated guide, please visit my GitHub