> For the complete documentation index, see [llms.txt](https://docs.vanillasquad.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vanillasquad.com/igrovoi-kontent/rukovodstvo-po-ispolzovaniyu-litematica.md).

# Руководство по использованию Litematica

Litematica — модификация для Minecraft, позволяющая загружать схемы построек и отображать их в игровом мире в виде голограммы.

На VanillaSquad Litematica особенно полезна при совместном строительстве масштабных проектов: спавнов, городов, хабов, ферм и декоративных сооружений.

С её помощью можно заранее подготовить макет постройки, разместить его в нужном месте и отслеживать процесс строительства. Это упрощает работу команды и помогает избежать ошибок при переносе сложных проектов.

### Установка

Для работы Litematica необходимы следующие компоненты:

* [Fabric Loader](https://fabricmc.net/use/installer/) — загрузчик модификаций.
* [Fabric API](https://modrinth.com/mod/fabric-api) — библиотека для Fabric.
* [MaLiLib](https://modrinth.com/mod/malilib) — необходимая библиотека для Litematica.
* [Litematica](https://modrinth.com/mod/litematica) — основной мод.

Скачайте версии, совместимые с вашей версией Minecraft и Fabric Loader.

Все скачанные файлы `.jar` необходимо переместить в папку `mods` вашей игры.

**Где находится папка mods?**

На Windows:

1. Нажмите `Win + R`.
2. Введите `%appdata%\.minecraft`.
3. Откройте папку `mods`.

Если вы используете отдельный игровой профиль или сторонний лаунчер, папка `mods` может находиться в директории этого профиля.

{% hint style="info" %}
Litematica не входит в стандартную сборку VanillaSquad. Мод устанавливается отдельно и не является обязательным для подключения к серверу.
{% endhint %}

***

### Загрузка схем

После установки Litematica в директории игры появится папка `schematics`.

Именно сюда необходимо помещать файлы схем, которые вы хотите использовать.

1. Скачайте нужную схему постройки.
2. Переместите файл схемы в папку `schematics`.
3. Запустите Minecraft.

***

### Загрузка схемы в игре

Находясь на сервере или в одиночном мире, откройте меню Litematica. По умолчанию для этого используется клавиша `M`.

{% hint style="warning" %}
Клавиша `M` может конфликтовать с управлением мини-картой или другими модификациями. Если меню не открывается, проверьте назначение клавиш в настройках управления Minecraft.
{% endhint %}

Далее:

1. Откройте раздел **Load Schematics** (Загрузка схем).
2. Найдите нужную схему в списке.
3. Выберите её и нажмите **Load Schematic** (Загрузить схему).

После загрузки постройка появится в игровом мире в виде голограммы.

<figure><img src="https://1639357051-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Md61sIy9355-Dt4QFTm%2Fuploads%2F2zKPEi1I3cCQuzkhGknF%2Fimage.png?alt=media&#x26;token=339740af-efd4-4909-9063-58bb39b899d3" alt="Меню загрузки схем Litematica"><figcaption><p>Выбор схемы для загрузки</p></figcaption></figure>

<figure><img src="https://1639357051-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Md61sIy9355-Dt4QFTm%2Fuploads%2Fd77eZtC1rkNURSVgjf0B%2Fimage.png?alt=media&#x26;token=38f877fd-1447-44d7-a50f-2c90265453ca" alt="Загруженная схема постройки"><figcaption><p>Пример загруженной схемы в игровом мире</p></figcaption></figure>

### Размещение схемы

После загрузки схемы её можно перемещать, поворачивать и устанавливать в нужное положение.

Для этого:

1. Откройте меню Litematica.
2. Перейдите в раздел **Schematic Placements** (Размещение схем).
3. Найдите загруженную схему.
4. Нажмите **Configure** (Настроить).

В настройках размещения можно изменить координаты, поворот и другие параметры схемы.

<figure><img src="https://1639357051-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Md61sIy9355-Dt4QFTm%2Fuploads%2FZ2yVhCkTqcH3wuy8jLml%2Fimage.png?alt=media&#x26;token=b36c1171-059c-4088-81ac-2672c124ff4d" alt="Настройки размещения схемы"><figcaption><p>Настройка положения загруженной схемы</p></figcaption></figure>

<figure><img src="https://1639357051-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Md61sIy9355-Dt4QFTm%2Fuploads%2FAgG0dpRXxvobFa4ekA4S%2Fimage.png?alt=media&#x26;token=cf523d43-339a-4129-9ae5-40e1a0bdbd4d" alt="Настройка координат и поворота схемы"><figcaption><p>Изменение координат и ориентации постройки</p></figcaption></figure>

***

### Подсветка блоков

Одна из самых полезных возможностей Litematica — подсветка отличий между загруженной схемой и уже построенной конструкцией.

Это позволяет быстро находить ошибки и понимать, какие блоки ещё необходимо установить.

Основные цвета подсветки:

* **Голубой** — пропущенные блоки, которые ещё не установлены.
* **Розовый** — лишние блоки, которых нет в исходной схеме.
* **Оранжевый** — ошибки размещения, например неправильное положение ступенек, полублоков или редстоун-компонентов.
* **Красный** — ошибочные блоки.

Чтобы получить дополнительную информацию о блоке или ошибке, наведите на интересующее место и нажмите `I`.

<figure><img src="https://1639357051-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Md61sIy9355-Dt4QFTm%2Fuploads%2FtwWagQUepyJl2YDcBKGG%2Fimage.png?alt=media&#x26;token=a892e9b2-fbdb-4c90-8421-6f9cf6a1ddd9" alt="Подсветка различий между схемой и постройкой"><figcaption><p>Пример подсветки недостающих и неправильно установленных блоков</p></figcaption></figure>

***

### Строительство по слоям

Для крупных построек рекомендуется использовать режим отображения отдельных слоёв.

Он позволяет сосредоточиться на определённой высоте постройки, не отвлекаясь на остальные части схемы.

Чтобы настроить управление:

1. Откройте настройки Litematica.
2. Перейдите в раздел **Настройки → Клавиши**.
3. В строке поиска введите `layer`.
4. Назначьте удобные клавиши для управления слоями.

Основные настройки:

| Назначение              | Параметр            |
| ----------------------- | ------------------- |
| Следующий режим слоёв   | `layerModeNext`     |
| Предыдущий режим слоёв  | `layerModePrevious` |
| Следующий видимый слой  | `layerNext`         |
| Предыдущий видимый слой | `layerPrevious`     |

<figure><img src="https://1639357051-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Md61sIy9355-Dt4QFTm%2Fuploads%2FnES1shmCfxJdNkoBzvkY%2Fimage.png?alt=media&#x26;token=88d7647d-ff61-4ae8-9337-7ef8801d4bbf" alt="Настройка горячих клавиш для работы со слоями"><figcaption><p>Назначение клавиш для переключения слоёв</p></figcaption></figure>

***

### Easy Place Mode

**Easy Place Mode** — функция Litematica, упрощающая установку блоков в соответствии с загруженной схемой.

При её использовании мод помогает выбирать правильные блоки и их положение при строительстве. Это особенно полезно для сложных конструкций, содержащих большое количество ступенек, полублоков, люков и других блоков с различными состояниями.

<figure><img src="https://1639357051-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Md61sIy9355-Dt4QFTm%2Fuploads%2FYI4xb7nVRvOa7VWnMHD3%2Fimage.png?alt=media&#x26;token=1a241d24-2ec2-4c58-9aa2-ba899253ae82" alt="Пример использования Easy Place Mode"><figcaption><p>Пример строительства с использованием Easy Place Mode</p></figcaption></figure>

{% hint style="success" %}
**Easy Place Mode разрешён на VanillaSquad.**

Вы можете использовать эту функцию при строительстве. Со стороны процесс иногда выглядит непривычно, однако это разрешённый инструмент для работы со схемами.
{% endhint %}

{% hint style="danger" %}
**Printer запрещён!**

Автоматическая установка блоков и другие функции, выполняющие строительные действия за игрока, запрещены.

Разрешение Easy Place Mode не распространяется на Printer и аналогичные инструменты автоматического строительства.
{% endhint %}

***

### Важные замечания

* Litematica является вспомогательным инструментом для строительства, а не способом автоматического возведения построек.
* Загруженная схема не предоставляет необходимые ресурсы — блоки нужно добывать самостоятельно.
* Перед началом строительства убедитесь, что схема правильно расположена и ориентирована.
* При совместной работе используйте одинаковую версию схемы, чтобы избежать расхождений между участниками.

Если вы только начинаете знакомство с Litematica, рекомендуем сначала потренироваться на небольшой постройке в одиночном мире.
