真之符文 - 模组制作工具包

停止猜测。开始了解。

你曾盯着肖像索引，想知道哪个数字对应$13。你曾五次重启游戏，只为验证一个邮件标记是否正确设置。你曾滚动浏览一堵SMAPI日志输出的墙，寻找一条特定的日程条目。

真正的符文：模组工具包是你一直希望SMAPI能自带的调试控制台。

十一个精确定位的指令，全部集中在rune_命名空间下。一键安装即可，无需配置。打开SMAPI控制台，输入指令，获取答案——然后继续构建您的模组。

它所解决的问题

• “快乐表情对应的是哪个肖像索引？” 在游戏内置对话框内输入rune_portrait Haley all，就能以每秒一帧的速度循环显示——同时标注数字索引和$代码。无需再翻电子表格，也不用反复试错了。
• “那段过场动画后，我的邮件标记真的设置好了吗？” rune_mailbox一次性转储你所有的mailReceived、mailForTomorrow和mailbox状态。通过前缀过滤以减少干扰：输入rune_mailbox MyMod_。
• “为什么这个事件没有触发？” rune_listallevents会搜索所有已加载的Data/Events/*位置。通过ID、位置名称或前置条件中的关键词来查找。然后使用rune_triggerevent强制立即触发该事件，跳过所有条件。
• “海莉应该在1400点到哪里？” rune_schedule 海莉打印当前活跃的时刻表键及每条带有时间戳的记录。比追踪SMAPI日志更快更清晰。 看起来你提供的文本内容不完整。请提供完整的、需要翻译的文本内容，我会按照要求逐行翻译成中文，并保留所有格式、标记和特殊内容。
• “这能与我的SVE/东崖谷/岭边村的NPC一起使用吗？” 是的。rune_npc_list使用Utility.ForEachVillager — 每个已加载的NPC，无论原版还是自定义，都会显示内部名称、显示名称和当前位置。

所有命令一览

头像

• rune_portrait <NPC> (code|number|all) — 在游戏中预览任意单个肖像帧，或顺序循环每一帧
• rune_portrait_dump <NPC> — 将完整角色肖像页导出为PNG至Mods/TrueRune.ModderToolkit/portraits/路径

NPC与日程安排

• rune_npc_list — 已加载的每个NPC：内部名称、显示名称、当前位置。适用于所有自定义NPC框架。
• rune_schedule <NPC> — 该NPC今天的活动日程键以及所有带时间戳的条目

邮件标志

• rune_mailbox [prefix] — 完整邮件状态：mailReceived + mailForTomorrow + mailbox，可筛选
• rune_listflags [prefix] — 玩家当前设置的所有标志；按前缀过滤
• rune_listallflags [前缀] — Data/mail中的每个字母ID — 最接近完整标志注册表的内容

对话回答

• rune_listanswers [prefix] — 当前记录中所有$q的答案

事件

• rune_listevents [prefix] — eventsSeen中的每个事件ID
• rune_listallevents [filter] — 按位置、ID或前置条件文本搜索Data/Events/*
• rune_triggerevent <id> — 按ID强制触发任意事件。 将你传送到该事件的位置并立即开始，忽略所有前置条件

设置单个状态（一个邮件标记、一个$q回答，或标记一个事件已见过）已被Stardew的内置debug命令覆盖，因此工具包特意不重复这些功能：请使用debug seenMail <id>、debug question <id>和debug seenEvent <id>（追加false以清除）。工具包专注于原版未提供的检查和搜索命令。

与家庭其他成员一起成长

该工具包是每一个真符咒控制台命令的唯一来源。与它一起安装任意一个真符咒框架模组后，额外的命令组会自动激活——无需额外设置，且框架本身不会注册任何自己的控制台命令。

• 真实符文：事件 → rune_event_run|unsee|eligible|list|reload — 触发、检查资格、按内容包列出、热重载事件JSON
• 真实符文：时间表 → rune_sched_list|try|apply|points|festivals|smoke|reload — 检查备选内容，试运行决议，重新应用，并热加载时间表 JSON
• 真实符文：对话 → rune_dlg_list|try|clearusage|reload — 列出规则、试运行下一行、重置使用计数器、热重载替换JSON

每个组仅在游戏启动时检测到其框架时才会出现。缺少框架 = 这些命令根本不会显示。没有错误提示，没有多余输出。

安装零摩擦

1. 安装 SMAPI 4.0.0 或更高版本
2. 解压到 Stardew Valley/Mods/
3. 启动游戏 — 这些命令会立即生效

无需配置。所有命令在游戏加载存档时即可生效。可选择安装 通用模组配置菜单，以便在暂停菜单中切换详细日志记录。在SMAPI控制台中输入 help <command> 可查看任意命令的内联用法。

专为模组作者的实际工作方式而设计

• 无需重启。 设置一个标记，清除它，检查结果——全程无需离开会话。迭代只需几秒，而非几分钟。
• 无注册耦合。 直接针对原版的mailReceived / dialogueQuestionsAnswered / eventsSeen生效。无需额外设置。除SMAPI外无其他依赖。
• 与内容包协同工作。 修补你的CP模组，使用patch reload重新加载，通过符文命令验证状态——循环过程紧凑高效。
• AI助手就绪。 将本页面粘贴到Claude、ChatGPT或Cursor中，并请其生成特定测试场景的标志/答案设置。命令界面特意设计为机器可读格式。
• 自定义NPC友好。 SVE、东崖、岭边村以及任何其他框架——只要SMAPI加载了，符文命令就能看到。

兼容性

• SMAPI 4.0.0+ / 星露谷物语 1.6+
• 兼容所有自定义NPC框架（SVE、East Scarp、Ridgeside等）
• 单人模式。多人模式未测试。 看起来您提供的输入似乎不完整，只包含了一个列表项的结束标记[/list]，而没有具体的文本内容需要翻译。请提供完整的游戏文本内容，以便我按照您的要求进行逐行翻译。例如，您需要包含文本的列表或其他格式内容。

真符文家族的一部分

这是真符文模组框架的 第1个 模组。它本身设计为独立可用——当系列其他模组发布后，其功能将更加强大。

• 真·符文：对话 （即将推出） — 基于优先级堆叠的运行时对话替换、对话窗口、轮换池以及每行最高使用次数限制。无需修改资源文件即可创作丰富的NPC对话。
• 真神符石：事件 （即将推出） — 基于JSON格式的事件编写。使用编辑器工具以结构化格式编写事件脚本，然后让框架编译并注入它们。

工具箱是您验证对话和事件是否完全按预期运行的地方。

支持项目

该模组为免费且采用MIT许可协议。如果它能为您节省一小时的日志追踪时间或避免十几次游戏重启，请考虑请我喝杯咖啡：

ko-fi.com/riouvalley

许可协议

MIT 协议——免费分叉、复用和再分发。署名可自愿提供，但非必需。