
NPC情书
随着你与村民的友谊不断加深,他们会通过你的邮箱寄给你图画信件。每封信都将简短的手写留言与一幅素描或照片结合在一起,并在原版信件查看器中呈现。
查看大图描述
Love Letters 是一个星露谷物语模组,随着你与村民友谊的增长,村民会向你的邮箱寄送带有图片的手写信件。原版邮件只有文字——此模组为信件添加图片,并在原版信件查看器内渲染,让每封信都像是 NPC 亲手绘制的真实便条。
安装说明
- 安装 SMAPI 4.3.0 或更高版本(参见 SMAPI wiki 获取说明)。
- 将 Love Letters 文件夹复制到游戏的 Mods/ 目录中。该文件夹包含:模组 DLL、manifest.json、config.json、ConfigSchema.json、letters.json 以及 pictures/ 文件夹。
- (可选)安装 Generic Mod Config Menu,以便使用游戏内设置界面,而不必手动编辑 config.json。
- 启动游戏。SMAPI 会自动加载模组——无需额外步骤。
要添加你自己的信件,请编辑 letters.json 并将 PNG 图片放入 pictures/ 文件夹。无需重新编译;图片在运行时加载。
配置
模组文件夹中的两个文件控制行为。两者都可以手动编辑,或通过 Generic Mod Config Menu 在游戏内编辑。
--- config.json ---
{ "Enabled": true, "MaxMailboxLetters": 4, "ImageMaxPixels": 512, "ImageMaxHeight": 440 }
字段 — 作用 — 默认值 — 有效范围 • Enabled — 主开关;false 会完全禁用所有信件投递。 — true — true / false • MaxMailboxLetters — 邮箱中同时允许的最大未读情书数量;多出的信件会等到较早的信件被阅读后再投递。 — 4 — 1 到 20 • ImageMaxPixels — 最长边超过此值的图片会在加载时缩小,以降低内存占用。 — 512 — 64 到 4096 • ImageMaxHeight — 图片在信件内可占用的最大高度(以基础分辨率像素为单位);文字在其下方分页。 — 440 — 96 到 560
提示:如果你的图片较小(低于 512 px),可以将 ImageMaxPixels 保留为默认值。如果你希望有更大的文字区域,请降低 ImageMaxHeight。
--- letters.json ---
JSON 数组中的每个条目定义一封信。添加新条目即可创建更多信件——无需更改代码或重新编译。
示例 — 为 Abigail 在 6 颗心时创建的新信件: { "Id": "LoveLetters_abigail_6", "Npc": "Abigail", "MinHearts": 6, "Text": "@, I finally finished the portrait you asked for. ^It took me all week, but I think you'll like it.", "Image": "pictures/abigail/hearts6.png", "Title": "Your Portrait" }
字段 — 作用 • Id — 唯一邮件 ID。请始终以 "LoveLetters_" 为前缀,以避免与其他模组冲突。每封信使用一个不同的 ID(例如 LoveLetters_abigail_2、_4、_6)。 • Npc — NPC 的内部名称(例如 "Abigail"、"Leah"、"Penny"、"Sebastian")。模组会根据此名称检查你的友谊心级。 • MinHearts — 投递该信件所需的友谊心级。范围为 0–8(8 = 4000 友谊点)。 • Text — 信件正文。支持原版邮件格式:@ = 玩家名字,^ = 换行,[letterbg #] = 选择羊皮纸背景(0–3)。 • Image — 图片路径,相对于模组文件夹(例如 "pictures/abigail/hearts6.png")。留空为 null 或省略则为纯文字信件。PNG 效果最佳;BMP/DDS/JPEG 在大多数情况下也能加载。 • Title — 在收集品 → 信件中悬停时显示。省略时回退为 "Letter from {Npc}"。
示例 — 纯文字信件(无图片): { "Id": "LoveLetters_leah_8", "Npc": "Leah", "MinHearts": 8, "Text": "@, I've been meaning to tell you something for a while now. ^Let's grab lunch tomorrow? I could use some company.", "Title": "A Little Confession" }
图片文件夹结构 — 将你的 PNG 放在这里,按 NPC 分组: pictures/ ├── abigail/ │ ├── hearts2.png │ ├── hearts4.png │ └── hearts8.png ├── leah/ │ ├── hearts2.png │ └── hearts4.png ├── penny/ │ ├── hearts2.png │ └── hearts6.png └── sebastian/ └── hearts4.png
随附的模组包含 8 封信(Abigail x3、Leah x2、Penny x2、Sebastian x1)。缺失的图片文件永远不会导致模组崩溃——它会记录一条警告并回退为纯文字信件。
主要功能
- 图片信件:每封信在原版信件菜单中显示一条文字消息和一张图片。图片会缩放以适应空间,文字在其下方分页。
- 心级阈值投递:当与某个 NPC 的友谊达到配置的心级时,信件会投递到邮箱。每封信只发送一次(通过持久化的 mailReceived 标志跟踪)。
- 收集品标签页支持:在收集品 → 信件中重新阅读时,信件也会渲染其图片,因此无需打开邮箱即可回顾。
- 数据驱动:所有信件都在 letters.json 中定义(NPC 名称、心级阈值、文本、图片路径、可选收集品标题)。无需接触任何代码即可添加、编辑或删除信件。
- 灵活的图像处理:图片在运行时从模组文件夹加载、缓存并缩小以降低内存占用。如果图片文件缺失,模组会回退为纯文字信件而不会崩溃。
- 邮箱上限:可配置的限制(默认 4)可防止邮箱溢出。超出上限的信件会等到较早的信件被阅读后再投递。
- 多人游戏与分屏:每位玩家根据自己的友谊获得信件,收集品标签页的切换每个 tick 按玩家执行。
- 设置(config.json 或通过 Generic Mod Config Menu):主启用开关、邮箱最大信件数、最大图片尺寸(像素)以及信件内最大图片高度。
需求
- Stardew Valley 1.6
- SMAPI 4.3.0 或更高版本
- (可选)Generic Mod Config Menu 用于游戏内设置
- 无需其他模组。
鸣谢
感谢 Pathoschild 创建并维护 SMAPI 和 SMAPI Toolkit,使这样的模组成为可能。也感谢 ConcernedApe 制作了一款不断给我带来惊喜的游戏。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。