Описание
# 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