Touhou Little Maid: Epistalove

This mod is an add-on for Contact: LoveRekindled and Touhou Little Maid, allowing maids to write letters to their masters.

You can get a quick overview from this
Bilibili video.

Letter Content

Letters can be generated in two ways: AI-generated or preset text, with full customization through data packs or KubeJS. See the official documentation for details.

To enable AI generation, follow the steps in the
official Touhou Little Maid guide.

AI generation is highly recommended — it can use in-game environmental data as prompts, allowing letters to naturally adapt to different situations.

When Letters Are Written

By talking to a maid using AI dialogue (press T on the maid), you can directly request a letter. This requires enabling the Function Call feature of Touhou Little Maid.

In other cases, maids write letters based on configured rules. See the official documentation.

Letter delivery works as follows:

Following mode: the maid hands the letter directly to the player.
HOME mode + nearby mailbox: the maid mails it through Epistalove; the player must retrieve it from their personal mailbox.
HOME mode + no mailbox nearby: the maid will hold the letter until a player or mailbox appears.

Best Example

The following KubeJS example makes the maid write a letter every time you earn a new advancement, with content related to that advancement.

For most well-known mods, the AI can recognize their advancements.

// server_scripts
LetterEvents.registerLetterRules(event => {
    // AI: First Gift
    event.createAI('advancement','lonesome',
        'As a maid, your master has just completed the Minecraft advancement ${adv}. This is an important moment—please write a short letter to your master about it.')
        .trigger('advancement').repeat().minAffection(0).maxAffection(500).cooldown(0).register();
});
PlayerEvents.advancement(event => {
    let advancement = event.advancement;
    if (advancement.description.empty) return;
    let str = `${advancement.displayText.getString()}:${advancement.description.getString()}`;
    if (advancement.description.getContents().getKey()) str += `(${advancement.description.getContents().getKey()})`;
    LetterAPI.triggerEventWithContext(event.player, "advancement", { adv: str });
});

Future Plans

Improve customization features.