Touhou Little Maid: Heart Pact - Introduction

Heart Pact is a romance and family expansion for Touhou Little Maid. It turns a maid from an adventuring companion into someone with whom you can build a long-term life: talk, give gifts, grow closer, confess your feelings, propose, hold a wedding, share sleep, raise a child, and keep making ordinary days meaningful together.

This is not only a collection of intimate actions. Mood, personal boundaries, work fatigue, relationship progress, daily companionship, little-maid growth, study, exploration, family ties, spirits, and revival are all part of the same continuing life with your maid.

Getting Started

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

Interaction Key: Default Alt + J. Opens the interaction screen for adult maids and little maids.

Headpat / Lift Key: Default Alt + K. Headpats a sitting adult maid, or lifts a standing little maid.

Rhythm Judgment Key: Default J. Used during rhythm gameplay in post-marriage sleep events. It can also be configured to skip rhythm gameplay.

The mod settings include player-facing options such as maid addressing, little-maid addressing, harem mode, interaction camera calibration, rhythm skip behavior, debug options, and other compatibility settings. The in-game Heart Pact Guide can be used again at any time for the full tutorial and feature reference.

Affection, Relationship, and Mood

Heart Pact follows Touhou Little Maid affection and adds relationship-gated interaction content.

0-31: Start by talking, giving suitable gifts, and spending time together.

32+: Headpats become available.

64+: Hugs become available.

128+: Kisses and deeper romance content begin to appear.

192+: Marriage content becomes available when other requirements are met.

If an option is missing, first check affection, ownership, adulthood, sitting or sleeping state, current relationship, and harem restrictions.

Mood has five broad tiers: depressed, low, normal, happy, and Master Love. It is not only a display value. Positive affection gains are reduced or unavailable when mood is low; normal mood gives standard gains, happy mood improves gains, and Master Love improves them further.

Mood also affects reactions. Repeated headpats, hugs, kisses, rude jokes, and over-intimate actions may be refused when she is upset or exhausted. A refused interaction gives no affection and may gently push the player away; this is a boundary response, not a bug. Talk with her, give an appropriate gift, let her rest, or wait for her mood to recover.

Continuous WORK schedules build fatigue. The longer she works, the more likely mood and affection rewards are affected. Resting, sitting, sleeping, or leaving the WORK schedule gradually clears fatigue and helps recovery.

Daily Interactions

The adult maid interaction screen contains daily chat, gifts, headpats, hugs, kisses, confession, marriage, and other context-sensitive actions. Daily dialogue pools cover casual conversation, weather, daily life, worries, rest, future plans, family topics, and more. Many interactions use expressions and emotion actions rather than only text.

At lover stage or above, the first daytime interaction of a new day can trigger a special Morning Kiss scene. Your maid takes the initiative, giving a small, sweet beginning to the day.

Hugging opens related actions such as kissing, continuing the hug, and letting go. Story-triggered intimate poses are protected from normal mood rejection so a cutscene will not be interrupted by an inappropriate knockback or refusal.

Confession, Proposal, and Wedding

Heart Pact uses a complete romance route rather than treating marriage as a single ring click.

1. Confession

After reaching the romance requirement, your maid may gather the courage to confess. Respond to her sincerely to become lovers and receive the Heart Pact advancement. Confession scenes use dedicated expressions and action timing; they are the beginning of the relationship, not the wedding itself.

2. Prepare Two Proposal Rings

Craft Proposal Rings with a diamond and an iron nugget. Marriage requires two brand-new, unbound Proposal Rings.

For the proposal engraving step, place one ring in the maid's main hand and one ring in the player's off-hand. Do not put both rings in the player's hands. Open the maid panel when the story asks you to prepare or check the rings, then continue only after both positions are correct.

3. First Engraving: The Proposal

The first ring step records the proposal. It is not yet the final marital vow. The two rings become your proposal-marked rings, and the story can continue toward the wedding. If the rings are already bound to another proposal or do not belong to this pair, the process will stop rather than consume the wrong items.

4. Dress Her for the Wedding

Before the wedding, make sure the maid is your adult maid, affection is at least 192, your inventory has room, the two proposal rings are ready, and you have the Cherry Blossom Wedding Dress.

During the wedding story, choose the option to dress her for the wedding. The maid panel will open: place the Cherry Blossom Wedding Dress in her chest armor slot, then confirm that she is wearing it before continuing. The wedding vows do not continue until the dress requirement is satisfied.

5. Vows and Final Exchange

After the wedding vows, the same proposal-marked rings are used again for the final exchange. Put them back in the required hand positions if the story asks you to check them. This second engraving turns the proposal into the final oath: both names are bound to the rings, the exchange is completed, and she becomes your wife.

The final exchange, thanks, vow kiss, and ending scene are part of the wedding sequence. An Oathbound Ring is not a normal craftable ring and cannot be reused to propose to someone else.

Gifts

Gifts are given from the interaction screen. Each player can normally make up to two successful gifts per day.

Flowers and Rainbow Bouquets mainly improve closeness. Sweets such as cookies, cake, pumpkin pie, honey bottles, sweet berries, apples, and golden apples are especially useful for soothing a poor mood. Meals such as bread, cooked meat, cooked fish, stew, and Sauce Duck steadily help mood recovery. Diamonds, emeralds, ingots, amethyst, quartz, lapis, and netherite scraps are valuable gifts that are accepted more readily at closer relationships.

Rotten flesh, spider eyes, poisonous potatoes, pufferfish, bones, and similar items may upset her or reduce affection. Proposal Rings, YES Pillows, hairpins, guides, debug tools, and marriage documents are not normal gifts.

Married Life, Sleep, and Pregnancy

After marriage, your maid receives a YES Pillow. When she sleeps in a maid bed and the player is near a valid vanilla bed, post-marriage sleep content can trigger. Some events use rhythm gameplay; the player may use the rhythm key, or use the configured skip option.

Normal sleep pregnancy chance begins at 20%, rises by 5% after each failure up to 50%, and guarantees pregnancy after eight consecutive failures. Rhythm gameplay uses a separate 0%-60% chance based on score; skipping or timing out counts as 0 score and does not use the normal-sleep guarantee.

Pregnancy has a 2% chance of twins. Gestation length, little-maid growth length, and postpartum recovery are server common-config values, so multiplayer servers may use different timings.

Little Maids and Family Life

After birth, the child becomes a little maid. On her first day she cannot be placed on the ground; her mother will hold her and provide matching feedback. The default name is Little Maid. While she is still an infant and has not been renamed, her name can be chosen once.

Little-maid interactions include headpats, lifting, asking her mother to hold her, chatting, and gifts. Adult daughters also have their own family-oriented dialogue instead of simply reusing an adult maid's normal conversation pool.

The Family Tree Viewer can be used on a maid to show her parents, grandparents, spouse, and direct children in chat. The Marriage Consent Form transfers guardianship of an adult child maid to another player; it is not a direct marriage item. The new owner must build affection and progress the relationship normally.

If a born little maid dies, she may remain as a spirit. Soothe her, help her remember home and family, guide her with a soul lantern, bring her near her mother for family scenes, and build Longing through daily soothing and suitable offerings. At high Longing, a revival route may become available.

Little-Maid Tasks

Little maids can study and work only during the maid's WORK schedule. Sitting, sleeping, and rest time pause task progress. Required materials must be in the main hand or backpack.

Enchanting Study uses books and gives enchanting-related rewards.

Alchemy Study uses glass bottles or potions and gives potion-related rewards.

Tactics Study uses swords, axes, bows, crossbows, or tridents and gives combat-related rewards.

Exploration uses a stick. Higher affection reduces empty returns and injuries while improving reward quantity and rare finds. Very low mood stops exploration.

Low mood and fatigue reduce task quality, so caring for a little maid's daily state matters as much as supplying materials.

Camera Calibration and Guide

Different maid models can have different heights, head bones, and camera positions. If hugs, kisses, or lap pillow do not align well, open the relevant interaction screen and use the pencil button near the exit button to adjust camera scale and vertical position. First-person view is recommended while calibrating. Saved camera settings are local to the player and do not affect a server or other players.

The Heart Pact Guide follows the selected story language and explains relationship stages, mood and fatigue, gifts, rings, wedding dress requirements, sleep, pregnancy, family systems, little-maid tasks, spirits, and troubleshooting in more detail.

One-Sentence Summary

Heart Pact is a long-term Touhou Little Maid relationship and family journey: from ordinary conversations and shy first confessions, through a two-stage proposal and wedding vows, to sleeping beside one another, raising a little maid, and building a home that keeps growing with both of you.

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.

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:

1. 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.
2. 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婚后 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.