生机谷

生机谷

生生谷 — 这个模组真正让星露谷的NPC活了起来。NPC会主动与你聊天并赠送礼物；你还可以与它们进行贴合角色个性的AI对话。每次聊天都会增进友谊，并解锁专属礼物。告别固定对话和冷冰冰的互动——不再有僵硬的角色。

生机谷预览查看大图

VIVANT VALLEY

让每一次相遇，都成为会被记住的故事。

Let every encounter become a story worth remembering.

SHORT DESCRIPTION / 简短描述

中文

让星露谷的每一次相遇，都成为会被记住的故事。NPC 会以原有性格与你交谈、主动搭话，也能在同意后陪你旅行、钓鱼或下矿作战。纯 C# 模组，无 Python 后端与本地监听。

English

Turn every encounter into a story that can continue. Villagers remember, approach you, and may join you for travel, fishing, or mine combat. No bundled Python backend or local listener.

FULL DESCRIPTION / MOD 描述

中文

雨落在鹈鹕镇的屋檐上。你在酒吧门口遇见一位村民，他没有重复昨天说过的话，而是提起几天前你在湖边留下的那句承诺。

你问他要不要一起走走。他可能点头，也可能看看天气，用符合自己性格的理由拒绝。

若他答应，故事不会停在对话框里：他会跟着你穿过小镇、进入房屋与矿洞，在黑暗中拔剑迎向怪物；也会在安静的水边陪你抛竿，把真正钓到的鱼交到你手中。等你们再次见面，这段共同经历仍可能成为下一场谈话的一部分。

这就是 Vivant Valley 想带来的星露谷。

它不是把一个通用聊天机器人套在每位 NPC 身上，而是在尊重原版角色塑造的基础上，让对话连接起日期、天气、地点、关系、任务、近期活动、原版剧情事实和眼前正在发生的事。

村民保留自己的语气、偏好、棱角与生活轨迹。他们可以关心你，也可以不同意你；可以记住一段温暖的交谈，也可以在合适的时候主动来找你。

当对话涉及行动时，AI 只负责提出意图。礼物、同行、钓鱼和战斗都必须经过模组内 C# 规则校验、玩家确认并在游戏线程中真实执行。它们不是写在台词里的幻想，而是会发生在游戏中的真实行为。

Vivant Valley 不试图替代《星露谷物语》原本的文字与人物。它更像是在那些熟悉的日程、事件和关系之间，留出一片可以继续生长的空间，让昨天说过的话，有机会在明天得到回应。

◆ ◆ ◆

English

Rain settles over the rooftops of Pelican Town. Outside the saloon, a villager stops to speak with you. Instead of repeating yesterday's line, they bring up a promise you made by the lake several days ago.

You ask if they would like to go somewhere together. They might accept, or glance at the weather and refuse for reasons that feel entirely their own.

If they do come, the story does not end inside a dialogue box. They can follow you across town, through buildings, and into the mines, drawing a sword when monsters close in. They can stand beside you at the water, cast a line, and hand you a fish they actually caught. When you meet again, what happened between you may still be part of the conversation.

That is the valley Vivant Valley sets out to create.

This is not a generic chatbot pasted onto every villager. It builds on Stardew Valley's original characterization, grounding each conversation in the date, weather, location, relationship, quests, recent activity, established story facts, and the scene unfolding nearby.

Villagers keep their own voices, preferences, rough edges, and routines. They can care, disagree, remember, refuse, and sometimes decide to seek you out on their own.

The AI interprets the conversation and proposes an action, but it never has unchecked control of the game. Gifts, shared travel, fishing, and combat must pass the mod's C# validation, receive player confirmation where required, and execute as real actions on the game thread.

Vivant Valley is not meant to replace Stardew Valley's writing or characters. It creates room between familiar schedules, events, and relationships for something new: a conversation that does not have to disappear when the window closes.

MAIN FEATURES / 核心功能

中文

  • 角色化 AI 对话 NPC 会参考原版性格、语气、价值观和经历作出回应，而不是共享同一套通用聊天模板。
  • 理解当前游戏情境 日期、季节、天气、地点、关系、任务、玩家进度、近期活动、原版剧情事实和附近正在发生的事情，都可以影响谈话。
  • 会延续的共同记忆 近期对话、共同活动和压缩后的长期摘要让故事保持连贯。实时存档事实与原版人物设定始终优先，不会被旧记忆覆盖。
  • NPC 拥有自己的选择 邀请和请求不是必然成功。NPC 会根据个性、关系与当前情境决定接受或拒绝，并给出符合角色的回应。
  • 主动相遇与惊喜 NPC 可能依照原版日程自然地走近并与你交谈，也可能当面送礼，或在第二天寄来一封带附件的信。
  • 真实且受控的礼物 AI 只能从代码筛选后的合法候选池中选择礼物，不能生成任意物品 ID，也不能绕过红心要求、冷却时间和游戏规则。
  • 共同旅行 NPC 接受邀请后会跟随玩家穿越地图、房屋和矿洞。活动结束后，他们会恢复原版日程；没有可用日程时则会回家。
  • 矿洞护卫 同行 NPC 会使用银河剑主动攻击附近怪物，默认拥有 700 点生命值。每次新的下矿护卫行程首次进入矿区时，NPC 会恢复满血。若被击败，他们会住院一天，这次经历也会被记住。
  • 钓鱼伙伴 当玩家到达钓点并抛竿后，NPC 会使用铱金鱼竿完成抛竿、等待、收杆与捕获，钓到的真实鱼获会交给玩家。
  • 可调节的对话界面 普通聊天输入框与回复框的默认显示比例为 75%。普通对话和主动对话的窗口大小可以分别设置。
  • 不直接改写好感度 普通 AI 对话不会直接增加原版好感度。谈话会影响 Vivant Valley 的社交记忆，并可能促成后续相遇、礼物或来信。

English

  • Character-first dialogue Villagers respond through their established personalities, voices, values, and histories rather than a shared generic chat template.
  • Awareness of the present moment Date, season, weather, location, relationship, quests, progression, recent activity, vanilla story facts, and nearby events can all shape a conversation.
  • Memories with continuity Recent dialogue, shared activities, and bounded long-term summaries allow relationships to carry forward. Live save facts and original characterization always take priority over old memories.
  • Villagers retain agency Invitations and requests are never automatic. NPCs can accept or refuse according to personality, relationship, and context, then answer in character.
  • Proactive encounters and surprises Villagers may approach you naturally along their vanilla schedules, offer an in-person gift, or send a letter with an attachment the following day.
  • Real, controlled gifts The AI can choose only from candidates filtered by the mod. It cannot invent item IDs or bypass heart requirements, cooldowns, and game rules.
  • Shared travel After accepting an invitation, an NPC can follow the player through maps, buildings, and mine transitions. They resume their vanilla schedule afterward, or return home when no usable schedule is available.
  • Mine guard combat A companion uses a Galaxy Sword to seek out and fight nearby monsters. NPCs have 700 health by default and return to full health when first entering the mine during each new guard trip. Defeat sends them to the hospital for a day and becomes part of the remembered experience.
  • Fishing companions Once the player reaches a fishing spot and casts, the NPC uses an Iridium Rod to cast, wait, reel, and catch. Actual fish are delivered to the player.
  • Adjustable dialogue UI The standard input and response windows use a 75% default scale. Standard and proactive conversation windows can be resized separately.
  • No automatic friendship farming Ordinary AI conversation does not directly add vanilla friendship points. It affects Vivant Valley's social memory and may lead to later encounters, gifts, or mail.

INSTALLATION / 安装说明

中文

  1. 安装《星露谷物语》1.6 或更高版本。
  2. 安装 SMAPI 4.0 或更高版本。
  3. 下载 VivantValley-Release.zip。
  4. 将压缩包内的 VivantValley 文件夹解压到游戏的 Mods 目录。
  5. 确认最终路径为 Mods/VivantValley/manifest.json，不要额外嵌套一层同名文件夹。
  6. 通过 SMAPI 启动游戏。载入存档后打开 Vivant Valley 设置，选择 DeepSeek、OpenAI 或兼容服务，填写 API Key、Base URL 与模型名称，然后测试连接。

同一个发布包适用于 SMAPI 支持的 Windows、macOS 和 Linux。

English

  1. Install Stardew Valley 1.6 or later.
  2. Install SMAPI 4.0 or later.
  3. Download VivantValley-Release.zip.
  4. Extract the included VivantValley folder into the game's Mods directory.
  5. Confirm that the final path is Mods/VivantValley/manifest.json, with no extra nested folder.
  6. Launch the game through SMAPI. After loading a save, open the Vivant Valley settings, choose DeepSeek, OpenAI, or a compatible service, enter the API key, Base URL, and model name, then test the connection.

The same release package works on SMAPI-supported Windows, macOS, and Linux systems.

从 Stardew AI Memories 升级 / Upgrading

Vivant Valley 保留原项目的 SMAPI UniqueID：firstmod.StardewAIMemories，因此已有对话记忆、社交计划与邮件状态可以继续兼容。

升级前请关闭游戏并备份旧的 config.json。移除旧的 Mods/StardewAIMemories 文件夹，安装新的 Mods/VivantValley，再将旧配置复制到新目录。请勿同时保留两个安装文件夹。

Vivant Valley keeps the original SMAPI UniqueID, firstmod.StardewAIMemories, so existing conversation memories, social plans, and mail state remain compatible.

Before upgrading, close the game and back up the old config.json. Remove Mods/StardewAIMemories, install the new Mods/VivantValley folder, and copy the old configuration into it. Do not keep both folders installed at the same time.

REQUIREMENTS / 使用要求

中文

  • Stardew Valley 1.6+
  • SMAPI 4.0+
  • DeepSeek、OpenAI 或兼容 AI 服务的 API Key
  • 能够访问所选 AI 服务的网络环境

**默认操作：**靠近并面向 NPC，按 Space 开始对话。

Vivant Valley 不内置 AI 模型，也不提供免费 API 服务。调用费用由所选服务商收取，请在使用前查看对应的模型价格与隐私政策。

English

  • Stardew Valley 1.6+
  • SMAPI 4.0+
  • An API key for DeepSeek, OpenAI, or a compatible AI service
  • Internet access to the selected provider

Default control: Stand near and face an NPC, then press Space to begin a conversation.

Vivant Valley does not bundle an AI model or provide free API access. Usage fees are charged by the selected provider; review its model pricing and privacy policy before use.

PRIVACY AND ARCHITECTURE / 隐私与架构

中文

Vivant Valley 0.14.2 是纯进程内 C# SMAPI 模组。发布包只包含模组 DLL 与数据文件：

  • 不包含 Python 运行时；
  • 不包含独立后端 EXE 或子进程；
  • 不启动本地 HTTP 服务，也不监听本机端口；
  • 模组 DLL 直接连接玩家自行配置的 AI Base URL；
  • 远程 Base URL 必须使用 HTTPS，只有玩家主动配置的本机回环地址可以使用 HTTP。

发送给 AI 提供商的内容可能包括玩家输入、近期对话、长期摘要、有限的近期活动摘要，以及当前日期、地点、天气、关系、任务和已经发生的剧情事实。这些内容不会经过 Vivant Valley 自有服务器。

通过游戏设置保存的 API Key 会以明文写入模组目录下的 config.json。它不会进入存档、日志或发布包，但请不要分享该文件。也可以使用 DEEPSEEK_API_KEY 或 OPENAI_API_KEY 环境变量提供密钥。

English

Vivant Valley 0.14.2 is a fully in-process C# SMAPI mod. The release contains only the mod DLL and data files:

  • No Python runtime;
  • No standalone backend executable or child process;
  • No local HTTP service and no listening port;
  • The mod DLL connects directly to the AI Base URL configured by the player;
  • Remote Base URLs must use HTTPS. HTTP is allowed only for a loopback address explicitly configured by the user.

Content sent to the selected AI provider may include player input, recent dialogue, long-term summaries, limited recent-activity summaries, and current date, location, weather, relationship, quests, and completed story facts. This data does not pass through a Vivant Valley-owned server.

An API key saved through the in-game settings is written in plain text to config.json inside the mod folder. It is not stored in saves, logs, or release packages, but the configuration file should never be shared. Keys may also be supplied through the DEEPSEEK_API_KEY or OPENAI_API_KEY environment variable.

MULTIPLAYER NOTES / 联机说明

中文

普通 AI 对话支持本地分屏和远程农场助手，并按屏幕隔离请求状态。长期记忆、每日社交规划、主动相遇、礼物和隔夜邮件目前只由主玩家运行；农场助手的普通对话记忆仅保留到本次连接结束。

English

Standard AI dialogue supports local split-screen and remote farmhands with separate request state per screen. Long-term persistence, daily social planning, proactive encounters, gifts, and overnight mail currently run only for the main player. Farmhand conversation memory lasts only for the current connection.

SHOUT OUTS / 致谢

中文

特别感谢：

  • ConcernedApe，创造了《星露谷物语》这个温暖、细腻而值得反复归来的世界。
  • SMAPI 开发团队，为模组开发提供稳定而强大的基础。
  • DeepSeek 与 OpenAI，为角色化 AI 对话提供模型服务支持。
  • 每一位参与测试、提交问题、分享故事和帮助 Vivant Valley 改进的玩家。
*愿你下一次走进鹈鹕镇时，遇见的不只是一句新的台词，而是一段只有你们记得的往事。*

English

Special thanks to:

  • ConcernedApe, for creating a world as warm, thoughtful, and endlessly worth returning to as Stardew Valley.
  • The SMAPI development team, for the stable and powerful foundation that makes modding possible.
  • DeepSeek and OpenAI, for the model services that support character-driven AI dialogue.
  • Every player who tested the mod, reported a problem, shared a story, or helped Vivant Valley improve.
*May your next walk through Pelican Town lead to more than a new line of dialogue. May it bring back a memory that belongs only to the two of you.*