NPC助手2

NPC助手2

使用纯文本(TOML)文件为星露谷物语1.6添加自定义NPC,无需编程。支持对话、日程、礼物喜好、按地点或季节变化的精灵图和肖像变体、婚姻内容和翻译。也是其他NPC模组所依赖的加载器。

[size=6][b]NPC Helper 2[/b][/size]
[i]通过简单的文本文件向星露谷物语添加自定义 NPC,无需编程。[/i]

[size=5][b]描述[/b][/size]
NPC Helper 2 是星露谷物语 1.6 的运行时 NPC 加载器。放入一个纯文本(TOML)文件,或安装使用 NPC Helper 2 的模组,NPC 就会连同其角色数据、礼物喜好、对话、日程、精灵图和肖像一起出现在你的游戏中。它还支持按地点或季节变化的精灵图和肖像变体、婚姻内容以及翻译。

[size=5][b]要求[/b][/size]
[list]
[]星露谷物语 1.6[/]
[][url=https://smapi.io]SMAPI 4[/url][/]
[/list]
[size=5][b]功能[/b][/size]
[list]
[]通过简单的 TOML 文件添加 NPC,或安装使用 NPC Helper 2 的 NPC 模组[/]
[]使用星露谷自身格式的对话(条件、页面、命令等)[/]
[]灵活的日程:工作日、周末、雨天、一周中的特定日子、季节和确切日期[/]
[]精灵图和肖像变体。优先级:NPC 的当前位置,然后是当前季节,然后是主文件[/]
[]按物品 ID、限定 ID、类别,甚至纯英文物品名称设置礼物喜好[/]
[]婚姻支持:配偶日程、配偶对话、订婚对话和婚姻肖像[/]
[]通过 [b]locale/<lang>/[/b] 文件夹进行翻译[/]
[]清晰的日志消息:每个问题都会告诉你文件、行和键[/]
[/list]
[size=5][b]安装[/b][/size]
[list=1]
[]安装 SMAPI。[/]
[]下载 NPC Helper 2 并将 [b]NpcHelper[/b] 文件夹解压到你的 [b]Mods[/b] 文件夹中。[/]
[]以相同方式安装任何需要 NPC Helper 2 的 NPC 模组。每个模组都放入 [b]Mods[/b] 内各自的文件夹中。[/]
[]通过 SMAPI 启动游戏,并在日志中查看 [b]Loaded N NPC(s)[/b]。[/]
[/list]NPC Helper 2 只是加载器。使用它的 NPC 模组不包含它,因此你需要单独安装它。

[size=5][b]添加你自己的 NPC(可选)[/b][/size]
你也可以自己编写一个 NPC。在 [b]Mods/NpcHelper/NPCs/<Name>/<Name>.toml[/b] 创建一个文件。这是一个最小示例:

[code]
Name = "Rei"
DisplayName = "Rei the Baker"

[Personality]
Gender = "Female"

[Birthday]
Season = "Spring"
Day = 14

[Home]
Map = "Town"
X = 10
Y = 12

[Schedule]
Weekday = ["600 Town 3 8 2", "1200 Town 20 20 3"]

[Dialogue]
Introduction = "Hi! I'm Rei."[/code]
将 [b]sprites/Default.png[/b] 和 [b]portraits/Default.png[/b] 放入 NPC 文件夹,它们会被自动识别。[b]Dialogue.toml[/b] 和 [b]Schedule.toml[/b] 也会按名称查找。日程停留点写作 [b]TIME MAP X Y FACING[/b],与游戏中的写法一致,或写成 [b]"6:00 Town x=3 y=8 face=down"[/b] 这样的形式。

[size=5][b]从 1.x 升级[/b][/size]
版本 2.0.0 更改了 NPC 文件格式,因此为 1.x 制作的 NPC 文件需要更新。主要变化:
[list]
[]NPC 文件现在分组到诸如 [b][Personality][/b] 和 [b][Home][/b] 这样的表中[/]
[]日程写为停留点列表[/]
[]婚姻内容现在是单个 [b]Marriage.toml[/b][/]
[]文件路径不再可配置;文件按名称查找[/]
[]无效值现在只拒绝该 NPC,而不会导致游戏数据加载崩溃[/]
[]可结婚的 NPC 自动可约会[/]
[]HomeRegion 必须是 [b]Town[/b]、[b]Desert[/b] 或 [b]Other[/b][/]
[]不再注入每个 NPC 的婚礼事件、配偶房间和露台,因为星露谷 1.6 不会那样读取它们[/]
[/list]
[size=5][b]故障排除[/b][/size]
[list]
[][b]NPC 缺失:[/b]在 SMAPI 日志中搜索 [b]NpcHelper[/b]。被拒绝的 NPC 会列出所有原因(名称错误、值错误、路径错误等)。[/]
[][b]没有精灵图:[/b]在日志中查找 [b]No sprite image found[/b],并确保 [b]sprites/Default.png[/b] 位于 NPC 文件夹中。[/]
[][b]某项设置被忽略:[/b]NPC Helper 2 会对未知的键和表发出警告,例如拼错的 [b]Gendr[/b] 或 [b][Dialgue][/b]。[/]
[/list]报告问题时,请附上你的 [b]完整 SMAPI 日志[/b](在 [url=https://smapi.io/log]smapi.io/log[/url] 上传)以及你的 NPC Helper 2 版本。

[size=5][b]致谢[/b][/size]
作者:[url=https://www.nexusmods.com/profile/TamKungZ]TamKungZ_[/url]