[LLM AI NPC]Lively Settler

Lively Settler

让每位 NPC 拥有记忆、性格和灵魂。 基于大语言模型的 NPC 增强模组 *Give every NPC memory, personality, and soul.* NPC enhancement mod powered by Large Language Models.

Lively Settler 正在积极开发中，欢迎各位提出意见或反馈问题。 *Lively Settler is under active development. Feedback and suggestions are welcome.*

[hr][/hr]

✨ 主要特性 / ✨ Key Features

🗣️ 自由对话 / Chat

• 右键打开商店 → 点击“对话”，像真人一样聊天。NPC 会基于性格、记忆和好感度做出回应。
• *Right-click any NPC → Click "Chat", and talk to them like a real person. NPCs respond based on personality, memory, and relationship.*

📋 NPC 信息面板 / NPC Info Panel

• 点击右侧工具栏按钮，查看 NPC 的完整档案：性格、背景、好感度、记忆与对话历史。
• *Click the button on the right toolbar to view full NPC profiles: personality, backstory, relationship, and memory history.*

👥 自动闲聊 / Auto Banter

• 附近 NPC 会基于时间、天气、区域和各自特质自动闲聊，可能会谈论关于你的事。
• *Nearby NPCs chat automatically based on time, weather, biome, and traits. They might talk about you.*

🧠 长期记忆 / Long-term Memory

• NPC 会记住对话、交易和任务，重要事件几乎不会遗忘，后续聊天中可能主动提起。
• *NPCs remember conversations, trades, and quests. Important events are rarely forgotten and may be brought up later.*

💰 交易与好感度 / Trading & Relationship

• 对话中自然完成交易，好感度实时变化，影响语气和任务成功率。
• *Complete trades naturally in dialogue. Relationship changes in real-time, affecting tone and quest success.*

📋 基础任务系统 / Basic Quest System

• 通过对话触发和完成任务（如招募 NPC），任务完成后 NPC 可执行后续动作。
• *Trigger and complete quests through dialogue (e.g., recruit NPCs). NPCs can perform follow-up actions upon completion.*

⚙️ 高度可配置 / Highly Configurable

• 游戏内配置界面，支持模型切换、闲聊开关、语言切换、玩家档案编辑等。
• *In-game config UI supports model switching, chat toggle, language selection, and player profile editing.*

[hr][/hr]

🚀 如何使用 / How to Use

1. 准备 LLM 后端（必须） / Prepare an LLM Backend (Required)

• 云端 API（DeepSeek、通义千问、GPT 等）或本地 Ollama 均可。
• *Cloud API (DeepSeek, Qwen, GPT, etc.) or local Ollama both work.*

2. 安装模组 / Install the Mod

• Steam 创意工坊订阅，首次启动自动生成配置文件。
• *Subscribe on Steam Workshop. Config files auto-generate on first launch.*

3. 配置 LLM / Configure the LLM

• ESC → “Lively Settler 配置”，选择模型，填写 API Key，点击测试连接验证。
• *ESC → "Lively Settler Config", select model, enter API Key, and click Test Connection to verify.*

4. 享受游戏 / Enjoy the Game

• 与 NPC 对话，探索他们的故事。
• *Talk to NPCs and explore their stories.*

[hr][/hr]

⚙️ 系统要求 / System Requirements

• 本地 LLM：16GB 内存 + 8GB 显存（推荐）
• *Local LLM: 16GB RAM + 8GB VRAM (recommended)*
• 云端 API：仅需网络连接
• *Cloud API: Internet connection only*
• 模组大小约 60 MB（包含所有依赖项），记忆文件随游戏时长增长
• *Mod size ~60 MB (including all dependencies), memory files grow with playtime*

[hr][/hr]

📝 许可证 / License

• LivelyCore & LivelyNPC：MPL 2.0
• LivelySettler（游戏适配层）：MIT
• *LivelyCore & LivelyNPC: MPL 2.0 / LivelySettler (game integration): MIT*

[hr][/hr]

⚠️ 重要提示 / Important Notes

• 首次与 NPC 交谈时，模组会调用 LLM 生成该 NPC 的档案，等待时间可能略长。之后档案会被保存，无需重新生成。
• *First chat with an NPC triggers LLM profile generation, which may take a moment. Profiles are saved afterward.*
• 本模组仅通过 Steam 创意工坊 和 Gitee 发布。其他来源的文件安全无法保证，请谨慎下载。
• *This mod is officially released ONLY via Steam Workshop and Gitee. Please download from official channels only.*

[hr][/hr] Enjoy your lively world!