From 23296db01d96bd86853648f0376e117ffe1b17cc Mon Sep 17 00:00:00 2001
From: MihailRis <mexaruc@gmail.com>
Date: Wed, 13 Mar 2024 12:47:03 +0300
Subject: [PATCH] =?UTF-8?q?Created=20=D0=9F=D1=80=D0=B5=D0=B4=D0=B7=D0=B0?=
 =?UTF-8?q?=D0=B3=D1=80=D1=83=D0=B7=D0=BA=D0=B0=20=D0=B0=D1=81=D1=81=D0=B5?=
 =?UTF-8?q?=D1=82=D0=BE=D0=B2=20(markdown)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Предзагрузка-ассетов.md | 53 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 Предзагрузка-ассетов.md

diff --git a/Предзагрузка-ассетов.md b/Предзагрузка-ассетов.md
new file mode 100644
index 0000000..43175a2
--- /dev/null
+++ b/Предзагрузка-ассетов.md
@@ -0,0 +1,53 @@
+# Файл `preload.json`
+
+Для загрузки ассетов, не загружаемых автоматически, такие как звуки, дополнительные текстуры, используется файл `preload.json`, создающийся в папке контент-пака.
+
+Ассеты в файле разделяются на категории:
+- fonts - шрифты
+- shaders - шейдеры
+- textures - текстуры
+- sounds - звуки
+
+> [!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` со всеми его вариантами:
+```json
+{
+	"sounds": [
+		"events/explosion"
+	]
+}
+```
+
+В случае, если нужно будет работать с PCM данными звука (сейчас не доступно из скриптинга), требуется указать параметр `keep-pcm`:
+```json
+{
+	"sounds": [
+		{
+			"name": "events/explosion",
+			"keep-pcm": true
+		}
+	]
+}
+```
+
+
+Пример файла из пакета `core:` (`res/preload.json`):
+```json
+{
+    "shaders": [
+        "ui3d",
+        "screen",
+        "background",
+        "skybox_gen"
+    ],
+    "textures": [
+        "misc/moon",
+        "misc/sun",
+        "gui/crosshair"
+    ]
+}
+```
\ No newline at end of file