From 1dcaf4879d1e577262bd838ce95434fb3f940f41 Mon Sep 17 00:00:00 2001
From: cuqmbr <me@cuqmbr.xyz>
Date: Fri, 15 Aug 2025 19:08:44 +0300
Subject: [PATCH] add custom paintings creation guide

---
 content/docs/guides/_index.ru.md              |  1 +
 content/docs/guides/_index.uk.md              |  1 +
 .../docs/guides/custom-paintings/_index.ru.md | 33 +++++++++++++++++++
 .../docs/guides/custom-paintings/_index.uk.md | 33 +++++++++++++++++++
 4 files changed, 68 insertions(+)
 create mode 100644 content/docs/guides/custom-paintings/_index.ru.md
 create mode 100644 content/docs/guides/custom-paintings/_index.uk.md

diff --git a/content/docs/guides/_index.ru.md b/content/docs/guides/_index.ru.md
index f5d2352..3295cb5 100644
--- a/content/docs/guides/_index.ru.md
+++ b/content/docs/guides/_index.ru.md
@@ -6,4 +6,5 @@ weight: 40
 {{< cards >}}
   {{< card link="install" title="🎮 Установка игры и модов" icon="document-duplicate" >}}
   {{< card link="skin-change" title="🧑 Изменение скина" icon="document-duplicate" >}}
+  {{< card link="custom-paintings" title="🖼 Пользовательские картины" icon="document-duplicate" >}}
 {{< /cards >}}
diff --git a/content/docs/guides/_index.uk.md b/content/docs/guides/_index.uk.md
index 1c65868..4324655 100644
--- a/content/docs/guides/_index.uk.md
+++ b/content/docs/guides/_index.uk.md
@@ -6,4 +6,5 @@ weight: 40
 {{< cards >}}
   {{< card link="install" title="🎮 Встановлення гри та модів" icon="document-duplicate" >}}
   {{< card link="skin-change" title="🧑 Зміна скіну" icon="document-duplicate" >}}
+  {{< card link="custom-paintings" title="🖼 Користувальницькі картини" icon="document-duplicate" >}}
 {{< /cards >}}
diff --git a/content/docs/guides/custom-paintings/_index.ru.md b/content/docs/guides/custom-paintings/_index.ru.md
new file mode 100644
index 0000000..34b9bc1
--- /dev/null
+++ b/content/docs/guides/custom-paintings/_index.ru.md
@@ -0,0 +1,33 @@
+---
+title: 🖼 Пользовательские картины
+weight: 15
+---
+
+### Подготовка
+
+Для установки картин вам понадобятся рамки, пустые карты и http ссылка на изображение в формате jpg, jpeg, png или gif. Кол-во рамок и карт должно соответствовать размеру картины.
+
+### Лимиты
+
+- максимальный размер изображения для загрузки — 30МБ;
+- максимальный размер картины — 30 рамок (6x5 блоков);
+- максимальное кол-во картин для ролей:
+  - Игрок — 3;
+  - Старейшина — 10.
+
+### Последовательность действий
+
+#### Создание
+
+- поставить рамки на стену в форме прямоугольника;
+- взять в инвентарь нужное кол-во пустых карт;
+- войти в режим выбора области командой `/imageframe select`, выбрать противоположные по диагонали углы прямоугольника из рамок, нажав на них ПКМ;
+- вставить изображение командой `/imageframe create <уникальное-имя> <ссылка-на-изображение> selection`.
+
+#### Удаление
+
+Если хотите удалить картину, чтобы она занимала лимит, сделайте это командой `/imageframe delete <уникальное-имя>`.
+
+#### Примечания
+
+Для загрузки изображений с диска и получения ссылки можно воспользоваться сервисами [x0.at](https://x0.at) или [0x0.st](https://0x0.st).
diff --git a/content/docs/guides/custom-paintings/_index.uk.md b/content/docs/guides/custom-paintings/_index.uk.md
new file mode 100644
index 0000000..ca0dcb4
--- /dev/null
+++ b/content/docs/guides/custom-paintings/_index.uk.md
@@ -0,0 +1,33 @@
+---
+title: 🖼 Користувальницькі картини
+weight: 15
+---
+
+### Підготовка
+
+Для встановлення картин вам знадобляться рамки, порожні карти та http посилання на зображення в форматі jpg, jpeg, png або gif. Кількість рамок і карт має відповідати розміру картини.
+
+### Ліміт
+
+- максимальний розмір зображення для завантаження — 30МБ;
+- максимальний розмір картини — 30 рамок (6x5 блоків);
+- максимальна кількість картин для ролей:
+  - Гравець — 3;
+  - Старійшина — 10.
+
+### Послідовність дій
+
+#### Створення
+
+- поставити рамки на стіну у формі прямокутника;
+- взяти в інвентар потрібну кількість порожніх карт;
+- увійти в режим вибору області командою `/imageframe select`, вибрати протилежні по діагоналі кути прямокутника з рамок, натиснувши на них ПКМ;
+- вставити зображення командою `/imageframe create <унікальне-ім'я> <посилання-на-зображення> selection`.
+
+#### Видалення
+
+Якщо ви хочете видалити картину, щоб вона займала ліміт, зробіть це командою `/imageframe delete <унікальне-ім'я>`.
+
+#### Примітки
+
+Для завантаження зображень з диска й отримання посилання можна скористатися сервісами [x0.at](https://x0.at) або [0x0.st](https://0x0.st).