Update project configuration and documentation. Added .NET assembly name in project.godot, clarified GDScript project structure in CLAUDE.md, and expanded README.md with details on texture filtering and asset management practices.

2026-08-12 10:45:45 +03:00
parent 05c7ba82d1
commit b23aa5a087
217 changed files with 4384 additions and 2 deletions
@@ -0,0 +1,82 @@
+# Небо и облака
+
+Слои параллакс-фона, разложенные из наборов CraftPix, лежащих в локальном
+складе `kits/` (в репозиторий склад не попадает).
+
+## Как устроен набор
+
+```
+<набор>/set_NN/layer_1.png   # непрозрачная база: градиент неба
+                layer_2.png   # облака, дальний план
+                layer_N.png   # облака, ближний план
+```
+
+Все слои — 576×324, пиксель-арт. Номер слоя = порядок отрисовки: чем больше,
+тем ближе к камере и тем быстрее он должен ехать при параллаксе. Наложение
+`layer_1..N` по альфе даёт исходную картинку набора.
+
+## Наборы
+
+Колонка «шов» — тайлится ли слой по горизонтали, то есть годится ли он для
+бесконечной прокрутки. Считалось сравнением стыка «последняя колонка → первая»
+с обычным стыком соседних колонок: `seamless` — шов неотличим, `почти` —
+заметен слабо и переживёт медленную прокрутку, `со швом` — при зацикливании
+будет видна граница, такой набор годится как статичное небо или как отдельные
+облака-спрайты.
+
+| Набор | Слоёв | Шов | Источник в `kits/` |
+| --- | --- | --- | --- |
+| `cloudscape/set_01` | 4 | seamless | background 1 |
+| `cloudscape/set_02` | 5 | почти | background 2 |
+| `cloudscape/set_03` | 4 | seamless | background 3 |
+| `cloudscape/set_04` | 4 | seamless | background 4 |
+| `parallax_clouds/set_01` | 4 | почти | background 1 |
+| `parallax_clouds/set_02` | 5 | seamless | background 2 |
+| `parallax_clouds/set_03` | 4 | почти | background 3 |
+| `parallax_clouds/set_04` | 3 | почти | background 4 |
+| `seamless_sky/set_01` | 5 | seamless | background 1 |
+| `seamless_sky/set_02` | 5 | почти | background 2 |
+| `seamless_sky/set_03` | 4 | seamless | background 3 |
+| `seamless_sky/set_04` | 4 | почти | background 4 |
+| `cloud_layers/set_01` | 4 | со швом | Clouds/Clouds 1 |
+| `cloud_layers/set_02` | 4 | со швом | Clouds/Clouds 2 |
+| `cloud_layers/set_03` | 4 | почти | Clouds/Clouds 3 |
+| `cloud_layers/set_04` | 4 | со швом | Clouds/Clouds 4 |
+| `cloud_layers/set_05` | 5 | seamless | Clouds/Clouds 5 |
+| `cloud_layers/set_06` | 6 | со швом | Clouds/Clouds 6 |
+| `cloud_layers/set_07` | 4 | со швом | Clouds/Clouds 7 |
+| `cloud_layers/set_08` | 6 | со швом | Clouds/Clouds 8 |
+| `sky_pack_3/set_01` | 4 | почти | background 1 |
+| `new_clouds/set_01` | 3 | почти | 1. NEW CLOUDS |
+| `new_clouds/set_02` | 2 | seamless | 2. NEW CLOUDS |
+| `new_clouds/set_03` | 6 | seamless | 3. NEW CLOUDS |
+| `new_clouds/set_04` | 3 | seamless | 4. NEW CLOUDS |
+
+Наборы `<набор>` соответствуют исходным архивам:
+
+| Каталог | Архив CraftPix |
+| --- | --- |
+| `cloudscape` | 227064 — free seamless pixel art cloudscape |
+| `parallax_clouds` | 245126 — free pixel sky with parallax clouds |
+| `seamless_sky` | 429990 — free sky with clouds pixel seamless backgrounds |
+| `cloud_layers` | 558275 — free sky with clouds background pixel art set |
+| `sky_pack_3` | 645714 — free sky with clouds pixel art backgrounds pack 3 |
+| `new_clouds` | 995711 — free pixel art cloud and sky backgrounds |
+
+## Что не переносили
+
+- `orig.png` и `orig_big.png` — это склейка слоёв набора (и её четырёхкратный
+  апскейл), а не самостоятельный слой. Проверено: наложение `layer_1..N` даёт
+  ту же картинку. Для игры не нужны — если понадобится превью, оно собирается
+  из слоёв.
+- `.psd` — исходники, `COUPON.*` и `.url` — реклама магазина, `__MACOSX` —
+  служебные хвосты macOS-архиватора.
+- Набор `craftpix-net-245126-... (1)` — повторно скачанная копия 245126,
+  все 16 слоёв совпадают побайтово. Взята одна копия.
+
+## Лицензия
+
+CraftPix Free License — <https://craftpix.net/file-licenses/>. Использовать в
+игре (в том числе коммерчески) можно, **перепродавать и распространять сами
+ассеты — нельзя**. Это стоит держать в голове, если репозиторий станет
+публичным: файлы в нём лежат как есть.