TLM Self-Talk

给 Touhou Little Maid（车万女仆）添加「自言自语 / 欢迎语 / 互相对话」的附属 Mod。

功能

• 女仆自言自语：主人在线/主人离线但附近有玩家时，女仆会随机自言自语
• 欢迎语：主人上线时女仆会向主人打招呼，不限距离，加载区块里的女仆都能触发
• 女仆互相对话：女仆会随机地与其附近的女仆聊天
• 无人设不说话：无人设的女仆不触发、不自动生成，避免自动生成人设带来的 token 消耗
• 历史有上限：自话记录超过配置的条数上限时，自动遗忘旧的、只保留最近一次，防止上下文膨胀
• 随机注入游戏情境：随机注入位置 / 附近实体 / 装备等情境信息，提高自话随机性
• 自定义 Prompt：可为自己的女仆自定义触发自言自语/互聊时的提示词，支持全部女仆设置与单只女仆独立设置
• Tool 调用：默认关闭，开启后，女仆可能在自言自语/互聊中自行切换状态、获取环境信息等。会带来额外的token消耗
• 玩家单独开关：每个玩家可单独开关女仆的自言自语与互聊；房主可控制总开关
• 触发冷却：可配置的随机触发间隔区间
• 睡觉时安静：允许让女仆睡觉时保持安静，不触发自言自语/互聊
• 聊天可见：自话与互聊对附近玩家可见

环境要求

加载器	Minecraft	Java	Touhou Little Maid
NeoForge	1.21.1	21	1.5.3
Forge	1.20.1	17	1.5.3

安装

1. 安装 mod：下载对应版本的 jar
2. 打开总开关：女仆 AI 设置 → AI 全局设置 →「女仆自言自语」→ 启用；「女仆互聊」需在其子页单独启用

使用

配置

女仆 AI 聊天设置 → AI 全局设置 →「女仆自言自语」：

• 状态 1 / 状态 2：主人在线 / 离线时的开关、最小与最大触发间隔（秒，填入式、带范围校验）、玩家半径、自话保留条数
• 欢迎语：主人上线后的打招呼触发窗口

女仆 AI 聊天设置 → AI 全局设置 →「女仆互聊」：

• 基础：总开关（默认关闭）、最小与最大触发间隔（秒）、玩家距离（格）、女仆间距离（格）
• 上下文与连续对话：保留轮数（问/答算一轮，超限后仅保留最近一条消息）、连续概率（每轮回答后按此概率继续）、最大链长（一次互聊的消息条数上限，连续概率拉满时的兜底）

玩家独立设置

对着女仆打开 AI 聊天输入界面（通常是按 T 键），点左侧 💬 按钮打开女仆设置：

• 自言自语 / 互聊：支持单独关闭自言自语/互聊
• 睡觉安静：开启后，女仆睡觉时不再触发自言自语/互聊
• 自定义 Prompt：支持为「全部女仆」和「这只女仆」分别填写提示词
• Tool调用：全局与单只开关，开启后这只女仆的自言自语/互聊可以调用工具

---

TLM Self-Talk (English)

A mod that adds self-talk / welcome greetings / maid-to-maid chats to Touhou Little Maid maids.

Features

• Maid self-talk: The maid randomly talks to herself when the owner is online, or when the owner is offline but other players are nearby
• Welcome greetings: The maid greets her owner when they log in — no distance limit; any maid in loaded chunks can trigger
• Maid-to-maid chat: A maid will randomly strike up a conversation with maids near her
• No persona, no talking: Maids without a persona never trigger and none is auto-generated, avoiding the token cost of auto-generating a persona
• Bounded history: When self-talk history exceeds the configured limit, old entries are forgotten and only the latest one is kept, preventing context bloat
• Random in-game context: Randomly injects context such as location / nearby entities / equipment to make self-talk more varied
• Custom Prompt: Customize the prompts used for self-talk / maid-to-maid chats for your own maids; supports both an all-maids setting and independent per-maid settings
• Tool calls: Off by default. When enabled, maids may switch states, fetch environment info, etc. on their own during self-talk / maid-to-maid chats. Incurs extra token cost
• Per-player switch: Each player can toggle self-talk and maid-to-maid chat for individual maids; the host controls the master switch
• Trigger cooldown: A configurable random interval range between triggers
• Quiet while sleeping: Allows maids to stay quiet while sleeping — self-talk and inter-chat won't trigger while they sleep
• Visible in chat: Self-talk and maid-to-maid chats are visible to nearby players

Requirements

Loader	Minecraft	Java	Touhou Little Maid
NeoForge	1.21.1	21	1.5.3
Forge	1.20.1	17	1.5.3

Installation

1. Install the mod: download the jar for your version
2. Enable the master switch: Maid AI settings → Global AI settings → "Maid Self-Talk" → Enable; Maid Inter-Chat needs to be enabled separately in its own sub-page

Usage

Configuration

Maid AI chat settings → Global AI settings → "Maid Self-Talk":

• State 1 / State 2: enable switch, min/max trigger interval (seconds, typed input with range validation), player radius, and self-talk keep count for owner online / offline
• Welcome: the greeting trigger window after the owner logs in

Maid AI chat settings → Global AI settings → "Maid Inter-Chat":

• Basics: master switch (off by default), min/max trigger interval (seconds), player range (blocks), and maid range (blocks)
• Context & chain: keep rounds (a Q/A counts as one round; only the latest message remains when exceeded), chain probability (chance to continue after each reply), max chain length (hard cap on messages per session, guarding against maxed-out chain probability)

Per-player settings

Open the maid's AI chat input screen (usually by pressing T) and click the 💬 button on the left to open the Maid Settings:

• Self-talk / Inter-chat: turn self-talk / inter-chat off individually
• Sleep Quiet: when on, self-talk / inter-chat no longer trigger while the maid is sleeping
• Custom Prompt: fill in separate prompts for all maids and for this maid
• Tool: global and per-maid switches; when enabled, this maid's self-talk / inter-chat can call tools