Home›Java›Mods›Touhou Little Maid: Heart Pact
Touhou Little Maid: Heart Pact
ModsJava

Touhou Little Maid: Heart Pact

Java mod listed for Minecraft 1.20. File opened and checked on 4 Oct 2026; downloads from the MC Java Mods app on Android.

by yunchenqwq · on Modrinth

⬇ Download on Modrinth
Touhou Little Maid: Heart Pact — screenshot 1Touhou Little Maid: Heart Pact — screenshot 2Touhou Little Maid: Heart Pact — screenshot 3Touhou Little Maid: Heart Pact — screenshot 4Touhou Little Maid: Heart Pact — screenshot 5Touhou Little Maid: Heart Pact — screenshot 6Touhou Little Maid: Heart Pact — screenshot 7Touhou Little Maid: Heart Pact — screenshot 8

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:

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. hug

How to Play

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

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:

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:

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:

Mood affects affection 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:

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:

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 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:

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.main ui

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

File checked by MCModsHub

These come from our own check of the pack file, not from the source page.

Explore more