全站通知:

模组:点唱机音乐

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

目录

此页面介绍了游戏如何存储和解析点唱机音乐。这是面向模组开发者的高级指南。

数据格式

点唱机音乐存储在 Data/JukeboxTracks 数据素材中。

此素材文件内含一个“字符串 → 数据模型”查询,其中:

  • 键名为声音提示 ID(大小写敏感)。
  • 值为包含如下字段的数据模型:

若玩家已听过一个未收录在 Data/JukeboxTracks 的音乐,则将键名设为此声音提示的 ID 可以自动启用该音乐。欲禁用音乐,请添加一个 "Available": false 字段。

字段 效果
Name (可选)一个模板字符串,用于显示此音乐在游戏内的标题。默认为相应的声音提示 ID。
Available (可选)此音乐是否在点唱机菜单中显示。可以为 true(总是显示)、false(总不显示)、null(玩家听过才显示)。默认为 null

满足 "Available": true 的音乐会列在点唱机菜单前部。

AlternativeTrackIds (可选)此音乐的其他声音提示 ID 所组成的列表(大小写不敏感)。若玩家听过其中任何一个,则会在菜单中显示对应的条目。默认为空。

例如,此字段可用于重命名音乐,以兼容旧版玩家:

"{{ModId}}_TrackName": {
    "Name": "{{i18n: track-name}}",
    "AlternativeTrackIds": [ "OldTrackName" ]
}