神之手 - 自定义NPC套件

神之手 - 自定义NPC套件

一个用于从零开始创建自定义角色的星露谷物语模组制作辅助工具。

[center][size=6][b]Godly Hand — NPC 创作套件[/b][/size]
[size=3][i]一站式工具,用于在 Content Patcher 中制作自定义星露谷物语村民[/i][/size][/center]

[line]

[size=4][b]这是什么?[/b][/size]
制作自定义 NPC 通常意味着要同时应付十几个 JSON 文件,翻阅 wiki 页面查找事件语法,然后在游戏里发现仅仅少了一个斜杠就让整个场景崩溃。[b]Godly Hand[/b] 把整个流程集中到一处。

它是一个在浏览器中运行的单 HTML 文件。无需安装任何东西,你的文件始终留在你的电脑上。构建你村民的身份、礼物喜好、对话、过场动画、日程和动画,然后导出一个完整的 Content Patcher 文件夹,可以直接放入 [b]Mods[/b]。

我制作它是因为在我构建自己的自定义 NPC 模组时,现有的 NPC 工作流让我很沮丧。这里的每个工具都是为了实际使用而制作,并在游戏内测试过。

[line]

[size=4][b]工具[/b][/size]

[b]⚙ NPC 设置[/b]
[list]
[]名字、显示名、年龄、举止、社交焦虑、乐观度、性别、家乡地区和生日[/]
[]恋爱和结婚开关、日程开关和生成设置[/]
[]礼物喜好,配有可搜索的物品选择器、分类快捷方式和直接输入物品 ID[/]
[]喜爱、喜欢、不喜欢、讨厌和中性礼物的反应对话[/]
[]对话标记参考(@、%spouse、%pet、%farm 等)[/]
[]生成你的 [b]content.json[/b],或导入现有文件以继续编辑[/]
[]新项目生成器,为你构建文件夹结构和 manifest[/]
[/list]
[b]🎬 场景构建器[/b]
[list]
[]通过引导表单逐条命令构建事件:move、warp、speak、emote、animate、viewport、fade、sound、临时角色等[/]
[]每一行场景都可以重新打开其表单,因此你之后编辑时无需手动修改原始语法[/]
[]用于玩家决策的分支和选择块构建器[/]
[]触发条件:好感等级、时间窗口、天数、约会或配偶要求[/]
[]地图选择器,附带原版地点描述(不再混淆 HarveyHouse 和 Hospital)[/]
[]音乐选择器,涵盖原声带、节日主题曲和角色主题曲,以及音效提示[/]
[]坐标查找器:加载 TMX 地图,点击图块并保存带标签的坐标以便复用[/]
[][b]语法检查器[/b],在你启动游戏之前捕获缺少的 [i]end[/i] 命令、重复的 fork 键、错误的 viewport、损坏的问题文本等[/]
[]可选的 ValleyTalk 支持[/]
[]事件可以堆叠到一个文件,或合并到现有的事件 JSON 中[/]
[/list]
[b]🏃 动画构建器和精灵制作器[/b]
[list]
[]加载你的精灵表,点击帧来构建命名的动画序列并实时预览[/]
[]生成 [b]Animations.json[/b],带有语法检查和上次输出的备份[/]
[][b]精灵制作器[/b]:像素编辑器,支持图层、套索、填充、取色器、保存颜色、肤色调色板和撤销/重做[/]
[]成人和儿童模板,标准和超大尺寸[/]
[]精灵表和肖像格式参考,附帧布局图示[/]
[/list]
[b]🗓 日程构建器[/b]
[list]
[]按地点、时间、图块和朝向构建每日日程[/]
[]婚姻和星期日程[/]
[]与你的动画关联,使名称完全匹配[/]
[]导入现有的 Schedule.json 进行编辑[/]
[/list]
[b]🐞 调试命令[/b]
[list]
[]读取你的 manifest 和事件,然后构建可搜索的场景注册表,附带可直接复制的 [i]debug ebi[/i] 命令[/]
[]为你的模组生成准确的 [i]patch reload[/i] 命令[/]
[]季节、星期、补丁摘要和其他实用控制台命令的快速参考[/]
[/list]
[b]🗺 地图制作器[/b] — [i]即将推出[/i]
在完全测试之前处于锁定状态。引擎组件可单独获取。

[line]

[size=4][b]工作原理[/b][/size]
[list=1]
[][b]加载:[/b]将 [i]Load Project Folder[/i] 指向你的模组。你的精灵表、肖像和 NPC 名字在所有标签页之间共享。[/]
[][b]构建:[/b]设置 NPC,然后编写场景、日程和动画。[/]
[][b]保存:[/b][i]Save Session[/i] 会写入一个带时间戳的文件,包含所有内容,包括空白字段。套件每 7 分钟提醒你一次。[/]
[][b]导出:[/b][i]Export Mod[/i] 将你的 Content Patcher 文件夹打包为 ZIP,可直接用于 Mods。[/]
[/list]
[color=#e06666][b]⚠ 重要:[/b]没有任何内容会自动保存。关闭窗口会丢弃所有未保存到文件的内容。请经常使用 Save Session,或接受备份提醒。[/color]

你也可以从会话文件、完整的模组 ZIP 备份,或直接从现有的模组文件夹继续之前的工作。

[line]

[size=4][b]要求[/b][/size]
[b]使用该工具:[/b]
[list]
[]现代网络浏览器(Chrome、Edge、Firefox)[/]
[/list][b]对于它制作的模组:[/b]
[list]
[][url=https://www.nexusmods.com/stardewvalley/mods/2400]SMAPI[/url][/]
[][url=https://www.nexusmods.com/stardewvalley/mods/1915]Content Patcher[/url][/]
[]ValleyTalk(仅当你选择使用其对话功能时)[/]
[/list]
[line]

[size=4][b]安装[/b][/size]
下载 HTML 文件并在浏览器中打开。就这样。[b]不要[/b]把它放进你的 Mods 文件夹。它是用来制作模组的工具,本身不是模组。

[line]

[size=4][b]已知问题[/b][/size]
[list]
[]通过条件补丁加载的季节性精灵表目前还不能正确覆盖。请暂时使用单一精灵表。[/]
[]图块坐标必须在游戏内检查。使用调试模式或图块信息模组来确认位置。[/]
[]一些模组以非标准方式存储事件。如果调试命令找不到你的事件,你可以手动添加事件 ID。[/]
[/list]工具内的 [b]Bug Sheet[/b](位于 Guide → Reference 下)列出了常见陷阱和修复方法。

[line]

[size=4][b]计划功能[/b][/size]
[list]
[]地图制作器[/]
[]季节性精灵表支持[/]
[]Portraiture 集成[/]
[]自定义物体和物品[/]
[/list]
[line]

[size=4][b]致谢[/b][/size]
[list]
[][b]Aerishiph:[/b]作者、引擎设计和游戏内测试[/]
[][b]Claude(Anthropic):[/b]开发协助[/]
[][b]Miss Coriel's NPC Creator:[/b]本工具遵循的标准精灵表格式[/]
[][b]Lewis G:[/b]音乐预览[/]
[/list]
[center][i]欢迎在 Posts 和 Bugs 标签页中提交错误报告和建议。
如果你用 Godly Hand 制作了一个村民,我很想看看![/i][/center]