模组:点唱机音乐
←目录
此页面介绍了游戏如何存储和解析点唱机音乐。这是面向模组开发者的高级指南。
数据格式
点唱机音乐存储在 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" ]
}
|

沪公网安备 31011002002714 号