Описание
# Cape Switcher
**Cape Switcher** is a client-side Fabric mod for **Minecraft 1.21.4** that lets you choose, preview, and switch local custom capes directly in-game.
**Cape Switcher** — клиентский Fabric-мод для **Minecraft 1.21.4**, который позволяет выбирать, просматривать и менять локальные кастомные плащи прямо в игре.
---
## Features / Возможности
* Choose custom cape textures from local PNG files
Выбор кастомных текстур плащей из локальных PNG-файлов
* Three cape modes: **Account**, **Local**, **None**
Три режима плаща: **плащ аккаунта**, **локальный плащ**, **без плаща**
* In-game **Cape Wardrobe** GUI
Игровое меню **Cape Wardrobe**
* 3D player preview
3D-превью модели игрока
* Drag to rotate the model
Вращение модели мышью
* Scroll to zoom
Приближение и отдаление колёсиком мыши
* Hover preview over cape cards
Предпросмотр плаща при наведении на карточку
* Hotkey to open the wardrobe
Хоткей для открытия гардероба
* Auto-creates config and capes folders
Автоматическое создание папок конфига и плащей
* Error-safe loading
Мод не крашит игру при отсутствующих или битых файлах
* English and Russian localization
Английская и русская локализация
---
## Installation / Установка
1. Install **Fabric Loader** for Minecraft 1.21.4.
Установите **Fabric Loader** для Minecraft 1.21.4.
2. Install **Fabric API**.
Установите **Fabric API**.
3. Put the mod `.jar` file into your `.minecraft/mods/` folder.
Поместите `.jar` файл мода в папку `.minecraft/mods/`.
4. Launch the game.
Запустите игру.
---
## How to Add Capes / Как добавить плащи
1. Open the capes folder:
```text
.minecraft/config/cape-switcher/capes/
```
2. Put your PNG cape files there.
Example:
```text
.minecraft/config/cape-switcher/capes/my_cape.png
```
3. Open the **Cape Wardrobe** in-game.
4. Press **Reload**.
5. Select your cape.
---
1. Откройте папку с плащами:
```text
.minecraft/config/cape-switcher/capes/
```
2. Поместите туда PNG-файлы плащей.
Пример:
```text
.minecraft/config/cape-switcher/capes/my_cape.png
```
3. Откройте **Cape Wardrobe** в игре.
4. Нажмите **Reload**.
5. Выберите нужный плащ.
---
## Cape Texture Format / Формат текстуры плаща
Cape textures should use the standard Minecraft cape format:
```text
64x32
128x64
```
Текстуры плащей должны использовать стандартный формат Minecraft:
```text
64x32
128x64
```
---
## Cape Modes / Режимы плаща
### Account Cape / Плащ аккаунта
Shows your official Minecraft account cape if you have one.
Показывает официальный плащ Minecraft-аккаунта, если он есть.
---
### Local Cape / Локальный плащ
Shows a custom PNG cape from your local capes folder.
Показывает кастомный PNG-плащ из локальной папки с плащами.
---
### None / Без плаща
Disables the cape display.
Отключает отображение плаща.
---
## Controls / Управление
Default hotkey:
```text
C
```
Controls inside the wardrobe:
* **Left Mouse Drag** — rotate player preview
**Зажать ЛКМ и двигать мышью** — вращать модель игрока
* **Mouse Wheel** — zoom preview
**Колёсико мыши** — приближать или отдалять модель
* **Reset View** — reset preview rotation
**Reset View** — сбросить поворот модели
* **Reload** — reload cape files
**Reload** — перезагрузить список плащей
* **Open Folder** — open the capes folder
**Open Folder** — открыть папку с плащами
---
## Important Notes / Важные замечания
> **This mod is client-side only.**
> Other players will not see your selected local cape unless they use a compatible sync system.
> **Этот мод работает только на клиенте.**
> Другие игроки не увидят ваш локальный плащ, если у них нет совместимой системы синхронизации.
Cape Switcher does **not** include or redistribute official Minecraft/Mojang cape textures.
Cape Switcher **не содержит** и **не распространяет** официальные текстуры плащей Minecraft/Mojang.
Official account capes are displayed only through the normal Minecraft account system using the **Account Cape** mode.
Официальные плащи отображаются только через стандартную систему Minecraft-аккаунта в режиме **Account Cape**.
---
## Building from Source / Сборка из исходников
To build the mod from source, run:
```bash
./gradlew build
```
The built `.jar` file will be located in:
```text
build/libs/
```
Для сборки мода из исходников выполните:
```bash
./gradlew build
```
Готовый `.jar` файл будет находиться в:
```text
build/libs/
```
---
## License / Лицензия
This project is licensed under the **MIT License**.
Этот проект распространяется под лицензией **MIT**.