> For the complete documentation index, see [llms.txt](https://squareheads.gitbook.io/squareheads-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://squareheads.gitbook.io/squareheads-docs/mechanics/plaginy.md).

# Плагины

Для полного погружения в атмосферу нашего сервера и доступа ко всем социальным функциям установите два ключевых мода. Они добавляют голосовой чат и поддержку эмоций.

> ⚠️ **Важно:** Без модов **Plasmo Voice** и **EmoteCraft** вы не сможете слышать других в голосовом чате, слушать музыку из пластинок и использовать расширенные эмоции.

***

### <mark style="color:yellow;">🎤 Plasmo Voice — Голосовой чат и музыка</mark>

**Plasmo Voice** — это система **голосового чата**. Игроки слышат друг друга только если находятся рядом, звук становится тише с расстоянием. Также с его помощью работает система прослушивания **перезаписанных пластинок**.

#### 📥 Установка мода

1. Убедитесь, что у вас установлен **Fabric Loader** (рекомендуется) или **Forge** для нужной версии Minecraft.
2. Скачайте мод через [Modrinth](https://modrinth.com/plugin/plasmo-voice) или [CurseForge](https://www.curseforge.com/minecraft/mc-mods/plasmo-voice).
3. Поместите скачанные `.jar` файлы в папку `mods` вашей игры.
4. Запустите Minecraft с установленным Fabric/Forge.

#### 🎮 Как пользоваться?

**Голосовой чат:**

* **Клавиша для Push-to-Talk (разговор по кнопке):** `alt` (настраивается в настройках мода).
* **Индикация:**&#x41D;ад головой игрока появится значок динамика. Если у игрока не установлен мод - над головой будет индикатор наушников с красным восклицательным знаком.

**Прослушивание музыки:**

* Чтобы **воспроизвести** перезаписанную пластинку, просто поставьте её на проигрыватель.\
  Перезаписать пластинку можно через команду `/disc burn` [(Доступно для обладателей премиум статуса)](https://squareheads.gitbook.io/squareheads-docs/game/premium-status.md)

***

### <mark style="color:yellow;">😄 EmoteCraft — Эмоции и анимации</mark>

**EmoteCraft** — это мод, добавляющий десятки анимаций для вашего персонажа: махание, танцы, позы, выражения лица и многое другое. Это оживляет общение и делает игру выразительнее.

#### 📥 Установка мода

1. Убедитесь, что у вас установлен **Fabric Loader** (рекомендуется) или **Forge** для нужной версии Minecraft.
2. Скачайте мод через [Modrinth](https://modrinth.com/plugin/emotecraft) или [CurseForge](https://www.curseforge.com/minecraft/mc-mods/emotecraft).
3. Поместите скачанный `.jar` файл в папку `mods` вашей игры.
4. Запустите Minecraft с установленным Fabric/Forge.

#### 🎮 Как пользоваться?

* Откройте меню эмоций клавишей `B`.
* Выберите любую доступную эмоцию из списка. Установите паки анимаций из интернета, например, [SPEMOTES](https://spemotes.spoverlay.ru/download).
* Другие игроки с установленным модом **увидят вашу анимацию**.

***

### <mark style="color:yellow;">🪑 Gsit — Простые позы (без мода!)</mark>

**Gsit** — это серверный плагин, который позволяет вашему персонажу принимать различные позы **без необходимости устанавливать какие-либо моды**. Это встроенная функция сервера.

#### 🎮 Как пользоваться?

Используйте простые команды прямо в чате:

* **`/sit`** — сесть на том месте, где вы стоите.
* **`/lay`**  — лечь.
* **`/crawl`** — ползти.
* **`/spin`** — закружиться на месте.

Эти анимации видны **всем игрокам на сервере**, независимо от того, установлены у них моды или нет.

***

### <mark style="color:yellow;">🛠️ Частые проблемы и решения</mark>

* **Я установил моды, но ничего не работает.**
  1. Убедитесь, что версия модов соответствует версии игры и загрузчика (Fabric/Forge).
  2. Проверьте папку `mods` на наличие конфликтующих или устаревших модов.
  3. Перезапустите клиент игры.
* **Меня не слышно в голосовом чате.**
  1. Проверьте, выбран ли правильный микрофон в настройках системы и в настройках мода Plasmo Voice.
  2. Проверьте, не отключен ли голосовой чат в настройках мода.
* **Я не вижу эмоции других игроков.**
  * Установлен ли у вас мод **EmoteCraft**? Он необходим для просмотра эмоций от этого мода.
* **Команды `/sit` не работают.**
  * Плагин Gsit установлен на сервере и должен работать всегда. Если команды не работают, сообщите об этом администрации.

**Если проблема не решена — обратитесь за помощью в тикет в Discord.**
