3.2 KiB
Предзагрузка ассетов (файл preload.json)
Для загрузки ассетов, не загружаемых автоматически, таких как звуки, дополнительные текстуры, используется файл preload.json, создающийся в папке контент-пака.
Ассеты в файле разделяются на категории:
- animation - анимация
- fonts - шрифты
- models - модели
- shaders - шейдеры
- skeletons - скелеты
- sounds - звуки
- textures - текстуры
Note
При загрузке звука подгружаются все его вариации, по шаблону: (звук: sound_name) -> sound_name.ogg, sound_name_1.ogg, sound_name_2.ogg, ... или sound_name_0.ogg, sound_name_1.ogg, sound_name_2.ogg, ...
Добавление звука пак:sounds/events/explosion.ogg со всеми его вариантами:
{
"sounds": [
"events/explosion"
]
}
Будет доступен под именем: "events/explosion"
В случае, если нужно будет работать с PCM данными звука (сейчас недоступно из скриптинга), требуется указать параметр keep-pcm:
{
"sounds": [
{
"name": "events/explosion",
"keep-pcm": true
}
]
}
Шаблоны
Имя ассета может содержать * для добавления сразу нескольких ассетов. * соответствует любой последовательности символов в пределах одного сегмента пути.
Поиск по шаблону производится в паке, содержащем preload.json, в папке типа ассетов (textures/, sounds/, ...).
Имена ассетов получаются такими же, как если бы каждый найденный ассет был указан явно.
{
"textures": [
"gui/*",
"mobs/*/skin-*"
],
"sounds": [
"steps/*"
]
}
Note
Вариации звука (
grass_0.ogg,grass_1.ogg, ...) добавляются как один звук (steps/grass).
Шаблон, оканчивающийся на /, соответствует папкам, а не файлам. Используется для атласов:
{
"atlases": [
"smth/*/other-*/*/"
]
}
Параметры записи применяются ко всем найденным ассетам. Параметр path нельзя использовать вместе с шаблоном:
{
"sounds": [
{
"name": "ambient/*",
"keep-pcm": true
}
]
}
Пример файла из пакета core: (res/preload.json):
{
"shaders": [
"ui3d",
"screen",
"background",
"skybox_gen"
],
"textures": [
"misc/moon",
"misc/sun",
"gui/crosshair"
]
}