全站通知:

模组:自定义婚礼事件

来自站务
跳到导航 跳到搜索

目录

此页面解释了如何自定义婚礼事件。这是面向模组开发者的高级指南。

格式

现在可以通过编辑 Data\Weddings 数据素材来改变婚礼,此素材文件内含一个两字段数据模型(见下文):

字段 效果
EventScript 婚礼播放的事件脚本。游戏会使用配偶 NPC/玩家的对应脚本;若不存在,则会使用默认脚本。

此字段为一个“字符串 → 字符串”字典,其中:

  • 键名为 NPC 内部名称(例如 Abigail)、唯一玩家 ID 或 default(默认脚本)。
  • 值为欲播放事件的模板字符串

事件脚本可以接受如下三种额外标记:

标记 效果
[SetupContextualWeddingAttendees] 把所有 AttendeesSetup 值连接在一起得到的字符串。
[ContextualWeddingCelebrations] 把所有 AttendeesCelebration 值连接在一起得到的字符串。
[SpouseActor] 结婚 NPC/玩家 的演员 ID(例如 Abigailfarmer2)。可以用于事件命令,例如 faceDirection [SpouseActor] 1

(您也可以使用 spouse 作为演员 ID,但仅适用于已与 NPC 结婚的情况)。

Attendees 应当参加婚礼的其他 NPC(除非其为新人)。此字段为一个“字符串 → 数据模型”查询,其中键为 NPC 内部名,值为包含如下字段的数据模型:
字段 效果
ID 内部 NPC 名称。
Setup NPC 参与婚礼时的地块坐标和面部朝向。这相当于事件基本数据中的字段 2。
Celebration (可选)庆祝时欲运行的事件脚本,例如 faceDirection Pierre 3 true 使得皮埃尔面向左。此字段可以包含任意数量的脚本命令。
Condition (可选)一个游戏状态查询,指示该 NPC 是否应当参与。默认为 true。
IgnoreUnlockConditions (可选)若此 NPC 的 Data/CharactersUnlockConditions 字段匹配失败,是否强制添加此 NPC。默认为 false。