voxelcore/doc/ru/assets-preload.md
2026-10-26 12:38:30 +03:00

3.2 KiB
Raw Blame History

Предзагрузка ассетов (файл 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"
    ]
}